Nous mettons à jour notre documentation continuellement, mais certaines publications peuvent ne pas encore être disponibles dans votre langue. Pour accéder aux informations les plus récentes, utilisez la version en anglais.

Reporting des données brutes de Meta pour Android

Meta permet aux annonceurs d'enrichir leurs données brutes pour Android à l'aide de référents d'installation. Les métadonnées de campagnes sont ajoutées au référent d'installation dans un format chiffré. Pour lire les métadonnées, vous devez utiliser la clé de déchiffrement fourni par Meta pour votre application.

Il existe deux référents d'installation pris en charge que vous pouvez utiliser pour enrichir vos données brutes :

  • Le GPIR (Google Play Install Referrer)
  • Le MIR (Meta Install Referrer)

Ces deux référents d'installation donne davantage d'informations sur les installations d'applications issues d'applications Meta, telles que Facebook et Instagram. Toutefois, seul le MIR prend en charge l'attribution liée au visionnage et au clic en dehors de la même session.

Avant de commencer

Voici ce que vous devez savoir avant de commencer.

Prérequis

  • Une Meta Decryption Key pour l'application.
  • Les utilisateurs avec des autorisations Administrateur et Éditeur peuvent mettre à jour les identifiants Meta dans Adjust.

GPIR

Pour activer le GPIR, vous devez configurer le référent d'installation Google Play.

MIR

Pour activer le plugin MIR, vous devez mettre à jour le SDK Adjust Android vers la version 5 et configurer le plugin de référent d'installation (MIR) de Meta.

Mode de fonctionnement

À l'aide de la solution des référents d'installation, vous pouvez relier l'activité in-app d'un utilisateur à sa source d'acquisition pour les annonces diffusées sur Android. Cela vous permet de continuer à mesurer la réussite de vos campagnes et d'identifier les grandes tendances de l'acquisition.

  1. Lorsqu'un utilisateur installation votre application, le référent d'installation collecte les données de référence auprès de la source d'installation.
  2. Meta partage ces données chiffrées à l'aide de l'API du référent d'installation.
  3. Adjust extrait ensuite ces données et les déchiffre à l'aide de votre clé de déchiffrement Meta.

Voici à quoi peut ressembler une chaîne de données déchiffrée :

{
"ad_id":"12345",
"ad_objective_name":"APP_INSTALL",
"adgroup_id":"54321",
"adgroup_name":"Test Ad Group",
"campaign_id":"987654",
"campaign_name":"Test Campaign",
"campaign_group_id":"654321",
"campaign_group_name":"Test Campaign Group",
"account_id":"444444",
"publisher_platform":"Test Publisher Platform",
}

Vous pouvez utiliser des espaces réservés pour collecter des données déchiffrées dans vos exports de données brutes.

Astuce:
Si vous activez le GPIR et le MIR, vous recevrez des informations de ces deux sources dans vos exports de données brutes. Adjust déduplique uniquement les informations GPIR et MIR dans Datascape. Nous conseillons de donner priorité au GPIR.

Quelles sont les données qui ne sont pas partagées ?

Meta n'envoie pas les ID d'appareil.

Les points de données suivants sont uniquement disponibles lorsque vous utilisez le MIR :

  • Conversions après affichage.
  • Événements d'application issues de stores d'applications Android autres que Google Play Store (par exemple, Galaxy Store et Amazon Appstore).

Configurer le référent d'installation

Pour configurer la solution du référent d'installation et recevoir des détails au niveau des campagnes depuis Meta, procédez comme suit.

Partager vos identifiants Meta avec Adjust

Pour permettre à Adjust de déchiffrer les données du référent, vous devez fournir une Decryption Key (clé de déchiffrement) de votre référent d'installation.

Trouver votre Decryption Key

Une Decryption Key est une chaîne de 64 caractères disponible à travers le Meta App ID.

Exemple : 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

Pour trouver votre Decryption Key, procédez comme suit.

  1. Ouvrez App Dashboard.
  2. Sélectionnez l'application de votre choix.
  3. Sélectionnez Settings > Basic .
  4. Accédez à la section Android .
  5. Copiez la valeur  Install Referrer Decryption Key .
A screenshot from Meta's App Dashboard that shows where to find your Decryption Key. Refer to the textual instructions above.

Ajouter votre Decryption Key dans Adjust

Pour ajouter votre Decryption Key dans Adjust, procédez comme suit.

  1. Ouvrez Campaign Lab > Partenaires .
  2. Recherchez Facebook et sélectionnez-le pour ouvrir la page d'aperçu.
  3. Sélectionnez l'onglet Partage des données pour afficher la liste des applications.
  4. Trouvez l'application que vous souhaitez configurer, puis sélectionnez le bouton Modifier ().
  5. Dans la section Activer le partage des données pour Facebook , sélectionnez Modifier .
  6. Collez la Decryption Key que vous avez copiée à l'étape précédente dans le champ Clé de déchiffrement (optionnelle) .
  7. Cliquez sur le bouton Enregistrer .

Ajouter des espaces réservés de référent Meta à vos callbacks

Adjust peut utiliser des espaces réservés pour vous envoyer des données déchiffrées depuis Meta. Pour les recevoir dans vos exports de données brutes, ajoutez les espaces réservés appropriés à votre URL de callback ou votre définition CSV.

Espaces réservés disponibles

