How to set up a secure data connection with TikTok through Blotout
TikTok for Business offers many tools that let you share the actions people take on your website with TikTok. When you share these events with TikTok, you can better optimize your campaigns and measure ad performance.
This article describes how to setup a secure data connection through Blotout. Blotout supports the TikTok Pixel and Events API.
For more information on these connection tools, please review the following resources:
Intégration
Vous n'avez pas besoin de configurer votre Pixel TikTok séparément : Blotout le chargera pour vous.
TikTok comporte sept champs :
ID du Pixel (obligatoire) : ID du Pixel auquel vous souhaitez assigner des attributs.
ID de l'annonceur (obligatoire) : ID publicitaire nécessaire à la synchronisation de l'audience.
oAuth (obligatoire) : Un jeton qui autorise EdgeTag à accéder à l'API TikTok.
Pixel du navigateur (facultatif) : Si vous l'activez, nous intégrerons automatiquement le Pixel du navigateur TikTok et enverrons les mêmes événements depuis le navigateur et le serveur. Il est essentiel d'ajouter le même ID d'événement aux deux événements pour permettre à TikTok de les dédupliquer. Si vous n'activez pas cette option, vous risquez d'envoyer des événements en double depuis vos Pixels existants, ce qui aura pour effet de gonfler le nombre d'événements d'Achat.
ID d'ensemble d'événements hors ligne (facultatif) : ID de l'ensemble qui sera utilisé pour les conversions hors ligne.
Événement d'achat (facultatif) : Vous pouvez choisir comment l'événement d'achat vous sera notifié sur TikTok. En tant que Finalisation du paiement ou Commande
Code de test des événements (facultatif) : Saisissez le code de test du Gestionnaire d'événements pour que votre Pixel teste les événements, afin de vérifier que tout est bien collecté. Vous devez supprimer ce code de test avant d'utiliser EdgeTag, faute de quoi les événements ne seront pas enregistrés.
LDU (facultatif) : Si vous l'activez, il se peut que vous constatiez des répercussions sur la taille des audiences dans les États suivants aux États-Unis : Californie, Colorado, Connecticut, Utah, Virginie, Iowa, Minnesota, Tennessee, Maryland, Delaware, Floride, Montana, Nebraska, New Hampshire, New Jersey, Oregon, Texas, Indiana, Kentucky, ainsi que sur l'efficacité de leurs campagnes (les données LDU n'étant pas utilisées à des fins d'optimisation). La fonction LDU permet aux entreprises de mieux contrôler la manière dont les données d'événement sont utilisées dans les systèmes de TikTok. Pour en savoir plus, consultez Utilisation de données limitées.
Pour trouver votre ID de Pixel :
Accédez à TikTok Ads Manager. Survolez l'option Outils et cliquez sur Gestionnaire d'événements pour l'ouvrir.
À droite, sous Vue d'ensemble des ensembles de données, cliquez sur le Pixel que vous souhaitez utiliser.
Copiez la valeur de l'ID du Pixel et collez-la dans le champ correspondant sur Blotout.
ID de l'annonceur
Dans TikTok Ads Manager, cliquez sur le menu déroulant Compte en haut à droite de l'en-tête. Copiez l'ID du compte publicitaire que vous souhaitez utiliser avec Blotout.
ID de l'ensemble d'événements hors ligne
Comme pour l'ID du Pixel, vous devez vous rendre dans la section Événements. Sélectionnez Événements hors ligne au lieu d'Événements Web. Copiez l'ID de l'Ensemble d'événements hors ligne que vous souhaitez utiliser.
Configuration du navigateur
Si vous utilisez notre SDK via un package npm, vous devrez ajouter un package supplémentaire pour que ce fournisseur fonctionne correctement. Vous devrez installer @blotoutio/providers-tiktok-sdk.
Après l'avoir installé, vous devrez l'ajouter à votre appel init.
Exemple
# Code Snippet
import { init } from '@blotoutio/edgetag-sdk-js'
import tiktok from '@blotoutio/providers-tiktok-sdk'
init({
edgeURL: 'https://d.mysite.com',
disableConsentCheck: true,
providers: [tiktok]
})
Événements
Il s'agit d'événements standards recommandés par TikTok.
Vous trouverez nos événements standard dans notre guide.
Événement | Action |
|---|---|
Clic sur un bouton | Lorsque l'utilisateur clique sur un bouton. |
Ajout à la liste de souhaits | Quand un article est ajouté aux favoris. |
Contact | Lorsqu'une prise de contact ou une consultation se produit. |
Téléchargement | Lorsque l'utilisateur clique sur un bouton pour ouvrir une page de téléchargement externe dans le navigateur. |
Envoi de formulaire | Lorsqu'un formulaire est envoyé. |
Finalisation de l'inscription | Lorsqu'une inscription est finalisée. |
Pour tous les événements ci-dessus, il existe des champs facultatifs que vous pouvez remplir comme indiqué ci-dessous.
Nom | Type | Obligatoire | Description |
|---|---|---|---|
currency | string | non | Code ISO 4217 |
value | number | non | Valeur de la commande ou des articles vendus, qui correspond au prix total de la commande |
recherche | string | non | Chaîne de texte qui a été recherchée |
programme | Programme[] | non | Éléments connexes dans un événement Web |
Définitions des types
Nom | Type | Obligatoire | Description |
|---|---|---|---|
ID | string | oui | ID du produit |
quantity | number | non | Nombre d'articles |
item_price | number | non | Prix d'un seul article |
title | string | non | Nom de la page/du produit |
category | string | non | Catégorie de la page/du produit |
price | string | oui | La valeur de la propriété de l'objet content_type doit être product ou product_group. Si vous envisagez de suivre les événements associés à des produits individuels, définissez la valeur sur product. Pour suivre les événements associés à des groupes de produits, définissez-la sur product_group. |
Vous trouverez ci-dessous l'exemple de charge utile que vous devez utiliser pour que l'événement spécifique, qui ne fait pas partie de nos événements standard, soit traité correctement par le fournisseur.
Exemples
// Browser example
edgetag('tag', 'AddToCart', { value: 10.0, currency: 'USD' })
// Node example
import { tag } from '@blotoutio/edgetag-sdk-js'
tag('AddToCart', { value: 10.0, currency: 'USD' })
