--- title: "Tracking Integrations - Serpwise Documentation" description: "Connect Meta CAPI, TikTok Events API, Google Ads, GA4, Snapchat, Pinterest, Twitter/X, and custom webhooks to your domain." url: "https://serpwise.ai/docs/tracking-integrations/" source: "https://serpwise.ai/docs/tracking-integrations/" --- [Back to Serpwise](/) Serpwise Documentation Connect · Configure · Execute Search documentation `/` No documentation found. ↑↓ Navigate Enter to open Browse documentation Tracking integrations connect your domain to ad platforms so the gateway can forward conversion events server-side. Each integration stores the credentials needed to authenticate with the platform’s API. ## Adding an Integration 1. Navigate to your domain in the dashboard 2. Open the **Tracking** tab 3. Click the **Integrations** sub-tab 4. Click **Add Integration** 5. Select an available platform 6. Enter the required credentials 7. Click **Save** The integration starts in an **Active** state and can receive events from dashboard-managed conversions, legacy `fire_conversion_event` rule actions, or trusted server-to-server ingest. ## Platform Credentials ### Meta Conversions API (CAPI) | Field | Description | |---------------------|--------------------------------------------------------------------------------------------------------------------------------| | **Access Token** | A long-lived system user access token from Meta Business Manager. Required scopes: `ads_management` and `business_management`. | | **Pixel ID** | Your Meta Pixel ID - found in Events Manager under your pixel’s settings. | | **Test Event Code** | Optional. When set, events are sent to the Test Events tab in Events Manager instead of production. Remove before going live. | ### TikTok Events API | Field | Description | |------------------|-----------------------------------------------------------------------------------| | **Access Token** | Generated in TikTok Events Manager under **Settings > Generate Access Token**. | | **Pixel Code** | Your TikTok Pixel Code - found in Events Manager under your pixel’s details. | ### Google Ads Enhanced Conversions | Field | Description | |--------------------------|-------------------------------------------------------------------------------------------------------------| | **Customer ID** | Your Google Ads account Customer ID (format: `123-456-7890`). | | **Conversion Action ID** | The ID of the conversion action to attribute events to - found in **Tools > Conversions** in Google Ads. | | **Refresh Token** | OAuth refresh token for authenticating API requests. Generated via the Google OAuth consent flow. | | **Client ID** | OAuth client ID from your Google Cloud project credentials. | | **Client Secret** | OAuth client secret from your Google Cloud project credentials. | ### Custom Webhook | Field | Description | |-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Endpoint URL** | The target URL for the HTTP request (e.g., `https://your-api.com/conversions`). | | **HTTP Method** | POST (default), PUT, or PATCH. | | **Headers** | Optional key-value pairs sent with each request (e.g., `Authorization: Bearer token`). | | **Body Template** | JSON template with `{{variable}}` interpolation. Available variables include `{{event_type}}`, `{{value}}`, `{{currency}}`, `{{order_id}}`, and user data fields. | ### Google Analytics 4 (Measurement Protocol) | Field | Description | |--------------------|----------------------------------------------------------------------------------------------| | **Measurement ID** | Your GA4 stream ID (format: `G-XXXXXXX`). Found in **GA4 Admin > Data Streams > Web**. | | **API Secret** | Created in **GA4 Admin > Data Streams > Measurement Protocol API secrets**. | ### Snapchat Conversions API | Field | Description | |-------------------|------------------------------------------------------------------------------------| | **Access Token** | Generated in **Snapchat Business Manager > Business Settings > API Tokens**. | | **Snap Pixel ID** | Your Snapchat Pixel ID - found in **Events Manager > Manage > Pixel ID**. | ### Pinterest Conversions API | Field | Description | |-------------------|-----------------------------------------------------------------------------------------------------------------| | **Access Token** | Generated in **Pinterest Business > My Apps > Your App > Generate Token**. Requires `ads:write` scope. | | **Ad Account ID** | Your Pinterest Ad Account ID - found in **Ads Manager > Ad Account Settings**. | ### Twitter/X Conversions API | Field | Description | |------------------|-------------------------------------------------------------------------------------| | **Access Token** | Bearer token from **Twitter Ads API > Authentication**. Requires Ads API access. | | **Pixel ID** | Your Twitter/X Pixel ID - found in **Events Manager > Event Sources**. | ### Consent Management Each integration can optionally require user consent before events are forwarded. When enabled, the gateway checks for consent signals from supported CMPs (OneTrust, Cookiebot, or a custom `_sw_consent` cookie) and only forwards events when the required consent categories are granted. | Consent Category | Recommended For | |---------------------|----------------------------------------------------------| | **Analytics** | GA4, custom analytics webhooks | | **Marketing** | Meta, TikTok, Google Ads, Pinterest, Twitter/X, Snapchat | | **Personalization** | Webhooks with user-specific data | Configure consent requirements when creating or editing an integration. Events that fail consent checks are logged with status `consent_denied` in the Event Log. ## Testing Connections After adding an integration, create a test conversion matching a known URL. Visit the URL and check **Tracking > Event Log** to verify: - The event was sent successfully (green status) - The platform accepted the event (no error details) For Meta, use the **Test Event Code** field to send events to the Test Events tab without affecting production data. ## Enable, Pause, and Delete - **Pause** an integration to temporarily stop sending events without removing credentials. Paused integrations show a muted badge and are skipped during event delivery. - **Enable** a paused integration to resume event delivery. - **Delete** an integration to permanently remove it and its credentials. This cannot be undone.