TikTok API-extensie voor webgebeurtenissen
De TikTok events API is beveiligd Edge Network Server-API interface die u toestaat om informatie met te delen TikTok rechtstreeks informatie over gebruikersacties op uw websites. U kunt de regels voor het doorsturen van gebeurtenissen gebruiken om gegevens te verzenden vanuit de Adobe Experience Platform Edge Network tot TikTok door de TikTok Web Events API-extensie.
TikTok voorwaarden prerequisites
Om te vormen TikTok webgebeurtenissen met de API TikTok gebeurtenissen-API, moet u een TikTok pixelcode en toegangstoken.
U moet een geldige TikTok voor zakelijke account om een TikTok pixel die de partneropstelling gebruiken. Ga naar de TikTok voor de registratiepagina voor bedrijven als u nog geen account hebt, kunt u zich registreren en een account maken.
U moet zijn aangemeld bij uw zakelijke account om te kunnen worden ingesteld TikTok Pixel die partneropstelling gebruikt. Hiervoor voert u de volgende stappen uit:
- Ga naar de Assets en selecteert u Event.
- Selecteer onder Webgebeurtenissen de optie Manage.
- Selecteer Set Up Web Events.
- Selecteren Partner Setup als verbindingsmethode.
Zie de Aan de slag met pixels voor meer informatie over het instellen van de TikTok pixel.
U kunt een toegangstoken genereren zodra de pixel is gemaakt. Navigeer hiertoe naar de pixel en selecteer de Settings tab. Selecteer onder Gebeurtenissen-API Generate Access Token.
Zie de TikTok gids Aan de slag voor meer informatie over het instellen van de pixelcode en het toegangstoken.
Installeer en configureer de TikTok API-extensie voor webgebeurtenissen install
Selecteer Extensions in de linkernavigatie. In de Catalog selecteert u de TikTok Web Events API Extension en selecteer vervolgens Install.
Voer in het volgende scherm de volgende configuratiewaarden in die u eerder hebt gegenereerd TikTok Advertentiebeheer:
- Pixel Code
- Access Token
Selecteer Save.
Vorm een gebeurtenis door:sturen regel config-rule
Zodra al uw gegevenselementen opstelling zijn, kunt u gebeurtenis beginnen tot stand te brengen door:sturen regels die bepalen wanneer en hoe uw gebeurtenissen zullen worden verzonden naar TikTok.
Een nieuwe regel in uw gebeurtenis die bezit door:sturen. Onder Actions voegt u een nieuwe handeling toe en stelt u de extensie in op TikTok Web Events API Extension. Edge Network-gebeurtenissen verzenden naar TikTok, stelt u de Action Type tot Send TikTok Web Events API Event.
Na de selectie worden extra besturingselementen weergegeven om de gebeurtenis verder te configureren, zoals hieronder wordt beschreven. Selecteer Keep Changes om de regel op te slaan.
Web Events and Parameters
Webgebeurtenissen en -parameters bevatten algemene informatie over de gebeurtenis. Standaardgebeurtenissen worden ondersteund in alle TikTok de integratiehulpmiddelen en kunnen voor rapportering worden gebruikt, optimaliserend voor omzettingen, en bouwend publiek.
yyyy-MM-dd'T'HH:mm:ss:SSSZ gebruiken. Dit is een verplicht veld.
User Context Parameters
De parameters van de gebruikerscontext bevatten klanteninformatie die wordt gebruikt om de gebeurtenissen van de Webbezoeker met te passen TikTok gebruikers. Door meerdere typen overeenkomende gegevens op te nemen, kunt u de nauwkeurigheid van doelmodellen en optimalisatiemodellen verhogen.
_ttp cookie, als cookies zijn ingeschakeld. De _ttp Deze waarde kan voor dit veld worden geëxtraheerd en gebruikt.ttclid Deze wordt toegevoegd aan de URL van de bestemmingspagina telkens wanneer een advertentie wordt geselecteerd op TikTok.
Properties Parameters
Gebruik de parameters van eigenschappen om extra gesteunde eigenschappen te vormen.
product of product_group moet worden toegewezen aan de content_type objecteigenschap, afhankelijk van hoe u uw gegevensinvoer zult vormen wanneer u opstelling uw productcatalogus.
Gebeurtenisdeduplicatie deduplication
TikTok pixel zal opstelling voor deduplicatie moeten zijn als u zowel TikTok pixel SDK en de TikTok webgebeurtenissen: API-extensie voor het verzenden van dezelfde gebeurtenissen naar TikTok.
Deduplicatie is niet vereist als verschillende gebeurtenistypen zonder overlapping van de client en server worden verzonden. Om ervoor te zorgen dat uw rapport niet negatief wordt beïnvloed, moet u ervoor zorgen dat om het even welke enige gebeurtenis die door wordt gedeeld TikTok pixel SDK en de TikTok API-extensie voor webgebeurtenissen is gededupliceerd.
Wanneer u gedeelde gebeurtenissen verzendt, moet u ervoor zorgen dat elke gebeurtenis een pixel-id, gebeurtenis-id en naam bevat. Gedupliceerde gebeurtenissen die binnen vijf minuten na elkaar aankomen, worden samengevoegd. Als het gegevensveld niet aanwezig was in de eerste gebeurtenis, wordt dit gecombineerd met de volgende gebeurtenis. Eventuele dubbele gebeurtenissen die binnen 48 uur zijn ontvangen, worden verwijderd.
Zie de TikTok documentatie over Gebeurtenis dedupliceren voor meer informatie over dit proces.
Volgende stappen
In deze handleiding wordt beschreven hoe u gebeurtenisgegevens op de server kunt verzenden naar TikTok met de TikTok API-extensie voor webgebeurtenissen. Voor meer informatie over gebeurtenis die mogelijkheden door:sturen in Adobe Experience Platform, verwijst u naar de overzicht van gebeurtenissen doorsturen.