Aperçu

Important : Mettez à niveau vos workflows de conversions hors connexion vers l'API Data Manager pour bénéficier d'une meilleure expérience de développement et accéder à des fonctionnalités supplémentaires. Nous vous déconseillons d'implémenter de nouveaux workflows de conversions hors connexion à l'aide de l'API Campaign Manager 360.

Dans Campaign Manager 360, une conversion est enregistrée par une balise, appelée activité Floodlight, lorsqu'un utilisateur effectue une action prédéfinie après avoir vu une annonce. Les actions couramment taguées incluent le suivi lorsqu'un utilisateur achète un article dans une boutique en ligne ou consulte une page Web pour demander plus d'informations via un formulaire en ligne. En général, les conversions suivies par Google commencent et se terminent en ligne.

Toutefois, pour certains annonceurs, les conversions peuvent commencer en ligne et se terminer hors connexion. C'est par exemple le cas lorsqu'un utilisateur commence à rechercher un produit en ligne, clique sur une annonce, puis finalise son achat par téléphone ou dans un magasin physique. Dans ce scénario, Campaign Manager 360 dispose de données sur la partie en ligne de la transaction, mais pas sur la partie hors connexion. La conversion n'est donc pas enregistrée.

Pour résoudre ce problème, le service Conversions de l'API Campaign Manager 360 permet aux annonceurs de fournir des informations sur la partie hors connexion de ces conversions directement à Campaign Manager 360.

Prérequis

Avant de pouvoir commencer à utiliser le service Conversions, vous devez suivre les étapes ci-dessous :

1. Créez et autorisez un projet d'API comme indiqué dans notre guide de démarrage.

2. Assurez-vous que votre profil utilisateur Campaign Manager 360 dispose des autorisations de rôle utilisateur nécessaires. Si nécessaire, contactez l'administrateur de votre compte Campaign Manager 360 pour activer ces autorisations.

   • Insérer les conversions hors connexion : permet d'importer de nouvelles conversions hors connexion à l'aide de batchinsert.

   • Mettre à jour les conversions hors connexion : permet de modifier les conversions hors connexion existantes à l'aide de batchupdate.

Associer des conversions à des activités

Les conversions hors connexion doivent être associées à une activité en ligne correspondante dans Campaign Manager 360. Vous ferez référence à ces activités par leur floodlightActivityId et leur floodlightConfigurationId correspondants.

Si vous ne disposez pas encore d'activité pour le suivi des conversions hors connexion, vous pouvez en créer une à l'aide de le service FloodlightActivities de l'API pour. Pour savoir comment procéder, consultez le guide Tâches de trafficking courantes pour un exemple. Nous vous recommandons vivement de créer des activités dédiées aux conversions hors connexion.

Obtenir des ID de clic, d'appareil et d'utilisateur

Les conversions hors connexion doivent également être attribuées à un ID de clic, d'appareil ou d'utilisateur (un seul peut être utilisé à la fois). Les méthodes les plus courantes pour obtenir ces ID sont décrites ci-dessous.

Utiliser l'ID de clic sur le Réseau Display

Les conversions peuvent être attribuées aux clics sur les annonces à l'aide des ID de clic sur le Réseau Display (DCLID). Vous pouvez obtenir des DCLID à partir d'Attribution améliorée.

Important : Les conversions hors connexion ne peuvent pas être attribuées au clic spécifique identifié par un DCLID. Au lieu de cela, chaque conversion sera associée à l'utilisateur responsable du clic. Par exemple, si un clic plus récent a été enregistré pour le même utilisateur, la conversion peut être attribuée à ce clic.

Les ID de clic sur le Réseau Display doivent être transmis dans le dclid champ.

Utiliser l'ID de clic Google

Les conversions peuvent être attribuées aux clics sur les annonces à l'aide des ID de clic Google (GCLID). Vous pouvez obtenir des GCLID à partir de Google Ads ou de Search Ads 360.

