DocumentationExperience PlatformGuide des connecteurs sources

[Beta]{class="badge informative"}

TikTok Ads

Dernière mise à jour : 26 octobre 2026

Créé pour :

  • Développeur
NOTE
La source TikTok Ads est en version Beta. Lisez la Présentation des sources pour plus d’informations sur l’utilisation de connecteurs étiquetés Beta.
IMPORTANT
La source TikTok Ads est disponible dans le cadre du SKU Customer Journey Analytics.

La source TikTok Ads est un connecteur de médias achetés Adobe Experience Platform. Utilisez-le pour connecter vos comptes publicitaires TikTok et ingérer des données de campagne, de publicité et de performances, telles que des mesures d’engagement, dans Experience Platform.

Le connecteur publie les données qu’il capture dans les jeux de données de médias payants. Customer Journey Analytics utilise ces jeux de données pour fournir des informations sur vos campagnes marketing TikTok.

Pour connecter votre compte, connectez-vous à TikTok et autorisez Experience Platform à accéder au compte de votre annonceur. Vous n’avez pas besoin de générer ou de fournir manuellement des informations d’identification d’API.

Fonctionnement

Après avoir créé un flux de données TikTok Ads et sélectionné le compte de l’annonceur à cibler, Experience Platform exécute automatiquement les tâches suivantes.

  • Si des jeux de données de médias payants n’existent pas déjà pour votre organisation, Experience Platform les crée.
  • Une tâche de renvoi unique s’exécute après la création du flux de données.
  • Une tâche incrémentielle s’exécute une fois par jour, à partir du lendemain de la création du flux de données.

Conditions préalables

Avant de connecter TikTok Ads à Experience Platform, vérifiez que vous disposez des éléments suivants :

  • Une application de développeur TikTok for Business existante avec le produit API marketing ajouté.
  • Approbation de l’application depuis TikTok. Les applications démarrent en mode sandbox et nécessitent que les TikTok examinent et approuvent l’application avant de pouvoir accéder aux données de compte d’annonce de production.
  • Vérification de l’entreprise. Il s’agit d’un processus d’approbation distinct de la révision de l’application. Nécessaire pour les niveaux de limite de débit plus élevés.
  • Les groupes d’autorisations d’application suivants ont été accordés avant votre première autorisation de compte. TikTok ne vous permet pas d’élargir ces autorisations ultérieurement sans avoir à autoriser à nouveau : Gestion des publicités, Reporting, Gestion des comptes de publicités et Gestion de l’audience.
  • Un quota de limite de taux approprié à votre volume de renvoi. Le niveau de sandbox par défaut est limité de manière agressive. Demandez donc une augmentation avant d’exécuter un renvoi volumineux.
  • Les campagnes et les publicités sont déjà configurées dans votre compte publicitaire TikTok. Le connecteur lit à partir de ces données publicitaires existantes. Il ne permet pas de créer, modifier ou supprimer des campagnes TikTok, des annonces ou d’autres ressources.

Approvisionnement des schémas et des jeux de données

La source TikTok Ads affecte automatiquement un jeu de données cible, un schéma et un mappage de champs. Vous ne sélectionnez pas vous-même un jeu de données cible ou ne mappez pas de champs lorsque vous créez le flux de données.

Le connecteur fournit un jeu de données de médias payants par type d’entité : compte, campagne, groupe publicitaire, publicité, ressource et mesures récapitulatives. Il s’agit des mêmes schémas canoniques que les sources Meta Ads et Google Ads renseignent déjà. Lisez la section suivante pour connaître les champs d’identité de base que le connecteur mappe pour chaque entité.

Schéma XDM TikTok Ads

Lisez cette section pour plus d’informations sur les champs d’identité et de statut de base que la source TikTok Ads mappe à chaque schéma de média payant. Chaque enregistrement mappé inclut également une valeur entityType qui identifie l’entité, et une valeur paidMedia.adNetwork de tiktok.

Champs du compte

Le schéma de compte stocke les détails de votre compte d’annonceur TikTok.

champ TikTok
Champ XDM
Description
advertiser_id
paidMedia.accountID
Identifiant unique du compte de l’annonceur dans TikTok.
name
paidMedia.metadata.name
Nom d’affichage du compte de l’annonceur.
status
paidMedia.metadata.status
Statut du compte, par exemple actif.
currency
paidMedia.metadata.currency
Devise dans laquelle le compte rendu des performances est effectué.
create_time
paidMedia.metadata.createdTime
Date et heure de création du compte.

