TikTok présentation de l’extension de l’API des événements web

La variable TikTok API events est sécurisée. API du serveur réseau Edge qui vous permet de partager des informations avec TikTok à propos directement des actions des utilisateurs sur vos sites web. Vous pouvez utiliser les règles de transfert d’événement pour envoyer des données à partir de la variable Adobe Experience Platform Edge Network to TikTok en utilisant la variable TikTok Extension de l’API des événements web.

Conditions préalables de TikTok prerequisites

Pour configurer la variable TikTok API d’événements web pour utiliser TikTok API d’événements, vous devez générer une TikTok code pixel et jeton d’accès.

Vous devez disposer d’un TikTok pour un compte professionnel afin de créer une TikTok en utilisant la configuration du partenaire. Accédez au TikTok page d’enregistrement professionnel pour 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 utilisant la configuration du partenaire. Pour ce faire, procédez comme suit :

  1. Accédez au Ressources et sélectionnez Événement.
  2. Sous Événements Web, sélectionnez Gérer.
  3. Sélectionner Configuration d’événements web.
  4. Sélectionner Configuration du partenaire comme méthode de connexion.

Voir Prise en main de Pixel pour plus d’informations sur la configuration de la variable TikTok 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 la propriété Paramètres . Sous API d’événements, sélectionnez Générer un jeton d’accès.

Voir TikTok guide de prise en main pour plus d’informations sur la configuration du code pixel et du jeton d’accès.

Installez et configurez le TikTok extension de l’API des événements web install

Pour installer l’extension, sélectionnez Extensions dans le volet de navigation de gauche. Dans le Catalogue , sélectionnez l’onglet Extension de l’API des événements web TikTok puis sélectionnez Installer.

Le catalogue d’extensions affichant la variable TikTok installation de mise en surbrillance de la carte d’extension.

Dans l’écran suivant, saisissez les valeurs de configuration suivantes que vous avez générées précédemment à partir de TikTok Gestionnaire de publicités :

  • Code pixel
  • Jeton d’accès

Lorsque vous avez terminé, sélectionnez Enregistrer.

TikTok écran de configuration pour la TikTok extension de l’API des événements web.

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éer règle dans la 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 la variable Type d’action to Envoi de l’événement de l’API des événements web TikTok.

La variable Envoi de l’événement de l’API des événements web TikTok type d’action sélectionné pour un TikTok dans l’interface utilisateur de la collecte de données.

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 terminé, 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 TikTok outils d’intégration et peuvent être utilisés pour la création de rapports , l’optimisation pour les conversions et la création d’audiences.

Entrée
Description
Nom de l’événement
Nom de l’événement. Il s’agit d’actions avec des noms prédéfinis créés par TikTok et est un champ obligatoire. Voir TikTok API marketing documentation pour plus d’informations sur les événements pris en charge.
Heure de l’événement
Date-time sous forme de chaîne dans ISO 8601 ou dans yyyy-MM-dd'T'HH:mm:ss:SSSZ format. Il s’agit d’un champ obligatoire.
Identifiant d’événement
Identifiant unique généré par les annonceurs pour indiquer chaque événement. Il s’agit d’un champ facultatif qui est utilisé pour le dédoublonnage.

La variable Web Events and Parameters section présentant des exemples de saisie de données dans les champs.

Paramètres de contexte utilisateur

Les paramètres contextuels de l’utilisateur contiennent des informations sur le client utilisées pour faire correspondre les événements de visiteur web à TikTok utilisateurs. 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.

Entrée
Description
Adresse IP
Adresse IP publique du navigateur non hachée. La prise en charge des adresses IPv4 et IPv6 est assurée. Les formes complètes et compressées des adresses IPv6 sont reconnues.
Agent utilisateur
Agent utilisateur non haché de l’appareil de l’utilisateur.
E-mail
Adresse électronique du contact associé à l’événement de conversion.
Téléphone
Le numéro de téléphone doit être au format E164 [+][code pays][code zone][local phone number] avant le hachage.
ID de cookie
Si vous utilisez Pixel SDK, un identifiant unique est automatiquement enregistré dans la variable _ttp , si les cookies sont activés. La variable _ttp peut être extraite et utilisée pour ce champ.
Identifiant externe
Tout identifiant unique, tel que les identifiants d’utilisateur, les identifiants de cookie externe, etc., doit être haché avec SHA256.
TikTok Click ID
La variable ttclid qui est ajouté à l’URL de la landing page chaque fois qu’une publicité est sélectionnée sur TikTok.
Page URL (URL de la page)
URL de la page au moment de l’événement.
URL du référent de page
URL du référent de la page.

La variable User Context Parameters section présentant des exemples de saisie de données dans les champs.

Paramètres des propriétés

Utilisez les paramètres de propriétés pour configurer d’autres propriétés prises en charge.

Entrée
Description
Prix
Le coût d’un seul article.
Quantité
Nombre d’éléments achetés dans l’événement. Il doit s’agir d’un nombre positif supérieur à 0.
Type de contenu
Une valeur de product ou product_group doit être affecté à 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.
Identifiant de contenu
Identifiant unique de l’élément de produit.
Catégorie de contenu
Catégorie de la page/du produit.
Nom du contenu
Nom de la page/du produit.
Devise
Devise des éléments achetés dans l’événement. Cela est exprimé dans la norme ISO-4217.
Valeur
Le prix total de la commande. Cette valeur sera égale au prix * quantity.
Description
Description de l’élément ou de la page.
Requête
Chaîne de texte utilisée pour rechercher un produit.
Statut
État d’une commande, d’un article ou d’un service. Par exemple, "Envoyé".

La variable Properties Parameters section présentant des exemples de saisie de données dans les champs.

Déduplication des événements deduplication

TikTok pixel doit être configuré pour le dédoublonnage si vous utilisez les TikTok SDK pixel et TikTok extension de l’API des événements web 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 votre rapport n’a pas d’impact négatif, vous devez vous assurer que tout événement unique partagé par la variable TikTok SDK pixel et TikTok l’extension de l’API d’événements web est dédupliquée.

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.

Voir TikTok documentation sur Déduplication d’événements pour plus d’informations sur ce processus.

Étapes suivantes

Ce guide explique comment envoyer des données d’événement côté serveur à TikTok en utilisant la variable TikTok extension de l’API des événements web. Pour plus d’informations sur les fonctionnalités de transfert d’événement dans Adobe Experience Platform, reportez-vous au transfert d’événement - Aperçu.

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