Připojení TikTok Pixel a Events API k cPixel

Jak připojím TikTok k cPixel?

Otevřete TikTok Events Manager z účtu Ads Manager pro váš obchod, zkopírujte Pixel ID z Datasets overview, pak otevřete Settings datasetu, Data connection, a sjeďte za obě možnosti TikTok Pixel k Events API, kde vygenerujete přístupový token. Vložte oba údaje do cPixel; bez tokenu cPixel do TikToku neodešle nic.

Vložení do cPixel

  1. V cPixel otevřete Cíle a klikněte na ikonu TikTok pod Připojit platformu. Nastavit TikTok se otevře na Vložte svá ID.
  2. Vložte Pixel ID do Kód pixelu a token do Přístupový token Events API, které je povinné: pixel TikToku nemůže běžet v sandboxu webového pixelu Shopify. Pokud chcete, pojmenujte účet pod Pojmenujte tento účet (nepovinné), pak klikněte na Pokračovat.
  3. Na Vyberte možnosti ponechte zaškrtnuté Odesílat události z našich serverů; Odesílat události z prohlížeče přidá tag obchodu TikToku, který potřebuje app embed cPixel. Ponechte Ne — cPixel se stará o TikTok (doporučeno), pokud do tohoto pixelu neodesílá aplikace TikTok od Shopify: navzdory svému názvu Ano — nechte ji nainstalovanou a cPixel přestane TikTok odesílat ze serveru zastaví prohlížečové i serverové odesílání cPixel do něj.
  4. Klikněte na Uložit a pokračovat. Otestujte to potvrdí TikTok je připojeno.

Dialog Nastavit TikTok na Vložte svá ID, s poli pro Kód pixelu, povinný Přístupový token Events API, nepovinný název účtu a nepovinný testovací kód události

Poznámka: Testovací kód události (nepovinné) slouží jen Otestovat připojení, které odešle jednu skutečnou testovací událost na záložku Test Events vašeho pixelu (kód, začínající na TEST, odtud zkopírujte), a noční kontrole cPixel u účtu neaktivního 7 dní. Ať už nápověda pole říká cokoliv, skutečné události ho nikdy nenesou.

Kde najdu své TikTok Pixel ID?

V TikTok Events Manager, vytištěné pod názvem každého datasetu: 20 písmen a číslic. Používejte menu TikToku: ručně zadaná adresa Events Manager často skončí na „Page not found“.

  1. Přihlaste se do TikTok Ads Manager. Na Select an account vyberte účet Ads Manager pro tento obchod, ne Business Center, kterému patří.

    Výběr účtu TikTok for Business, Select an account, se dvěma sloupci účtů, Ads Manager vpravo, všechny názvy účtů skryté

  2. Otevřete ikonu mřížky vlevo nahoře a zvolte Events Manager.

    Přepínač produktů TikTok otevřený z ikony mřížky vlevo nahoře, se seznamem nástrojů TikToku a zvýrazněným Events Manager dole

  3. Na domovské stránce Events Manager ukazuje Datasets overview Pixel ID pod názvem každého datasetu.

    Karta Datasets overview v TikTok Events Manager se zobrazeným datasetem, jeho skrytým názvem a Pixel ID, celkovým počtem událostí a grafem posledních 7 dní

  4. Data sources v levém menu vypíše každý dataset s jeho Pixel ID a časem vytvoření.

    Stránka Data sources v TikTok Events Manager s jednou kartou datasetu, jejím skrytým Pixel ID, časem vytvoření a celkovým počtem událostí

Jak získám přístupový token Events API?

Vygenerujte ho v nastavení svého datasetu, v bloku Events API pod možnostmi TikTok Pixel. Vlastní návod TikToku: Get started with Events API.

  1. Klikněte na svůj dataset, pak otevřete Settings → Data connection.
  2. Sjeďte za Partner integration a obě možnosti TikTok Pixel, Option 1: With Event Builder a Option 2: With custom code, až na Events API.
  3. Klikněte na Generate access token a zkopírujte dlouhý token do cPixel.

Nastavení Data connection datasetu TikTok, sjeté za Option 2, With custom code, k bloku Events API a jeho tlačítku Generate access token

Proč nemůžu najít sekci Events API?

Obvykle je níž, než se zdá: pokračujte ve scrollování. Pokud opravdu chybí, nemáte práva ke správě pixelu.

