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

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 de l’abonnement à déclarer comme revenu. Par exemple, à 30 %, Adapty envoie 30 % du prix de l’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 saisissez 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 tous les événements

Par défaut, Adapty ne remonte que les événements des utilisateurs provenant de l’une de vos campagnes TikTok. L’option Send all events remonte chaque installation et transaction, y compris celles des utilisateurs organiques ou non attribués.

Nous ne le recommandons pas, sauf si vos campagnes envoient trop peu de conversions à TikTok pour être optimisées, car mélanger des événements organiques et non attribués avec vos événements de campagne réduit la précision de l’optimisation TikTok.

Si vous décidez de l’activer, dans les paramètres de la campagne, sélectionnez Send all events (forward organic/non-attributed events to this pixel) et cliquez sur Save.