Platform Setup

General

For each platform, you need specific API credentials (tokens, Pixel IDs, etc.). You can find these in the respective ads manager. In ShopiPixel, go to Settings > Tracking and enter the credentials.

All 10 platforms at a glance — select a platform on the left and enter your credentials on the right.

Meta (Facebook / Instagram)

You need:

• Pixel ID: The ID of your Meta Pixel
• Conversions API Access Token: A server token for the CAPI
• Test Event Code (optional): For testing in the Events Manager

How to find the values:

1. Open the Meta Events Manager
2. Select your Pixel
3. The Pixel ID is shown at the top of the page
4. Go to Settings > Conversions API
5. Click "Generate access token"
6. Copy the token and paste it into ShopiPixel

Finding the Ad Account ID: The Ad Account ID starts with act_ and can be found in the Meta Business Manager under Business Settings > Accounts > Ad Accounts. Format: act_123456789.

Recommended configuration in Meta:

1. Use Test Event Code: In the Events Manager under Test Events, a test code is displayed. Enter it in ShopiPixel to see events immediately in the test tab. Remove the code after successful testing — events with a test code are not used for campaign optimization.
2. Check Event Match Quality: In the ShopiPixel Health Dashboard, you can see the EMQ score per platform. Additionally, in the Meta Events Manager under Overview, you can check the EMQ per event. The more user data (email, phone, click IDs) is sent, the higher the EMQ. Target: at least 6.0, ideally above 8.0.
3. Browser attribution: ShopiPixel automatically generates a Meta-compatible browser ID (_sp_fbp). If a Meta Pixel is installed, its browser ID takes priority.

How to verify events are arriving:

1. Open the Meta Events Manager > Test Events
2. Enter your Test Event Code in ShopiPixel (optional, speeds up verification)
3. Perform an action in your shop (e.g. view a product, add to cart)
4. Events should appear within 1-2 minutes in the "Test Events" tab
5. Check the Event Match Quality (EMQ) in the Health Dashboard — it should be above 6.0 per platform

Google Analytics 4

You need:

• Measurement ID: Starts with "G-" (e.g. G-XXXXXXXXXX)
• API Secret: Measurement Protocol API Secret

How to find the values:

1. Open Google Analytics
2. Go to Admin > Data Streams
3. Select your web stream
4. The Measurement ID is shown at the top
5. Scroll to Measurement Protocol API Secrets
6. Create a new secret and copy the value

Required configuration in GA4:

1. Enable Measurement Protocol: In GA4 under Admin > Data Streams > Measurement Protocol API Secrets, at least one API Secret must exist. Without an active secret, server events will not be accepted.
2. Session attribution: ShopiPixel automatically generates a GA4-compatible session ID (_sp_ga4_sid). If a Google Tag (gtag.js) is installed, its session ID takes priority.

How to verify events are arriving:

1. Open Google Analytics > Reports > Realtime
2. Perform an action in your shop
3. Events should appear within seconds in the Realtime report
4. Also check DebugView under Admin > DebugView for detailed event data

TikTok Events API

You need:

• Pixel ID: Your TikTok Pixel ID (alphanumeric, approx. 20 characters)
• Access Token: Events API Access Token

How to find the values:

1. Open the TikTok Ads Manager
2. Go to Assets > Events > Web Events
3. Select your Pixel (or create a new web pixel)
4. The Pixel ID is shown at the top of the page
5. Go to Settings and generate an Access Token

Finding the Pixel ID: The Pixel ID is alphanumeric (approx. 20 characters) and can be found in the TikTok Ads Manager under Assets > Events > Web Events at the top of the pixel page.

Required configuration in TikTok:

1. Create a web pixel: In the TikTok Events Manager, a web pixel must exist. When creating, select "Manually install pixel code" and enable "Developer Mode" for the Events API.
2. Generate Access Token: In the pixel settings (Settings), generate an Access Token. You need Admin or Operator rights for the ad account.

How to verify events are arriving:

1. Open the TikTok Events Manager > your pixel > Test Events
2. Perform an action in your shop
3. Test Events appear within minutes in the test tab. Regular Overview may take up to 24 hours
4. Check the Event status — it should be "Active". PageView events only appear in Overview, not in the Test tab

Google Ads

You need:

• Google Ads account with access to at least one Ads account
• Conversion Action (e.g. "Purchase") created in Google Ads

Step-by-step setup:

1. Step 1 — Connect with Google Ads:
   Click "Connect with Google Ads" in ShopiPixel and authorize access to your Google Ads account.
2. Step 2 — Select account:
   Select your Google Ads account from the dropdown menu.
3. Step 3 — Select Conversion Action:
   Select the Conversion Action (e.g. "Purchase") from the dropdown. If you don't have one yet, create one in Google Ads under Goals → New conversion action.
