Intégrer TikTok for Business avec Adapty Attribution

L’intégration de l’attribution Adapty avec TikTok for Business vous permet de suivre et d’optimiser les performances de vos campagnes sur TikTok.

Étape 1. Connecter votre compte TikTok

  1. Accédez à Integrations > TikTok Ads depuis la barre latérale gauche et cliquez sur Continue with TikTok.
ua-connect-tiktok.webp
  1. Connectez-vous avec votre compte TikTok et cliquez sur Continue.

  2. Vérifiez les autorisations demandées et cliquez sur Save.

ua-tiktok-sign.webp

Ensuite, tous vos comptes publicitaires seront ajoutés à Adapty Attribution. Vous pouvez alors passer à l’ajout de campagnes.

Étape 2. Ajouter des campagnes

Une seule campagne peut couvrir l’App Store, le Google Play et votre funnel web en même temps. Deux éléments assurent la connexion :

  • Lien de suivi : À intégrer dans votre annonce. Quand un utilisateur appuie sur l’annonce, Adapty enregistre le clic, redirige l’utilisateur vers la destination, puis attribue l’installation et les achats à cette annonce. Chaque destination possède son propre lien.
  • Pixel : Sélectionné dans la campagne, parmi les pixels de votre compte TikTok. Renvoie ces conversions à TikTok afin que TikTok puisse optimiser la campagne sur la base d’achats réels. Un seul pixel peut couvrir les trois destinations, ou chaque destination peut avoir le sien.

Pour ajouter une campagne TikTok for Business à Adapty Attribution et suivre les performances de vos annonces TikTok dans Adapty :

  1. Accédez à l’onglet Web Campaigns et cliquez sur Create configuration.

    ua-new-campaign-tiktok.webp
  2. Dans l’onglet General, développez la section iOS et/ou Android et collez les URL de l’application App Store et/ou Google Play.

    ua-url.webp
  3. Copiez la valeur du champ Click link. Ensuite, dans TikTok Ads Manager, lors de la création de votre annonce, collez cette valeur dans le champ Destination URL. Cela permettra à Adapty de relier les installations et les achats aux annonces dans TikTok. Voir Ajouter du contenu publicitaire.

    ua-lnk.webp
  4. (Facultatif) Pour renvoyer les événements de conversion à TikTok, vous pouvez également associer vos pixels TikTok à des campagnes dans Adapty Attribution. Pour ce faire, sélectionnez l’un de vos pixels existants dans le menu déroulant Pixel. Après avoir sélectionné un pixel, vous pouvez cliquer sur Send test event pour vérifier la connexion.

    La section Web funnel fonctionne de la même façon. Les achats effectués dans un web funnel se déroulent en dehors de votre application, donc TikTok n’en est informé que via le pixel que vous sélectionnez ici. Cette section vous fournit également le snippet pour installer le pixel sur votre funnel et les paramètres pour tagger vos URLs publicitaires.

Un pixel différent par destination permet de distinguer les achats iOS, Android et web pour l’optimisation et les rapports ; le même pixel partout les regroupe. La liste Web Campaigns affiche ce choix pour chaque configuration, sous Pixel (iOS), Pixel (Android) et Pixel (Web), avec le nom et l’identifiant du pixel. Une section sans pixel affiche un tiret, et un pixel sélectionné dans les trois sections apparaît trois fois.

Étape 3. Mapper les événements

Pour renvoyer des événements de conversion à TikTok et optimiser vos campagnes, vous devez configurer le mapping des événements dans la section Events mapping. Cela permet à Adapty d’envoyer automatiquement des événements d’abonnement lorsque les utilisateurs effectuent des actions dans votre application.

Dans la section Events mapping, activez les événements que vous souhaitez suivre dans TikTok Ads Manager. Pour chaque événement activé, sélectionnez l’événement TikTok correspondant dans le menu déroulant ou définissez un événement personnalisé. Par défaut, Adapty associe ses événements aux événements standard de TikTok.

Cliquez sur Save pour appliquer votre configuration de mapping des événements.

ua-meta-events.webp

Configuration supplémentaire

Paramètres supplémentaires

Le champ Additional parameter vous permet d’ajouter des données personnalisées pour une analyse en dehors d’Adapty. C’est utile lorsque vous avez besoin de transmettre des données spécifiques de campagne ou d’utilisateur à des outils d’analyse externes ou à des partenaires d’attribution.

Dans le champ Additional parameter, saisissez les données personnalisées que vous souhaitez inclure dans votre suivi d’attribution. Le paramètre supplémentaire sera inclus dans toutes les données d’attribution envoyées à TikTok et peut être utilisé pour une analyse et une optimisation avancées des campagnes.

