DocumentazioneExperience PlatformTag

Panoramica dell'estensione API per TikTok eventi Web

Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

L'API degli eventi TikTok è un'interfaccia protetta dell'API Edge Network 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:

  1. Passare alla scheda Assets e selezionare Event.
  2. In Eventi Web selezionare Manage.
  3. Seleziona Set Up Web Events.
  4. Seleziona Partner Setup come metodo di connessione.

Per ulteriori informazioni su come impostare il pixel , consulta la ​Guida introduttiva ai pixelTikTok.

Puoi generare un token di accesso una volta che il pixel è stato creato correttamente. A tale scopo, passare al Pixel e selezionare la scheda Settings. In API eventi, selezionare Generate Access Token.

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 Extensions nel menu di navigazione a sinistra. Nella scheda Catalog, selezionare TikTok Web Events API Extension, quindi selezionare Install.

Il catalogo delle estensioni mostra la scheda delle estensioni TikTok che evidenzia linstallazione.

Nella schermata successiva immettere i seguenti valori di configurazione generati in precedenza da TikTok Ads Manager:

  • Pixel Code
  • Access Token

Al termine, selezionare Save.

Schermata di configurazione TikTok per lestensione API per eventi Web TikTok.

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 Actions, aggiungere una nuova azione e impostare l'estensione su TikTok Web Events API Extension. Per inviare eventi Edge Network a TikTok, impostare Action Type su Send TikTok Web Events API Event.

Tipo di azione Send TikTok Web Events API Event selezionato per una regola TikTok nellinterfaccia utente di Data Collection.

Dopo la selezione, vengono visualizzati controlli aggiuntivi per configurare ulteriormente l’evento, come descritto di seguito. Al termine, selezionare Keep Changes per salvare la regola.

Web Events and Parameters

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.

Input
Descrizione
Nome evento
Nome dell’evento. Si tratta di azioni con nomi predefiniti create da TikTok ed è un campo obbligatorio. Per ulteriori informazioni sugli eventi supportati, consulta la documentazione dell'TikTok API Marketing.
Ora evento
Data-ora come stringa in formato ISO 8601 o yyyy-MM-dd'T'HH:mm:ss:SSSZ. Questo campo è obbligatorio.
ID evento
L’ID univoco generato dagli inserzionisti per indicare ogni evento. Questo è un campo facoltativo e viene utilizzato per la deduplicazione.

La sezione Web Events and Parameters che mostra linput di dati di esempio nei campi.

User Context Parameters

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.

Input
Descrizione
Indirizzo IP
Indirizzo IP pubblico del browser senza hash. È disponibile il supporto per gli indirizzi IPv4 e IPv6. Vengono riconosciuti sia la forma completa che quella compressa degli indirizzi IPv6.
Agente utente
L’agente utente senza hash dal dispositivo dell’utente.
E-mail
Indirizzo e-mail del contatto associato all’evento di conversione.
Telefono
Il numero di telefono deve essere nel formato E164 [+][country code][area code][local phone number] prima dell'hashing.
ID cookie
Se utilizzi Pixel SDK, salva automaticamente un identificatore univoco nel cookie _ttp, se i cookie sono abilitati. Il valore _ttp può essere estratto e utilizzato per questo campo.
ID esterno
Qualsiasi identificatore univoco, ad esempio ID utente, ID cookie esterni e così via, deve essere dotato dell’hashing SHA256.
ID clic TikTok
Il ttclid che viene aggiunto all'URL della pagina di destinazione ogni volta che viene selezionato un annuncio pubblicitario il TikTok.
URL della pagina
URL della pagina al momento dell’evento.
URL referrer pagina
URL del referente pagina.

La sezione User Context Parameters che mostra linput di dati di esempio nei campi.

Properties Parameters

Utilizza i parametri delle proprietà per configurare altre proprietà supportate.

Input
Descrizione
Prezzo
Il costo di un singolo articolo.
Quantità
Il numero di articoli acquistati nell'evento. Deve essere un numero positivo maggiore di 0.
Tipo di contenuto
Alla proprietà dell'oggetto content_type deve essere assegnato un valore di product o product_group, a seconda di come verrà configurato il feed dati al momento della configurazione del catalogo prodotti.
ID contenuto
Un identificatore univoco dell’elemento di prodotto.
Categoria contenuto
Categoria della pagina/prodotto.
Nome contenuto
Nome della pagina/del prodotto.
Valuta
Valuta degli articoli acquistati nell'evento. Ciò è espresso nella norma ISO-4217.
Valore
Il prezzo totale dell’ordine. Questo valore sarà uguale al prezzo * quantità.
Descrizione
Descrizione dell'elemento o della pagina.
Query
Stringa di testo utilizzata per cercare un prodotto.
Stato
Lo stato di un ordine, articolo o servizio. Ad esempio, "inviato".

La sezione Properties Parameters che mostra linput di dati di esempio nei campi.

Deduplicazione degli eventi deduplication

TikTok pixel dovrà essere configurato per la deduplicazione se si utilizza l'estensione SDK di TikTok pixel e 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 dal 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.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743