4. Step 4 — Enable Enhanced Conversions:
   In Google Ads: Goals → Settings → Enable Enhanced Conversions with the method "Google Ads API" (not "Google Tag").
5. Step 5 — Enable Enhanced Conversions for Leads:
   Additionally enable "Enhanced Conversions for Leads" in the same settings area. This improves attribution for purchases without a direct ad click.
6. Step 6 — Done:
   Google Ads shows conversions with approximately 24 hours delay. Purchase events are sent automatically. You can optionally configure additional Conversion Actions for AddToCart, InitiateCheckout and PageView in Settings.

Finding the Customer ID: The 10-digit Customer ID (without dashes) is shown in the top right of the Google Ads interface. Format: 1234567890 (not xxx-xxx-xxxx).

Required configuration in Google Ads:

1. Enhanced Conversions (Enhanced Conversions for Web): In Google Ads: Goals → Settings → Enable Enhanced Conversions. Select "Google Ads API" as the method (not "Google Tag"). Then accept the Google Data Processing Terms. Without the method "Google Ads API", events sent via API will not be processed.
2. Enhanced Conversions for Leads: In the same settings area, enable "Enhanced Conversions for Leads". This allows Google to attribute conversions even without a direct ad click — e.g. when a user visits the website via an ad but purchases later.
3. Consent Mode (EU/EEA): If you run ads in the EU/EEA, Consent Mode v2 must be configured. ShopiPixel automatically sends the consent status along with events if it is configured in your cookie banner.

How to verify events are arriving:

1. Open Google Ads → Goals → Conversions → Summary
2. Select your conversion action (e.g. ShopiPixel Purchase)
3. Under Diagnostics you can see incoming events and potential errors
4. It may take up to 24 hours for conversions to appear
5. ShopiPixel sends Purchase events to Google Ads by default. Optionally, AddToCart, InitiateCheckout and PageView can be configured as secondary conversions — create separate Conversion Actions in your Google Ads account and enter their IDs in the ShopiPixel settings

Pinterest

You need:

• Ad Account ID: Your Pinterest Ads account ID
• Access Token: Pinterest API Access Token

How to find the values:

1. Open the Pinterest Ads Manager
2. The Ad Account ID is in the URL or under Ads > Overview > Account number
3. Go to Conversions > Conversions API
4. Generate an Access Token (requires Pinterest Business account)

Finding the Ad Account ID: The numeric account ID can be found in the Pinterest Ads Manager in the URL or under Ads > Overview next to the account name.

Recommended configuration in Pinterest:

1. Set up Conversions API: Under Conversions > Conversions API > Set Up API, generate the token. A Pinterest Tag (browser pixel) is optional — the CAPI works standalone.
2. Test events: Use the API parameter test=true for test calls. Results appear under Conversions > Test Events.

How to verify events are arriving:

1. Open the Pinterest Ads Manager > Conversions > Events Overview
2. Under Event history you can see incoming events
3. Events appear promptly in Events Overview. Campaign reports may be delayed by up to 24 hours

Snapchat

You need:

• Snapchat Ads account with an existing pixel
• CAPI long-lived token from Snapchat Ads Manager

How to find the values:

1. Open the Snapchat Ads Manager at ads.snapchat.com
2. Go to Events Manager and select your pixel
3. Under Conversions API: Generate a long-lived token
4. In ShopiPixel: Go to Settings → Snapchat
5. Enter Pixel ID and CAPI token, then enable the platform

Finding the Pixel ID: The Snap Pixel ID can be found in the Snapchat Ads Manager under Assets > Pixels in the pixel detail view.

Setup notes:

1. CAPI Token: The long-lived token does not expire and only needs to be entered once.

How to verify events are arriving:

1. Open the Snapchat Ads Manager > Events Manager
2. Select your pixel and check the event overview
3. The event count should be non-zero within 30-60 minutes
4. Use the Validate/Stats API for detailed diagnostics

LinkedIn

You need:

• Organization ID: The ID of your LinkedIn company page (from the URL of your company page)
• Conversion Rule ID: The ID of the conversion rule
• Access Token: LinkedIn CAPI Access Token

How to find the values:

1. Open the LinkedIn Campaign Manager
2. Organization ID: Go to your company page — the ID is in the URL (linkedin.com/company/12345678/)
3. Conversion Rule ID: Under Measurement > Conversion Tracking > select conversion rule — the ID is in the URL (e.g. /conversions/15588877)
4. Access Token: In the Campaign Manager, click Data > Signals Manager > Direct API > Generate access token. The token does not expire — copy and store it securely

Finding the Organization ID: The numeric Organization ID is in the URL of your LinkedIn company page: linkedin.com/company/12345678/. The Conversion Rule ID can be found under Measurement > Conversion Tracking in the URL of the conversion rule.