Par exemple, si vous exécutez plusieurs variations de la même campagne, vous pouvez ajouter variant=A ou variant=B pour distinguer les différentes approches créatives.

Important

Les paramètres supplémentaires modifient le Click link que vous collez dans TikTok Ads Manager. Si vous avez déjà copié ce lien et ajouté un paramètre personnalisé ensuite, assurez-vous de copier-coller le lien mis à jour qui contient ce paramètre.


ua-custom-tiktok1.webp

Paramètres

L’onglet Settings contrôle la façon dont Adapty associe une installation à un clic sur votre publicité TikTok. Ces paramètres s’appliquent uniquement à cette configuration de campagne.

Adapty utilise deux types d’association :

  • La correspondance déterministe fonctionne uniquement sur Android. Google Play transmet l’ID du clic à votre application via le Play Install Referrer, ce qui permet à Adapty d’associer l’installation à ce clic précis. iOS ne dispose d’aucun mécanisme équivalent, donc les installations iOS ne sont jamais associées de manière déterministe.
  • La correspondance probabiliste fonctionne sur iOS et Android. Adapty compare l’installation avec les clics provenant de la même plage d’adresses IP et du même système d’exploitation, puis associe l’installation au clic obtenant le meilleur score selon le délai depuis le clic, la langue de l’appareil et le pays. Si le clic remonte à plus de 6 heures avant l’installation, le modèle d’appareil et la version du système d’exploitation doivent également correspondre. Adapty n’utilise ni l’IDFA ni le Google Advertising ID, de sorte que la correspondance probabiliste couvre tous les utilisateurs iOS, y compris ceux qui ont refusé le suivi dans l’invite App Tracking Transparency.

Sur Android, Adapty tente d’abord la correspondance déterministe, puis revient à la correspondance probabiliste en cas d’échec.

Pour définir la durée pendant laquelle une installation peut encore être attribuée à un clic, dans l’onglet Settings, section New user attribution, saisissez la fenêtre en heures :

  • Deterministic Matching Window : 168 heures (7 jours) par défaut, de 1 à 720 heures.
  • Probabilistic Matching Window : 6 heures par défaut, de 1 à 24 heures. Une fenêtre plus longue permet de faire correspondre davantage d’installations, mais augmente le nombre d’erreurs. Pour les campagnes à fort volume de clics, réduisez-la à 1–2 heures.

Pour désactiver la correspondance déterministe ou probabiliste pour cette configuration, désactivez le commutateur correspondant à sa fenêtre et enregistrez. La modification prend effet dans les 5 minutes.

Warning

Les installations iOS ne peuvent être associées que de manière probabiliste. Si vous désactivez la correspondance probabiliste, les installations iOS provenant des liens de cette configuration ne seront pas attribuées. Si vous désactivez les deux, aucune installation provenant de ses liens ne sera attribuée.

Nouvelle section d'attribution des utilisateurs dans l'onglet Paramètres, avec les fenêtres de correspondance déterministe et probabiliste et leurs boutons d'activation/désactivation

Revenus envoyés à TikTok

TikTok utilise la valeur de chaque événement pour calculer le ROAS et optimiser les enchères basées sur la valeur. Pour choisir quels revenus Adapty envoie à TikTok comme valeur, dans le menu déroulant Revenue sent to TikTok, sélectionnez un type de revenu et cliquez sur Save. Pour comparer le ROAS dans TikTok avec le ROAS dans Adapty, sélectionnez le type que vous affichez dans les analyses Adapty.

Menu déroulant « Revenue sent to TikTok » ouvert, avec les options Gross revenue, Proceeds after store commission et Proceeds after store commission and taxes
Type de revenuValeur d’un achat App Store ou Google Play
Revenu brut (par défaut)Le prix total payé par l’utilisateur, avant commission du store et taxes.
Recettes après commission du storeLe prix moins la commission de l’App Store ou de Google Play. Les taxes sont toujours incluses.
Recettes après commission du store et taxesLe prix moins la commission du store et les taxes.

Pour en savoir sur le calcul des commissions et taxes par Adapty, consultez Commissions et taxes.

Comment ce type s’applique dans les autres cas :

  • Achats web : pour les achats Stripe et Paddle, les deux types de recettes envoient la même valeur, comme dans l’analyse Adapty Attribution : le prix moins 4,5 % pour Stripe, et le prix total pour Paddle. Adapty ne déduit pas les taxes des achats web.
  • Remboursements : TikTok reçoit les événements de remboursement sans valeur, quel que soit le type.
  • Événements d’essai : le pourcentage de Remplacement de revenus s’applique au prix d’abonnement du type sélectionné.
  • Achats sans montant du type sélectionné : Adapty envoie à TikTok le revenu brut de l’achat.

