DATALYR

Shopify to TikTok Events API.

Send every Shopify order to TikTok so campaigns optimize on real sales. Each paid order reaches your TikTok pixel with the ad click attached.

What gets sent.

What DATALYR sends from Shopify to TikTok Events API
DATALYR eventWhen it firesSent to TikTok asWhat it carries
purchaseShopify marks an order paidCompletePaymentOrder total, currency, order ID, the ttclid and _ttp cookie, and hashed email and phone when known
checkout_startedA checkout is created. Optional ruleInitiateCheckoutThe checkout, with a value of 0

How it's matched.

DATALYR checks these in order and stops at the first one that finds the ad click.

  1. The visitor ID the App Embed writes onto the order as a cart attribute
  2. The order email, when the cart attribute found no ad click
  3. Click IDs and UTM parameters read from the order's landing page URL

TikTok gets the ttclid and the _ttp cookie, looked up within 7 days of the click, plus email and phone hashed with SHA-256. DATALYR sends the same event ID the browser TikTok Pixel uses, so TikTok merges the pair into one conversion.

How it works.

  1. 01

    Connect Shopify.

    Open Sources, select connect on Shopify, enter your myshopify.com domain and approve the five permissions. Then turn on the App Embed in your theme editor and save, so each order carries the visit that drove it.

  2. 02

    Connect TikTok.

    Open Sources, connect TikTok Ads and set the primary advertiser. In Conversions, select manage rules, then new rule: trigger event purchase, target platform TikTok, your pixel, platform event CompletePayment. Set value to dynamic and pick the currency.

  3. 03

    Check one conversion.

    Place one order from a TikTok ad click. Find purchase in Events, then open the newest row in Conversions and read the reply from TikTok.

Check it worked.

  • Copy the pixel code from TikTok Events Manager, Web events. The rule's pixel must match it, or the event lands under a different pixel.
  • Set a Test Events code on the rule, then select send test event. The event shows in TikTok Events Manager under Test events. Without a code, a test is a real conversion.
  • Open the newest row in Conversions. Its status reads sent and the rule's sent count went up by 1.

View docsInstall on ShopifyShopify revenueTikTok AdsConversion delivery

Questions, answered.

Contact us
  • No. DATALYR sends the same event ID the browser TikTok Pixel uses, and TikTok merges the pair into one conversion. Purchases from Shopify arrive by webhook, so send each purchase from one source.

  • TikTok has no validate-only mode, so DATALYR refuses a test until the rule has a Test Events code. The row reads skipped with the reason test_event_code_required. Get the TEST code from TikTok Events Manager, Test events.

  • No. TikTok rejects a purchase worth zero, so DATALYR skips it with the reason zero_value_purchase. Point the rule's value at the order amount.

See what really drives revenue.

Real-time attribution, analytics and conversions for every channel, campaign and ad, ready for your team and your agents.

Get started