Important : Les conversions hors connexion ne peuvent pas être attribuées au clic spécifique identifié par un GCLID. Au lieu de cela, chaque conversion sera associée à l'utilisateur responsable du clic. Par exemple, si un clic plus récent a été enregistré pour le même utilisateur, la conversion peut être attribuée à ce clic.

Les ID de clic Google doivent être transmis dans le gclid champ.

Utiliser l'ID de correspondance

Les conversions peuvent être attribuées à l'aide de votre propre identifiant first party synchronisé avec Google à l'aide de la fonctionnalité match_id dans Floodlight.

Utiliser l'ID d'appareil mobile

Les conversions peuvent être directement attribuées à des appareils mobiles ou à des appareils pour la télévision connectée à l'aide d'identifiants d'appareils publicitaires. Les identifiants suivants sont compatibles :

• AdID
• IDFA
• Identifiants publicitaires des appareils de TV connectée :
  • RIDA (Roku)
  • AFAI (Fire TV)
  • Identifiant publicitaire (Android TV)
  • IDFA (Apple TV)
  • MSAI (Xbox)
  • TIFA (Samsung)
  • VIDA (Vizio)

Ces identifiants doivent être transmis dans le mobileDeviceId champ.

Utiliser la macro de correspondance %m

Avertissement: Depuis le 25 mai 2018, les ID utilisateur chiffrés ne sont plus renseignés dans la macro %m pour les utilisateurs de l'Espace économique européen. En savoir plus

La macro%m peut être insérée dans les URL de redirection ou de destination d'une création. L'ad server développera cette macro en un ID utilisateur chiffré après un événement de clic. L'ID utilisateur chiffré peut ensuite être capturé directement à partir de l'URL de redirection ou des journaux du serveur.

Les ID capturés à l'aide de la macro %m doivent être transmis dans les encryptedUserId ou encryptedUserIdCandidates[] champs.

Important : Si vous prévoyez d'utiliser des ID utilisateur chiffrés, vous devez savoir comment ils sont chiffrés (c'est-à-dire leur encryptionInfo). Pour obtenir de l'aide à ce sujet, contactez votre représentant de compte Campaign Manager 360 ou l'assistance Campaign Manager 360.

Utiliser le transfert de données

Avertissement: Depuis le 25 mai 2018, les ID utilisateur chiffrés ne sont plus renseignés dans les fichiers de transfert de données pour les utilisateurs de l'Espace économique européen. En savoir plus.

Le transfert de données est une fonctionnalité de Campaign Manager 360 qui permet d'accéder aux données de journal de l'ad server au niveau de l'événement. Ces données sont fournies via des flux distincts, chacun comprenant un seul fichier de transfert de données. Dans ces fichiers, chaque événement enregistré est associé à un ID utilisateur chiffré.

Pour utiliser les ID utilisateur fournis dans les fichiers de transfert de données, vous devez pouvoir associer un événement d'ad server en ligne à un événement de votre système hors connexion. Pour ce faire , vous pouvez utiliser des variables Floodlight personnalisées, que vous pouvez remplir de manière dynamique avec des valeurs qui identifient de manière unique une action de l'utilisateur. Voici un workflow simplifié :

1. Une balise d'activité Floodlight se déclenche, indiquant le début d'une transaction. La balise contient une valeur de variable personnalisée que vous avez fournie et qui identifie de manière unique la transaction.

2. La transaction se poursuit et se termine hors connexion, en conservant le même identifiant.

3. À l'aide de l'identifiant enregistré lors de la finalisation de la transaction, une entrée correspondante est trouvée dans le fichier journal d'activité de transfert de données qui a enregistré l'activité Floodlight d'origine.

Les ID récupérés à partir des fichiers de transfert de données doivent être transmis dans les encryptedUserId ou encryptedUserIdCandidates[] champs.

Important : Si vous prévoyez d'utiliser des ID utilisateur chiffrés, vous devez savoir comment ils sont chiffrés (c'est-à-dire leur encryptionInfo). Pour obtenir de l'aide à ce sujet, contactez votre représentant de compte Campaign Manager 360 ou l'assistance Campaign Manager 360.