Un nouveau type de revenus prend effet dans les 5 minutes suivant l’enregistrement et s’applique uniquement aux nouveaux événements. Adapty ne renvoie pas les événements déjà envoyés, et un événement d’essai qu’Adapty conserve pour un Essai qualifié est envoyé avec le type sélectionné au début de la période de rétention.

Si plusieurs configurations envoient des événements au même pixel, sélectionnez le même type de revenus dans chacune d’elles, afin que les valeurs dans ce pixel soient d’un seul et même type.

Warning

Les revenus nets sont inférieurs au chiffre d’affaires brut. Si vous passez de Gross revenue et qu’une campagne utilise un ROAS minimum, réduisez ce ROAS minimum dans TikTok, sinon la campagne risque de s’arrêter.

Remplacement du revenu

Si vous suivez les événements d’essai et souhaitez que TikTok leur attribue un revenu, utilisez la section Revenue override. Elle apparaît lorsque l’événement Trial started est activé. Le remplacement s’applique uniquement à Trial started — Trial converted et Subscription started transmettent toujours leur revenu réel.

Pour chaque cible d’événement d’essai, définissez le pourcentage du prix d’abonnement à déclarer comme revenu. Adapty applique ce pourcentage au prix dans le type sélectionné dans Revenus envoyés à TikTok. Par exemple, avec 30 % et Gross revenue, Adapty envoie 30 % du prix d’abonnement comme valeur de conversion pour les événements d’essai.

Pour ajouter un remplacement :

  1. Activez Trial started dans la section Events mapping.
  2. Dans Revenue override, cliquez sur Add event.
  3. Sélectionnez l’événement cible et entrez un pourcentage de revenu (0–100).
  4. Cliquez sur Save.
revenue-override.webp

Essai qualifié

Warning

Adapty Attribution retarde l’événement d’essai jusqu’à 24 heures et ne l’envoie que si l’utilisateur n’a pas annulé. Si un MMP transfère également trial_started ou trial_active, TikTok reçoit le même essai plusieurs fois.

Un essai est qualifié lorsqu’il survit un certain nombre d’heures sans être annulé. Utilisez la section Qualified trial pour retenir les événements d’essai jusqu’à leur qualification, afin que TikTok ne reçoive que les essais conservés par les utilisateurs.

Pour chaque cible d’événement d’essai, définissez le nombre d’heures à attendre. Adapty compte les heures à partir du début de l’essai et envoie l’événement lorsque le délai est dépassé. Si l’utilisateur désactive le renouvellement automatique avant le délai, Adapty n’envoie jamais l’événement. Si l’utilisateur réactive le renouvellement automatique avant le délai, Adapty envoie l’événement comme prévu.

Pour retenir un événement d’essai jusqu’à ce qu’il soit qualifié :

  1. Activez Trial started dans la section Events mapping.
  2. Dans Qualified trial, cliquez sur Add event.
  3. Sélectionnez l’événement cible et entrez le nombre d’heures à attendre, de 1 à 24.
  4. Cliquez sur Save.
Section d'essai qualifié avec un événement cible retenu pendant deux heures dans une configuration de campagne

Adapty envoie l’événement qualifié avec l’heure de début d’essai d’origine, afin que TikTok le signale au jour où l’essai a commencé.

Important

Adapty associe les essais qualifiés à leur transaction App Store ou Google Play, donc le délai s’applique uniquement aux essais intégrés. Les événements d’essai provenant d’achats web, comme FunnelFox, sont envoyés immédiatement.

Revenue override et Qualified trial fonctionnent indépendamment, et vous pouvez appliquer les deux au même événement de trial. Revenue override modifie la valeur que TikTok reçoit ; Qualified trial modifie le moment où TikTok la reçoit. Avec les deux actifs, Adapty retient l’événement jusqu’à ce que le trial soit qualifié, puis l’envoie avec le revenu remplacé. Aucune des deux options n’est recommandée par rapport à l’autre — testez ce qui fonctionne pour vos campagnes.

Envoyer les événements de tous les utilisateurs

Par défaut, Adapty ne transmet que les événements des utilisateurs qu’il attribue à cette configuration. L’option Send events from all users transmet à la place les événements de tous les utilisateurs de votre application, y compris les utilisateurs organiques, les utilisateurs provenant d’autres réseaux publicitaires et les utilisateurs de vos autres configurations TikTok. TikTok décide ensuite à quelles de ses publicités attribuer ces conversions. Cette option ne modifie pas l’attribution dans Adapty.

Nous ne le recommandons pas, sauf si vos campagnes envoient trop peu de conversions à TikTok pour l’optimisation, car le mélange d’événements organiques et non attribués avec les événements de vos campagnes réduit la précision de l’optimisation de TikTok.

Si vous décidez de l’activer, dans les paramètres de la campagne, sélectionnez Send events from all users et cliquez sur Save.