TikTok Pixel zabere svými dvěma možnostmi celou obrazovku, takže stránka vypadá, že končí brzy. Pokud úplně dole žádný blok není, chybí vám TikTokem vyžadovaný přístup Admin nebo Operator k reklamnímu účtu; pokud pixel patří Business Center, požádejte jeho admina, aby ho s vámi sdílel s oprávněním ke správě.

Co cPixel odesílá do TikToku?

Servery cPixel odesílají vše přes Events API: Pageview, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo a CompletePayment, nákup sestavený z objednávky Shopify. Se zapnutým app embed odesílá tag obchodu TikToku z prohlížeče i každou Pageview, pod event ID serverové kopie.

CompletePayment je dřívější název TikToku pro Purchase; TikTok ho stále přijímá a hlásí jako Purchase (TikTok).

Serverové události nesou hashovaný e-mail a telefon, pokud jsou známé, hashované ID zákazníka a zařízení Shopify, cookie _ttp TikToku a click ID ttclid, a IP adresu a user agent. Obě větve potřebují marketingový souhlas. Blokátor reklam, který zastaví vlastní požadavek cPixel z prohlížeče, zastaví i prohlížecí události; nákupy pocházejí z objednávky Shopify.

TikTok si ponechá první událost se stejným pixelem, událostí a event ID, opakování po dobu 48 hodin zahazuje a snaží se sloučit tu, která dorazí do 5 minut (TikTok).

Důležité: Aplikace TikTok od Shopify také odesílá do svého pixelu a na úrovních sdílení dat Enhanced a Maximum přidává Events API (TikTok). Její event ID se liší od cPixel, takže dodržujte jednoho odesílatele na pixel.

Jak zkontroluji, že to funguje?

Sledujte každé odeslání a odpověď TikToku v Živých událostech cPixel, pak zkontrolujte TikTok Events Manager.

  1. V cPixel otevřete Živé události, klikněte na Spustit relaci a procházejte svůj obchod v jiné kartě. Otevřete řádek Server: Přijato znamená, že TikTok vrátil kód 0, svůj úspěšný kód (TikTok).
  2. Zadejte skutečnou objednávku, abyste viděli nákup; testovací objednávky se ve výchozím nastavení přeskakují.
  3. V Events Manager otevřete Overview svého pixelu: události cPixel ukazují metodu připojení Server, a zobrazení stránek Server & Browser se zapnutým tagem obchodu (TikTok). Aktualizace počtů může trvat až 10 minut, zpracování až 2 hodiny (TikTok).

Podrobnosti události v Živých událostech pro nákup odeslaný ze serveru, s TikTok označeným Přijato při HTTP 200 vedle Meta a GA4, šesti ze šesti zahrnutých identifikátorů a sdíleným event ID

Cíle označí účet Ověřeno po prvním úspěšném serverovém odeslání. Test Events ukazuje jen událost z Otestovat připojení, nikdy skutečný provoz.

Co když to nefunguje?

Pokud TikTok nepřijímá události z cPixel, zkontrolujte Domů, pak řádek TikToku v Živých událostech, který ukazuje kód a zprávu TikToku.

Co vidíte Co to znamená Co dělat
Odmítnuto s chybou tokenu nebo oprávnění; Domů hlásí, že účet vyžaduje pozornost TikTok token odmítl: byl odvolán, nebo patří jinému reklamnímu účtu (kód 40001 znamená chybějící oprávnění). cPixel pozastaví serverová odeslání do něj a pošle e-mail na kontaktní adresu vašeho obchodu Vygenerujte nový token v Settings tohoto pixelu. Klikněte na Opravit TikTok na Domů, nebo na Spravovat vedle účtu na Cíle, vložte ho, pak Pokračovat a Uložit a pokračovat
Odmítnuto s kódem 40002, neplatný obsah TikTok odmítl jednu událost; další stále jdou Pokud se to opakuje, Domů → Získat pomoc → Kontaktovat podporu
Přeskočeno, s důvodem cPixel se rozhodl neodeslat, například kvůli chybějícímu souhlasu nebo testovací objednávce Zaplaťte doopravdy, nebo odškrtněte Nastavení → Testovací objednávky
Žádná prohlížečová zobrazení stránek App embed je vypnutý a Domů ukazuje Rozšířené sledování je ve vašem obchodě vypnuté Zapnout ho; serverová odeslání běží dál
Přijato v Živých událostech, po 2 hodinách nic v TikToku Události šly do jiného datasetu Porovnejte Kód pixelu s Pixel ID v Datasets overview

Odebrat, ve Spravovat TikTok, zastaví odesílání do tohoto účtu a smaže jeho token.

Potřebujete pomoc s cPixel? Napište na support@b2bgold.app.