Required configuration in LinkedIn:

1. Create a conversion rule: Under Measurement > Conversion Tracking, create a new conversion. Select Conversions API > Direct API as the type.
2. Check conversion method: The Conversion Rule must have the type CONVERSIONS_API. Only rules of this type can receive events via the API.

How to verify events are arriving:

1. Open the LinkedIn Campaign Manager > Measurement > Conversion Tracking
2. Select your conversion rule and check the status ("Active", "Unverified" or "Low Match Rate")
3. API response 201 Created confirms that LinkedIn accepted the event
4. It may take 24-48 hours for conversions to appear in campaign reports

Microsoft Ads

You need:

• Microsoft Ads account with an existing UET tag
• Access to ads.microsoft.com — sign-in happens via OAuth, no manual tokens required

How to set up Microsoft Ads:

1. Step 1: Check the UET Tag. Open ads.microsoft.com and go to Conversions → UET Tags. If no UET Tag exists yet, create one (any name, e.g. "Shopify Store").
2. Step 2: Connect with Microsoft. In ShopiPixel: Settings → Microsoft Ads → click "Connect with Microsoft". The OAuth flow opens in a new window.
3. Step 3: Sign in and grant permissions. Sign in with your Microsoft Ads account and confirm the requested permissions (read/write for conversions and campaign reporting).
4. Step 4: Select customer, account, UET Tag. After the OAuth redirect back, three dropdowns appear. Pick your customer, the account and your UET Tag.
5. Step 5: Conversion Goal is auto-provisioned. ShopiPixel checks whether an Offline Conversion Goal named "ShopiPixel Purchase" already exists. If not, it is created (30-day attribution window).
6. Step 6: Wait for goal propagation. Microsoft takes roughly two hours until the goal actively accepts events. During that window ShopiPixel shows "Setup in progress...".

Note on UET Tag and Goal: You only need to create the UET Tag once in ads.microsoft.com. The Conversion Goal is provisioned automatically by ShopiPixel during onboarding — no manual configuration needed.

How does tracking work?

1. UET JavaScript Tag: Loaded in the storefront browser via the Shopify Web Pixel. Captures PageView, ViewContent, AddToCart, InitiateCheckout and sets the MUID cookie for remarketing.
2. Offline Conversions API: Purchase events are sent server-side from Shopify webhooks — including msclkid and Enhanced Conversions (SHA256-hashed email and phone).
3. Token management: The OAuth refresh token remains valid indefinitely unless revoked by Microsoft. Access tokens are refreshed automatically by ShopiPixel.

How to verify events are arriving:

1. UET Tag status: Open ads.microsoft.com > Tools > UET Tag and check the status — it should show "Tag active".
2. UET Tag Helper: Use the UET Tag Helper (Chrome extension) for real-time debugging of browser events.
3. Offline Conversions: Purchase events appear under Conversions → Goals in ads.microsoft.com within a few minutes after a purchase (once the 2-hour goal propagation has completed).
4. Troubleshooting: For errors REAUTHORIZATION_REQUIRED or REFRESH_TOKEN_INVALID click "Reconnect" in the ShopiPixel settings — OAuth runs through again.

Klaviyo

You need:

• Public API Key (Site ID): Your Klaviyo Public API Key (6 characters, alphanumeric)
• Private API Key: Your Klaviyo Private API Key

How to find the values:

1. Open Klaviyo > Settings > API Keys
2. The Public API Key is shown at the top of the page (also known as "Site ID")
3. Under Private API Keys, create a new key or use an existing one
4. The Private Key needs at least the Events: Write permission. For full functionality, "Full Access" is recommended

How to verify events are arriving:

1. Open Klaviyo > Analytics > Metrics
2. Search for metrics like "Placed Order", "Added to Cart" etc.
3. Alternatively: Open a Profile and check the Activity Feed
4. Events should appear within 1-2 minutes

Custom Webhooks

You need:

• Webhook URL: The target URL of your endpoint (HTTPS recommended)
• Secret Key (optional): For HMAC request signing
• Event Filter (optional): Comma-separated list of events (e.g. "Purchase,AddToCart")

How to set up Custom Webhooks

1. Create an HTTPS endpoint on your server that accepts POST requests
2. Go to ShopiPixel Settings → Tracking and select Custom Webhook
3. Enter the Webhook URL (must be HTTPS)
4. Optional: Add a Secret Key for HMAC signature verification
5. Optional: Configure the Event Filter to receive only specific events

How to verify events are arriving:

1. Check in your target system whether HTTP requests are arriving
2. ShopiPixel sends events as HTTP POST with JSON body
3. Successful delivery requires an HTTP 200 response
4. For errors, check the status in the ShopiPixel Dashboard under Event Queue