DocumentazioneExperience PlatformGuida ai connettori di origini

[Beta]{class="badge informative"}

TikTok Ads

Ultimo aggiornamento: 8 ottobre 2026

Creato per:

  • Developer
NOTE
L'origine TikTok Ads è in versione beta. Per ulteriori informazioni sull'utilizzo dei connettori con etichetta beta, leggere la Panoramica origini.
IMPORTANT
L'origine TikTok Ads è disponibile come parte dello SKU di Customer Journey Analytics.

L’origine TikTok Ads è un connettore per supporti a pagamento Adobe Experience Platform. Utilizzalo per collegare i tuoi account annuncio di TikTok e acquisire in Experience Platform i dati di campagne, annunci e prestazioni, come le metriche di coinvolgimento.

Il connettore pubblica i dati acquisiti nei set di dati per elementi multimediali a pagamento. Customer Journey Analytics utilizza questi set di dati per fornire informazioni approfondite sulle campagne di marketing TikTok.

Per connettere il tuo account, accedi a TikTok e autorizzi Experience Platform ad accedere al tuo account inserzionista. Non è necessario generare o fornire manualmente credenziali API.

Come funziona

Dopo aver creato un flusso di dati TikTok Ads e aver selezionato l’account dell’inserzionista di destinazione, Experience Platform esegue automaticamente i seguenti processi.

  • Se per la tua organizzazione non esistono già set di dati per file multimediali a pagamento, Experience Platform li crea.
  • Dopo la creazione del flusso di dati viene eseguito un processo di backfill una tantum.
  • Un processo incrementale viene eseguito una volta al giorno, a partire dal giorno successivo alla creazione del flusso di dati.

Prerequisiti

Prima di connettere TikTok Ads ad Experience Platform, assicurati di disporre dei seguenti elementi:

  • App per sviluppatori TikTok for Business esistente con il prodotto Marketing API aggiunto.
  • Approvazione app da TikTok. Le app iniziano in modalità sandbox e richiedono a TikTok di rivedere e approvare l’app prima di poter accedere ai dati dell’account degli annunci di produzione.
  • Verifica dell’attività. Si tratta di un processo di approvazione separato dalla revisione dell’app ed è richiesto per livelli con limite di velocità più elevati.
  • I seguenti gruppi di autorizzazioni per le app sono stati concessi prima dell’autorizzazione dell’account. TikTok non ti consente di ampliare queste autorizzazioni in un secondo momento senza riautorizzare: Gestione annunci, Generazione rapporti, Gestione account annunci e Gestione audience.
  • Quota limite di velocità appropriata per il volume di backfill. Il livello di sandbox predefinito è soggetto a limitazioni drastiche, pertanto devi richiederne un aumento prima di eseguire una retrocompilazione di grandi dimensioni.
  • Campagne e annunci già configurati nel tuo account annuncio TikTok. Il connettore legge da questi dati pubblicitari esistenti. Non crea, modifica o elimina TikTok campagne, annunci o altre risorse.

Provisioning di schemi e set di dati

L’origine TikTok Ads assegna automaticamente un set di dati, uno schema e una mappatura campi di destinazione. Quando crei il flusso di dati, non selezioni autonomamente un set di dati di destinazione o mappa i campi.

Il connettore fornisce un set di dati per elemento multimediale a pagamento per tipo di entità: account, campagna, gruppo di annunci, annuncio, risorsa e metriche di riepilogo. Si tratta degli stessi schemi canonici già popolati dalle origini Meta Ads e Google Ads. Leggi la sezione seguente per i campi di identità di base mappati dal connettore per ogni entità.

Schema XDM TikTok Ads

Leggi questa sezione per informazioni sui campi di identità e stato principali mappati dall’origine TikTok Ads a ogni schema di elementi multimediali a pagamento. Ogni record mappato include anche un valore entityType che identifica l’entità e un valore paidMedia.adNetwork di tiktok.

Campi account

Lo schema account archivia i dettagli dell’account dell’inserzionista TikTok.

Campo TikTok
Campo XDM
Descrizione
advertiser_id
paidMedia.accountID
Identificatore univoco dell’account dell’inserzionista in TikTok.
name
paidMedia.metadata.name
Nome visualizzato dell’account dell’inserzionista.
status
paidMedia.metadata.status
Lo stato dell’account, ad esempio attivo.
currency
paidMedia.metadata.currency
La valuta indicata dal conto.
create_time
paidMedia.metadata.createdTime
Il timestamp di creazione dell’account.