GPIR
MIR
Espace réservéDescription
{fb_install_referrer}Contenu complet du référent d'installation Meta, au format déchiffré.
{fb_install_referrer_campaign_group_name}La valeur « campaign_group_name » issue du contenu complet du référent d'installation Meta.
{fb_install_referrer_campaign_group_id}La valeur « campaign_group_id » issue du contenu complet du référent d'installation Meta.
{fb_install_referrer_campaign_name}La valeur « campaign_name » issue du contenu complet du référent d'installation Meta.
{fb_install_referrer_campaign_id}La valeur « campaign_id » issue du contenu complet du référent d'installation Meta.
{fb_install_referrer_adgroup_id}La valeur « adgroup_id » issue du contenu complet du référent d'installation Meta.
{fb_install_referrer_adgroup_name}La valeur « adgroup_name » issue du contenu complet du référent d'installation Meta.
{fb_install_referrer_ad_id}La valeur « ad_id » issue du contenu complet du référent d'installation Meta.
{fb_install_referrer_account_id}La valeur « account_id » issue du contenu complet du référent d'installation Meta.
{fb_install_referrer_ad_objective_name}La valeur « ad_objective_name » issue du contenu complet du référent d'installation Meta.
{fb_install_referrer_publisher_platform}La valeur « publisher_platform » issue du contenu complet du référent d'installation Meta.

Mappage des espaces réservés et des rapports

Adjust utilise les mappages suivantes pour aligner les données reçues des espaces réservés du référent de Meta sur notre reporting.

GPIR
MIR
Champ d'attribution AdjustReporting MetaEspace réservéValeur d'exemple
network_namePlateforme de l'éditeur {fb_install_referrer_publisher_platform} Installations Meta
campaign_nameNom de la campagne
ID de la campagne
{fb_install_referrer_campaign_group_name}
({fb_install_referrer_campaign_group_id})
Test campagne Meta Android (123456789)
adgroup_nameNom du groupe d'annonces
ID du groupe d'annonces
{fb_install_referrer_campaign_name}
({fb_install_referrer_campaign_id})
Android - US - Groupe d'annonces de base (234567890)
creative_nameNom de l'annonce
ID de l'annonce
{fb_install_referrer_adgroup_name}
({fb_install_referrer_adgroup_id})
Bannière été (345678901)

Comment Adjust affiche le network_name

Adjust utilise la logique suivante pour reporter le network_name :

publisher_platformnetwork_name reporté sous la forme de :
« facebook », « unknown » ou autreInstallations Facebook
"instagram”Installations Instagram
"messenger”Installations Facebook Messenger
"audience_network”Installations hors Facebook

Callbacks d'exemple

GPIR
MIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&fb_referrer={fb_install_referrer}&PhFbInstallReferrerAdId={fb_install_referrer_ad_id}&PhFbInstallReferrerAdGroupId={fb_install_referrer_adgroup_id}&PhFbInstallReferrerAdGroupName={fb_install_referrer_adgroup_name}&PhFbInstallReferrerCampaignId={fb_install_referrer_campaign_id}&PhFbInstallReferrerCampaignName={fb_install_referrer_campaign_name}&PhFbInstallReferrerCampaignGroupId={fb_install_referrer_campaign_group_id}&PhFbInstallReferrerCampaignGroupName={fb_install_referrer_campaign_group_name}&PhFbInstallReferrerAccountId={fb_install_referrer_account_id}&PhFbInstallReferrerAdObjectiveName={fb_install_referrer_ad_objective_name}&PhFbInstallReferrerPublisherPlatform={fb_install_referrer_publisher_platform}

Exemple de callback renseigné avec des valeurs

GPIR
MIR
https://app.my-random-server.com/?tracker=unattr&tracker_name=Unattributed&referrer=adjust_reftag%3DceJTzfSP7kyVV%26utm_source%3Dfacebook%26utm_content%3D%257B%2522source%2522%253A%257B%2522data%2522%253A%2522afe56cf6228c6ea8c79da49186e718e92a579824596ae1d0d4d20d7793dca797bd4034ccf467bfae5c79a3981e7a2968c41949237e2b2db678c1c3d39c9ae564c5cafd52f2b77a3dc77bf1bae063114d0283b97417487207735da31ddc1531d5645a9c3e602c195a0ebf69c272aa5fda3a2d781cb47e117310164715a54c7a5a032740584e2789a7b4e596034c16425139a77e507c492b629c848573c714a03a2e7d25b9459b95842332b460f3682d19c35dbc7d53e3a51e0497ff6a6cbb367e760debc4194ae097498108df7b95eac2fa9bac4320077b510be3b7b823248bfe02ae501d9fe4ba179c7de6733c92bf89d523df9e31238ef497b9db719484cbab7531dbf6c5ea5a8087f95d59f5e4f89050e0f1dc03e464168ad76a64cca64b79%2522%252C%2522nonce%2522%253A%2522b7203c6a6fb633d16e9cf5c1%2522%257D%257D&fb_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhFbInstallReferrerAdId=12345&PhFbInstallReferrerCampaignId=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhFbInstallReferrerCampaignName=Adams+Test+Campaign&PhFbInstallReferrerCampaignGroupId=654321&PhFbInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhFbInstallReferrerAccountId=444444&PhFbInstallReferrerAdObjectiveName=APP_INSTALLS &PhFbInstallReferrerAdObjectiveName=APP_INSTALLS&FbInstallReferrerPublisherPlatform=facebook

Installations non attribuées à Meta

Si un référent est lié à une installation et que l'attribution finale est accordée à un autre partenaire, qui n'est pas Meta, vous recevez encore les informations du référent dans vos données.

GPIR
MIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&fb_install_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D