TikTok présentation de l’extension de l’API des événements web
L'API d'événements TikTok est une interface sécurisée API de serveur Edge Network qui vous permet de partager des informations avec TikTok directement sur les actions des utilisateurs sur vos sites web. Vous pouvez utiliser les règles de transfert d’événement pour envoyer des données de Adobe Experience Platform Edge Network vers TikTok à l’aide de l’extension de l’API TikTok d’événements web.
Conditions préalables de TikTok prerequisites
Pour configurer l’API d’événements web TikTok afin d’utiliser l’API d’événements TikTok, vous devez générer un code de pixel et un jeton d’accès TikTok.
Vous devez disposer d’un TikTok valide pour le compte professionnel afin de créer un pixel TikTok à l’aide de la configuration du partenaire. Accédez à la TikTok page d'enregistrement professionnel pour vous enregistrer et créer un compte si vous n'en avez pas déjà un.
Vous devez être connecté à votre compte d’entreprise pour configurer TikTok pixel à l’aide de la configuration du partenaire. Pour ce faire, procédez comme suit :
- Accédez à l’onglet Assets et sélectionnez Event.
- Sous Événements Web, sélectionnez Gérer.
- Sélectionnez Configurer des événements web.
- Sélectionnez Configuration de partenaire comme méthode de connexion.
Pour plus d’informations sur la configuration du pixel TikTok, consultez le guide Prise en main du pixel .
Vous pouvez générer un jeton d’accès une fois que le pixel a été créé. Pour ce faire, accédez au pixel et sélectionnez l’onglet Paramètres. Sous l’API Events, sélectionnez Generate Access Token.
Consultez le TikTok guide de prise en main pour plus d’informations sur la configuration du code de pixel et du jeton d’accès.
Installation et configuration de l’extension de l’API d’événements web TikTok install
Pour installer l’extension, sélectionnez Extensions dans le volet de navigation de gauche. Dans l’onglet Catalog, sélectionnez l’ extension de l’API TikTok Web Events , puis sélectionnez Install.
Dans l’écran suivant, saisissez les valeurs de configuration suivantes que vous avez générées à partir du gestionnaire d’annonces TikTok :
- Code pixel
- Jeton d’accès
Lorsque vous avez terminé, sélectionnez Enregistrer.
Écran de configuration
Configurer une règle de transfert d’événement config-rule
Une fois tous vos éléments de données configurés, vous pouvez commencer à créer des règles de transfert d’événement qui déterminent quand et comment vos événements seront envoyés à TikTok.
Créez une règle dans votre propriété de transfert d’événement. Sous Actions, ajoutez une nouvelle action et définissez l’extension sur Extension de l’API des événements web TikTok. Pour envoyer des événements Edge Network à TikTok, définissez le Type d’action sur .
Après la sélection, d’autres contrôles apparaissent pour configurer l’événement de manière plus détaillée, comme indiqué ci-dessous. Une fois la règle terminée, sélectionnez Conserver les modifications pour enregistrer la règle.
Événements et paramètres web
Les événements web et les paramètres contiennent des informations générales sur l’événement. Les événements standard sont pris en charge dans les outils d’intégration TikTok et peuvent être utilisés pour la création de rapports , l’optimisation pour les conversions et la création d’audiences.
yyyy-MM-dd'T'HH:mm:ss:SSSZ. Il s’agit d’un champ obligatoire.
Paramètres de contexte utilisateur
Les paramètres de contexte utilisateur contiennent des informations sur le client qui sont utilisées pour faire correspondre les événements de visiteur web avec les utilisateurs TikTok. L’inclusion de plusieurs types de données correspondantes vous permet d’accroître la précision des modèles de ciblage et d’optimisation.
_ttp, si les cookies sont activés. La valeur _ttp peut être extraite et utilisée pour ce champ.ttclid ajouté à l’URL de la page d’entrée chaque fois qu’une publicité est sélectionnée sur TikTok.
Paramètres de propriétés
Utilisez les paramètres de propriétés pour configurer d’autres propriétés prises en charge.
product ou product_group doit être affectée à la propriété d’objet content_type , selon la manière dont vous allez configurer votre flux de données lors de la configuration de votre catalogue de produits.
Déduplication des événements deduplication
TikTok pixel devra être configuré pour la déduplication si vous utilisez le SDK TikTok pixel et l’extension d’API d’événements web TikTok pour envoyer les mêmes événements à TikTok.
La déduplication n’est pas nécessaire si des types d’événements distincts sont envoyés du client et du serveur sans chevauchement. Pour vous assurer que vos rapports n’ont pas d’impact négatif, vous devez vous assurer que tout événement unique partagé par le SDK TikTok pixel et l’extension de l’API d’événements web TikTok est dédupliqué.
Lors de l’envoi d’événements partagés, assurez-vous que chaque événement comprend un ID de pixel, un ID d’événement et un nom. Les événements dupliqués qui arrivent dans les cinq minutes seront fusionnés. Si le champ de données était absent du premier événement, il sera combiné à l’événement suivant. Les événements en double reçus sous 48 heures seront supprimés.
Pour plus d’informations sur ce processus, consultez la documentation TikTok sur Déduplication des événements .
Étapes suivantes
Ce guide explique comment envoyer des données d’événement côté serveur à TikTok à l’aide de l’extension d’API d’événements web TikTok. Pour plus d’informations sur les fonctionnalités de transfert d’événement dans Adobe Experience Platform, consultez la présentation du transfert d’événement.