Campi della campagna

Lo schema della campagna memorizza i dettagli della campagna TikTok.

Campo TikTok
Campo XDM
Descrizione
campaign_id
paidMedia.campaignID
Identificatore univoco della campagna in TikTok.
advertiser_id
paidMedia.accountID
Identificatore dell’account dell’inserzionista padre.
campaign_name
paidMedia.metadata.name
Nome visualizzato della campagna.
operation_status
paidMedia.metadata.status
Lo stato della campagna, ad esempio attiva o in pausa.
create_time
paidMedia.metadata.createdTime
Il timestamp di creazione della campagna.
modify_time
paidMedia.metadata.updatedTime
Il timestamp dell’ultima modifica della campagna.

Campi del gruppo di annunci

Lo schema del gruppo di annunci memorizza i dettagli del gruppo di annunci TikTok.

Campo TikTok
Campo XDM
Descrizione
adgroup_id
paidMedia.adGroupID
Identificatore univoco del gruppo di annunci in TikTok.
campaign_id
paidMedia.campaignID
Identificatore della campagna principale.
adgroup_name
paidMedia.metadata.name
Nome visualizzato del gruppo di annunci.
operation_status
paidMedia.metadata.status
Lo stato del gruppo di annunci, ad esempio attivo o in pausa.

Campi annuncio

Lo schema dell’annuncio memorizza i dettagli dell’annuncio TikTok.

Campo TikTok
Campo XDM
Descrizione
ad_id
paidMedia.adID
Identificatore univoco dell’annuncio in TikTok.
adgroup_id
paidMedia.adGroupID
Identificatore del gruppo di annunci principale.
ad_name
paidMedia.metadata.name
Nome visualizzato dell’annuncio.
operation_status
paidMedia.metadata.status
Lo stato dell’annuncio, ad esempio attivo o in pausa.

Campi risorsa

Lo schema risorsa archivia i dettagli creativi dell’immagine e del video TikTok.

Campo TikTok
Campo XDM
Descrizione
image_id / video_id
paidMedia.assetID
Identificatore univoco della risorsa immagine o video in TikTok.
advertiser_id
paidMedia.accountID
Identificatore dell’account dell’inserzionista padre.

Lo schema delle metriche di riepilogo memorizza i dati sulle prestazioni per gli account, le campagne, i gruppi di annunci, gli annunci e le risorse di TikTok.

Ogni record di metriche è associato all’identificatore dell’entità misurata.

Entità
Mappatura per campo XDM
Account
paidMedia.accountID
Campaign
paidMedia.campaignID
Gruppo di annunci
paidMedia.adGroupID
Annuncio
paidMedia.adID
Risorsa
paidMedia.assetID

Risoluzione dei problemi

Utilizzare la tabella seguente per risolvere i problemi comuni con l’origine TikTok Ads.

Problema
Causa
La connessione ha esito positivo, ma non sembra che siano stati selezionati account inserzionisti.
L’utente TikTok che ha concesso l’autorizzazione non dispone dell’accesso Gestione annunci in alcun account inserzionista oppure l’app non ha completato la verifica aziendale. Controllare lo stato dell’app in TikTok for Business Developer Portal.
Il flusso di dati viene eseguito, ma nessun dato arriva al set di dati.
È probabile che l’app sia ancora nello stato di revisione sandbox. TikTok non restituisce i dati di produzione finché l’app non supera la revisione, anche se la connessione stessa riesce.
Una retrocompilazione non riesce in parte con errori di limite di frequenza.
Il livello del limite di velocità predefinito dell’app è troppo basso per l’intervallo di date richiesto. Richiedi un aumento del limite di velocità da TikTok prima di eseguire una retrocompilazione di grandi dimensioni.
Un raggruppamento di metriche specifiche, come le prestazioni delle risorse, restituisce un numero di righe inferiore a quello previsto o errori.
Non tutte le metriche sono supportate in ogni combinazione di dimensioni di reporting. Convalida il raggruppamento interessato in base a un account dell’inserzionista di test prima di fare affidamento su di esso in produzione.

Passaggi successivi

Dopo aver confermato di disporre di un account pubblicitario TikTok idoneo con campagne e annunci esistenti, continua connettendo TikTok Ads ad Experience Platform utilizzando l’interfaccia utente.

Ulteriori informazioni su questo argomento

recommendation-more-help
experience-platform-help-sources