Start Strong
Sell Smart
Manage with Ease
Market to Success

SHOPLINE Pixel and Customer Events (Limited Access)

SHOPLINE Pixel helps you track and analyze customer behavior in your online store and send related customer event data to analytics tools, advertising platforms, or other business systems. This helps you evaluate marketing performance more flexibly and track important business metrics.

You can use Customer Events in SHOPLINE Admin to centrally add and manage pixel code for your store. Compared with adding code separately in theme code or checkout scripts, Customer Events helps you manage pixel code in a more centralized way.

Notes: 

  • Pixel Code is a whitelisting feature. If you would like to apply for access to use this feature, please contact SHOPLINE Support.
  • This feature is available only to the Store Manager.

 

 

Use Cases

You can use SHOPLINE Pixel when you want to:

  • Track key customer actions in your store, such as page views, add-to-cart actions, and checkout-related events
  • Send customer event data to analytics tools or advertising platforms
  • Manage pixel code in a more centralized way in SHOPLINE Admin

If you are still using older tracking scripts that were manually inserted, we recommend reviewing the related code before enabling pixel code in Customer event to avoid duplicate tracking.

 

 

Privacy Controls and Sandbox Environment

To help protect store performance and customer data, pixel code in Customer event runs in a sandbox environment. This helps reduce interference with theme code or other scripts.

Before enabling any pixel code, make sure that its use complies with your store’s privacy policy and applicable local regulations. If you are not sure whether your existing code is suitable for this environment, consult your developer or contact SHOPLINE Support.

 

 

Accessing Customer Event to Manage Pixel Code 

Follow the steps below to access and manage pixel code in SHOPLINE Admin:

  1. In SHOPLINE Admin, go to Settings > Customer event.

  2. On the Customer Events page, you can add, view, and manage your pixel code. SHOPLINE currently supports the following two types of pixel code:

    App pixel code: Provided by apps that support SHOPLINE’s official pixel capability. After the app is installed and configured, app pixel code will appear in Customer Events for you to view and test.

    Custom pixel code: Manually added by you or your developer in SHOPLINE Admin to track SHOPLINE standard customer events based on your business needs.

SHOPLINE Pixel currently supports 15 standard events, such as page views, add-to-cart events, and completed checkouts. It also provides related event values and key parameters to help you track important business metrics more flexibly.

 

 

Adding App Pixel Code

App pixel code is provided by apps that have integrated with SHOPLINE’s official pixel capability. It is commonly used for marketing, analytics, or event collection scenarios.

Unlike custom code, which needs to be manually added in SHOPLINE Admin, app pixel code is usually configured through the app itself. 

After you install and configure a supported app, its app pixel code will appear under Settings > Customer event > Apply pixel code, where you can

  • View added app pixel code
  • Check the current connection status
  • Manage related testing actions

 

 

Adding Custom Pixel Code

Custom pixel code is pixel code manually added by you or your developer based on your business needs. It can be used to track SHOPLINE standard customer events and send related data to your analytics tools, advertising platforms, or other systems.

Custom pixel code must be maintained by the merchant or developer, including code updates, troubleshooting, and compliance checks.

 

How to Add Custom Pixel Code

To add custom pixel code, follow these steps:

Important: Before adding custom pixel code, check whether your store already has tracking scripts for the same purpose. Remove or update them as needed to avoid duplicate tracking. 

You can review your theme code, checkout scripts, or other locations where tracking code may have been previously added.
  1. In SHOPLINE Admin, go to Settings > Customer event.
  2. In the Pixel code section, click Add a custom pixel code, then enter a unique pixel code name and save it.
  3. Configure customer privacy settings and enter your pixel code in the editor.
  4. Click Save to save the custom pixel code.

 

How to Connect Custom Pixel Code

If you are confident that the added custom pixel code complies with SHOPLINE Privacy Policy, you can connect the pixel code to your store to ensure it starts working. There are two ways to connect:

Option 1:

  1. In SHOPLINE Admin, go to Settings > Customer event, then click the pixel code you want to connect. 
  2. Click Connect in the top right corner.

Option 2:

  1. In SHOPLINE Admin, go to Settings > Customer event.
  2. In the pixel code list, find the custom pixel code you want to connect and click the More option icon (···) in the Options column, then select Connect.

How to Disconnect Custom Pixel Code

Disconnecting a custom pixel code stops the tracking activity of that pixel code.

  1. In SHOPLINE Admin, go to Settings > Customer event.
  2. In the Custom pixel code list, only pixel codes with the Connected status can be disconnected.
  3. Click the More option icon (···) in the Options column and select Disconnect.

 

 

How to Edit Custom Pixel Code

You can edit the content or name of a custom pixel code whether it is connected or not.

Edit pixel code content

  1. In SHOPLINE Admin, go to Settings > Customer event.
  2. Search for the pixel code you want to edit in the search bar, or click the pixel code name directly in the list to open the edit page.
  3. Make changes in the sandbox area.
  4. Click Update.

Edit pixel code name

  1. In SHOPLINE Admin, go to Settings > Customer event.
  2. In the Custom pixel code list, find the pixel code you want to rename.
  3. Click the More option icon (···) in the Options column and select Edit pixel code name.
  4. Change the pixel code name, then click Save.

 

How to Delete Custom Pixel Code

You can delete custom pixel codes that you no longer need or that are causing errors. 

Note: Deleting a custom pixel code cannot be undone,  so ensure that you execute it correctly before proceeding.
  1. In SHOPLINE Admin, go to Settings > Customer event.
  2. IIn the Custom pixel code list, find the pixel code you want to delete and click the More option icon (···) in the Options column, then select Delete.

 

 

Migrating Existing Tracking Code to Pixel Code

If your store previously used tracking scripts added in theme files or other custom code locations, you can consider moving them to Customer event for more centralized management.

Before migrating, make sure that the same tracking logic is not still kept elsewhere in your store. Do not keep the same code in multiple places at the same time, as this may lead to duplicate event reporting.

If you need to migrate existing scripts to custom pixel code, or confirm whether an app supports app pixel code, we recommend checking with your developer or app provider first.

Note: The public documentation for the SHOPLINE Pixel API is expected to be available in a future release.

 

 

Testing Pixel Code

After setting up pixel code, you can use the Test feature to check whether related customer events have been subscribed to correctly.

Follow the steps below:

  1. In SHOPLINE Admin, go to Settings > Customer event.
  2. Depending on the type of pixel code you want to check, switch to the Custom pixel code or App pixel code tab.
  3. Find the pixel code you want to test, click More option icon (···) in the Options column, and select Test.

You can use this feature to verify whether related customer events are being subscribed to as expected. For additional verification, you can also use browser debugging tools provided by the relevant platform: