Documentation

Integrations

LinkWrangler integrates with popular analytics and marketing platforms to help you track user engagement and build audiences.

Facebook Pixel

Enable the Facebook Pixel integration to fire events directly from the user's browser when they scan a code. This happens before the user is redirected to the destination URL.

  • Event Fired: A custom event (defaults to ScanEvent, customizable in Account Settings).
  • Data Sent: The event includes standard pixel data such as the URL (which contains the GTIN), User Agent, and browser cookies.
  • How to Use: Create Custom Audiences in Facebook Ads Manager based on URL rules. For example, target users who visited URLs containing specific GTINs.

How to find your Facebook Pixel ID

  1. Go to Facebook Events Manager.
  2. Select your Business Account from the sidebar if needed.
  3. Under Data Sources, look for your Pixel (Meta now calls these "Datasets").
  4. Select the Dataset you want to use.
  5. Pixel ID: You can find the ID in the settings tab or displayed clearly at the top right of the Overview page.

Google Analytics 4 (GA4)

The GA4 integration uses the Measurement Protocol to send events server-side. This ensures high data accuracy even if the user has ad-blockers.

  • Event Name: scan_event (customizable in Account Settings)
  • Parameters Sent:
    • product_name: The name of the product scanned.
    • gtin: The Global Trade Item Number.
    • batch_id: The batch/lot number (if present in URL).
    • source: Always set to physical_qr.

How to find your GA4 Credentials

  1. Go to your Google Analytics 4 property and navigate to Admin.
  2. Under "Data Collection and Modification", click Data Streams and select your Web stream.
  3. Measurement ID: Copy the ID starting with "G-".
  4. API Secret: Scroll down to "Additional settings", click Measurement Protocol API secrets, create a new secret, and copy the value.