Skip to main content

Shopify (Current Custom Apps)

info

This guide is for custom apps created after January 2026 using the new Shopify Dev Dashboard flow.

For apps created before January 2026, see the legacy guide instead.

After this guide, you will have sale conversion tracking up and running for your Shopify store.

To make yourself familiar with Linkster tracking, it is recommended that you read through the introduction and overview to tracking methods first.

caution

The user tracking container must be installed first before you can start using this integration.

The Shopify integration works by installing a custom app in your store, which enables Linkster to access sales data.

Creating a custom app​

Starting January 2026, custom Shopify apps must be created via the Dev Dashboard.

info

You need the correct user permissions to create a custom app for your Shopify store.

Admin API access scopes​

The Linkster custom Shopify app needs the following access scopes to work properly:

write_script_tags, read_script_tags, read_orders and read_customers.

Step-by-step guide​

You can follow these steps to create a custom app for Linkster.

  1. Open the Dev Dashboard:

  2. Click "Create app" in the top right corner.

  3. Select "Start from Dev Dashboard" and enter an app name (e.g., "Linkster Tracking").

  4. Click "Create app" to confirm.

  5. Navigate to the "Versions" tab.

  6. Configure the access scopes listed above:

    • write_script_tags
    • read_script_tags
    • read_orders
    • read_customers

  7. Select a Webhooks API version (use the newest available).

  8. Click "Release" to finalize the app version.

Important: Use Custom Distribution

Do not use the "Install app" button on the Home page. You must use Custom distribution to install the app. This is required to get proper access to customer data (needed for metrics like new customer rate).

  1. On the Home page, find the Distribution panel on the right side.

  2. Click Select distribution method.

  3. Select Custom distribution and confirm.

warning

The distribution method cannot be changed after selection. Make sure to select "Custom distribution".

  1. Enter your store's myshopify.com domain (e.g., your-store.myshopify.com).

  2. Uncheck "Allow multi-store installs for one Plus organization" to keep the installation specific to this store.

  3. Click Generate link.

tip

Install links expire after 7 days. Install the app promptly after generating the link.

  1. Copy the generated install link and open it in your browser.

  2. Follow the prompts to authorize and install the app on your store.

  3. After installation, go back to the Dev Dashboard and navigate to the Settings tab.

  4. Copy the Client ID and Client Secret.

  5. Note the API version you selected in step 7.

Now, let your Linkster contact know the Client ID, Client Secret, and API version, and they will take care of the rest.

Options​

Order category​

By setting an order category, you can group orders in Linkster.

Like for HTTP sale and lead conversion requests, you also have the ability to send an optional order category with Shopify orders tracked over this custom app integration.

If Linkster detects an entry named __linksterOrderCategory in the note_attributes of an order, it will use its value as the order category:

...
"note_attributes": [
  {
    "name": "__linksterOrderCategory",
    "value": "your_order_category_name_here"
  }
],
...

Shopify offers different ways for setting note_attributes. Two possible solutions are:

  1. Setting note_attributes with an HTML input element in the cart form. (Read this Shopify guide for more information)
  2. Setting note_attributes by sending an update request to the cart endpoint. (Read this Shopify guide for more information)