Panoramica dell'estensione API per TikTok eventi Web
L'API degli eventi TikTok è un'interfaccia protetta dell'Edge Network Server API che consente di condividere informazioni con TikTok direttamente sulle azioni degli utenti sui siti Web. È possibile sfruttare le regole di inoltro degli eventi per inviare dati da Adobe Experience Platform Edge Network a TikTok utilizzando l'estensione API per eventi Web TikTok.
TikTok prerequisiti prerequisites
Per configurare l'API degli eventi Web TikTok in modo che utilizzi l'API degli eventi TikTok, devi generare un codice pixel TikTok e un token di accesso.
È necessario disporre di un TikTok valido per l'account business per creare un pixel TikTok utilizzando la configurazione partner. Vai alla pagina TikTok per la registrazione aziendale per registrarti e creare un account se non ne hai già uno.
È necessario aver effettuato l'accesso al proprio account aziendale per configurare TikTok Pixel utilizzando la configurazione del partner. Per farlo, segui la procedura indicata di seguito:
- Passa alla scheda Assets e seleziona Evento.
- In Eventi Web selezionare Gestisci.
- Selezionare Configura eventi Web.
- Seleziona Configurazione partner come metodo di connessione.
Per ulteriori informazioni su come impostare il pixel TikTok, consulta la Guida introduttiva ai pixel.
Puoi generare un token di accesso una volta che il pixel è stato creato correttamente. A questo scopo, passa al pixel e seleziona la scheda Impostazioni. In API eventi, selezionare Genera token di accesso.
Consulta la TikTok guida introduttiva per ulteriori informazioni su come configurare il codice pixel e accedere al token.
Installa e configura l'estensione API per eventi Web TikTok install
Per installare l'estensione, seleziona Estensioni nel menu di navigazione a sinistra. Nella scheda Catalogo, seleziona l'estensione API TikTok Web Events, quindi seleziona Installa.
Nella schermata successiva immettere i seguenti valori di configurazione generati in precedenza da TikTok Ads Manager:
- Codice pixel
- Token di accesso
Al termine, selezionare Salva.
Schermata di configurazione
Configurare una regola di inoltro degli eventi config-rule
Una volta configurati tutti gli elementi dati, puoi iniziare a creare regole di inoltro degli eventi che determinano quando e come verranno inviati gli eventi a TikTok.
Crea una nuova regola nella proprietà di inoltro eventi. In Azioni, aggiungi una nuova azione e imposta l'estensione su Estensione API TikTok Web Events. Per inviare eventi Edge Network a TikTok, impostare Tipo azione su Invia evento API eventi Web TikTok.
Dopo la selezione, vengono visualizzati controlli aggiuntivi per configurare ulteriormente l’evento, come descritto di seguito. Al termine, seleziona Mantieni modifiche per salvare la regola.
Eventi Web e parametri
Gli eventi Web e i parametri contengono informazioni generali sull'evento. Gli eventi standard sono supportati negli strumenti di integrazione TikTok e possono essere utilizzati per generare rapporti, ottimizzare le conversioni e creare tipi di pubblico.
yyyy-MM-dd'T'HH:mm:ss:SSSZ
. Questo campo è obbligatorio.
Parametri Contesto Utente
I parametri di contesto dell'utente contengono informazioni sul cliente utilizzate per far corrispondere gli eventi dei visitatori Web con TikTok utenti. L’inclusione di più tipi di dati corrispondenti consente di aumentare la precisione dei modelli di targeting e ottimizzazione.
_ttp
, se i cookie sono abilitati. Il valore _ttp
può essere estratto e utilizzato per questo campo.ttclid
che viene aggiunto all'URL della pagina di destinazione ogni volta che viene selezionato un annuncio pubblicitario il TikTok.
Parametri proprietà
Utilizza i parametri delle proprietà per configurare altre proprietà supportate.
product
o product_group
, a seconda di come verrà configurato il feed dati al momento della configurazione del catalogo prodotti.
Deduplicazione degli eventi deduplication
TikTok pixel dovrà essere configurato per la deduplicazione se si utilizza sia l'SDK di TikTok pixel che l'estensione API di TikTok eventi Web per inviare gli stessi eventi a TikTok.
La deduplicazione non è necessaria se tipi di evento distinti vengono inviati dal client e dal server senza alcuna sovrapposizione. Per evitare effetti negativi sul reporting, è necessario assicurarsi che ogni singolo evento condiviso dall'SDK di TikTok pixel e dall'estensione API di TikTok eventi Web sia deduplicato.
Quando invii eventi condivisi, accertati che ogni evento includa un ID pixel, un ID evento e un nome. Gli eventi duplicati che arrivano entro cinque minuti l’uno dall’altro verranno uniti. Se il campo dati era assente dal primo evento, verrà combinato con l’evento successivo. Eventuali eventi duplicati ricevuti entro 48 ore verranno rimossi.
Per ulteriori dettagli su questo processo, consulta la documentazione di TikTok su Deduplicazione eventi.
Passaggi successivi
Questa guida illustra come inviare dati di eventi lato server a TikTok utilizzando l'estensione API per eventi Web TikTok. Per ulteriori informazioni sulle funzionalità di inoltro eventi in Adobe Experience Platform, fare riferimento alla panoramica sull'inoltro eventi.