Champs de campagne

Le schéma de campagne stocke les détails de votre campagne TikTok.

champ TikTok
Champ XDM
Description
campaign_id
paidMedia.campaignID
Identifiant unique de la campagne dans TikTok.
advertiser_id
paidMedia.accountID
Identifiant du compte publicitaire parent.
campaign_name
paidMedia.metadata.name
Nom d’affichage de la campagne.
operation_status
paidMedia.metadata.status
Statut de la campagne, tel que actif ou en pause.
create_time
paidMedia.metadata.createdTime
Date et heure de création de la campagne.
modify_time
paidMedia.metadata.updatedTime
Date et heure de la dernière modification de la campagne.

Champs de groupe publicitaire

Le schéma de groupe publicitaire stocke les détails de votre groupe publicitaire TikTok.

champ TikTok
Champ XDM
Description
adgroup_id
paidMedia.adGroupID
Identifiant unique du groupe publicitaire dans TikTok.
campaign_id
paidMedia.campaignID
Identifiant de la campagne parente.
adgroup_name
paidMedia.metadata.name
Nom d’affichage du groupe publicitaire.
operation_status
paidMedia.metadata.status
Statut du groupe publicitaire, tel que actif ou en pause.

Ajouter des champs

Le schéma d’annonce publicitaire stocke les détails de votre annonce publicitaire TikTok.

champ TikTok
Champ XDM
Description
ad_id
paidMedia.adID
Identifiant unique de l’annonce publicitaire dans TikTok.
adgroup_id
paidMedia.adGroupID
Identifiant du groupe publicitaire parent.
ad_name
paidMedia.metadata.name
Nom d’affichage de l’annonce publicitaire.
operation_status
paidMedia.metadata.status
Le statut de la publicité, tel que active ou en pause.

Champs de ressource

Le schéma de ressource stocke les détails de création d’images et de vidéos TikTok.

champ TikTok
Champ XDM
Description
image_id / video_id
paidMedia.assetID
Identifiant unique de l’image ou de la ressource vidéo dans TikTok.
advertiser_id
paidMedia.accountID
Identifiant du compte publicitaire parent.

Champs de mesures récapitulatives

Le schéma de mesures récapitulatives stocke les données de performances de vos comptes, campagnes, groupes publicitaires, publicités et ressources TikTok.

Chaque enregistrement de mesure correspond à l’identifiant de l’entité qu’il mesure.

Entité
Associe au champ XDM
Compte
paidMedia.accountID
Campagne
paidMedia.campaignID
Groupe publicitaire
paidMedia.adGroupID
Annonce publicitaire
paidMedia.adID
Ressource
paidMedia.assetID

Dépannage

Utilisez le tableau suivant pour résoudre les problèmes courants liés à la source de TikTok Ads.

Problème
Cause
La connexion réussit, mais aucun compte d’annonceur ne semble être sélectionné.
L’utilisateur TikTok autorisé ne dispose d’aucun accès Gestion des publicités sur aucun compte d’annonceur ou l’application n’a pas terminé la vérification de l’entreprise. Vérifiez le statut de l’application dans la TikTok for Business Developer Portal.
Le flux de données s’exécute, mais aucune donnée n’entre dans le jeu de données.
L’application est probablement toujours dans le statut de révision du sandbox. TikTok ne renvoie pas de données de production tant que l’application n’a pas été vérifiée, même si la connexion réussit.
Un renvoi échoue au milieu du processus avec des erreurs de limite de débit.
Le niveau de limite de taux par défaut de l’application est trop bas pour la période demandée. Demandez une augmentation de la limite de taux de TikTok avant d’exécuter un renvoi volumineux.
Une répartition des mesures spécifiques, telle que les performances des ressources, renvoie moins de lignes que prévu ou d’erreurs.
Toutes les mesures ne sont pas prises en charge sous chaque combinaison de dimensions de rapports. Validez la répartition concernée par rapport à un compte d’annonceur de test avant de vous y fier en production.

Étapes suivantes

Après avoir confirmé que vous disposez d’un compte d’annonceur TikTok éligible avec des campagnes et des annonces existantes, continuez en connectant TikTok Ads à Experience Platform à l’aide de l’interface utilisateur.

Plus d’aide sur cette rubrique

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