API-tilläggets TikTok för webbhändelser - översikt
Händelse-API:t TikTok är ett säkert Edge Network Server-API som gör att du kan dela information med TikTok direkt om användaråtgärder på dina webbplatser. Du kan utnyttja reglerna för vidarebefordran av händelser för att skicka data från Adobe Experience Platform Edge Network till TikTok med hjälp av API-tillägget TikTok för webbhändelser.
Krav för TikTok prerequisites
Om du vill konfigurera TikTok-webbhändelseAPI:t så att det använder TikTok-händelse-API:t måste du generera en TikTok pixelkod och komma åt token.
Du måste ha en giltig TikTok för företagskonto för att kunna skapa en TikTok pixel med partnerkonfigurationen. Gå till sidan TikTok för företagsregistrering om du vill registrera dig och skapa ett konto om du inte redan har ett.
Du måste vara inloggad på ditt företagskonto för att kunna konfigurera TikTok pixlar med partnerkonfiguration. Gör så här:
- Navigera till fliken Assets och välj Event.
- Välj Manage under Webbhändelser.
- Välj Set Up Web Events.
- Välj Partner Setup som anslutningsmetod.
Mer information om hur du ställer in pixeln TikTok finns i guiden Kom igång med Pixel .
Du kan generera en åtkomsttoken när pixeln har skapats. Om du vill göra det går du till pixeln och väljer fliken Settings. Välj Generate Access Token under Händelse-API.
Mer information om hur du konfigurerar pixelkoden och får åtkomst till token finns i TikTok Komma igång-guiden.
Installera och konfigurera API-tillägget för TikTok-webbhändelser install
Om du vill installera tillägget väljer du Extensions i den vänstra navigeringen. Markera TikTok Web Events API Extension på fliken Catalog och välj sedan Install.
På nästa skärm anger du följande konfigurationsvärden som du tidigare har genererat från TikTok Ads Manager:
- Pixel Code
- Access Token
När du är klar väljer du Save.
Konfigurera en regel för vidarebefordran av händelser config-rule
När alla dataelement har konfigurerats kan du börja skapa regler för vidarebefordran av händelser som avgör när och hur händelser skickas till TikTok.
Skapa en ny regel i egenskapen för vidarebefordran av händelser. Under Actions lägger du till en ny åtgärd och anger tillägget till TikTok Web Events API Extension. Om du vill skicka Edge Network-händelser till TikTok anger du Action Type till Send TikTok Web Events API Event.
Efter markeringen visas ytterligare kontroller för att ytterligare konfigurera händelsen enligt instruktionerna nedan. När du är klar väljer du Keep Changes för att spara regeln.
Web Events and Parameters
Webbhändelser och parametrar innehåller allmän information om händelsen. Standardhändelser stöds i alla TikTok-integreringsverktyg och kan användas för att rapportera, optimera för konverteringar och skapa målgrupper.
yyyy-MM-dd'T'HH:mm:ss:SSSZ. Detta är ett obligatoriskt fält.
User Context Parameters
Parametrar för användarkontext innehåller kundinformation som används för att matcha webbbesökshändelser med TikTok användare. Genom att ta med flera typer av matchande data kan ni öka noggrannheten i målinriktning och optimeringsmodeller.
_ttp-cookien, om cookies är aktiverade. Värdet _ttp kan extraheras och användas för det här fältet.ttclid som läggs till i URL:en för landningssidan varje gång en annons väljs TikTok.
Properties Parameters
Använd egenskapsparametrarna för att konfigurera ytterligare egenskaper som stöds.
product eller product_group måste tilldelas objektegenskapen content_type, beroende på hur du konfigurerar dataflödet när du konfigurerar produktkatalogen.
Borttagning av händelser deduplication
TikTok pixel måste vara konfigurerad för borttagning av dubbletter om du använder både TikTok pixel SDK och TikTok API-tillägget för webbhändelser för att skicka samma händelser till TikTok.
Deduplicering krävs inte om distinkta händelsetyper skickas från klienten och servern utan någon överlappning. Om du vill vara säker på att din rapportering inte påverkas negativt måste du se till att alla enskilda händelser som delas av TikTok pixel-SDK och API-tillägget för TikTok-webbhändelser dedupliceras.
När du skickar delade händelser måste du se till att alla händelser innehåller ett pixel-ID, händelse-ID och namn. Duplicerade händelser som kommer inom fem minuter från varandra sammanfogas. Om datafältet inte fanns med i den första händelsen kombineras det med den efterföljande händelsen. Alla dubbletthändelser som tas emot inom 48 timmar tas bort.
Mer information om den här processen finns i TikTok-dokumentationen om händelseborttagning.
Nästa steg
I den här guiden beskrivs hur du skickar händelsedata på serversidan till TikTok med API-tillägget för webbhändelser i TikTok. Mer information om funktioner för vidarebefordran av händelser i Adobe Experience Platform finns i översikten över vidarebefordran av händelser.