Correspondance avancée

Ce document explique comment envoyer les données utilisateur de vos app events à Facebook en vue d’une correspondance avancée. Ces informations sont hachées avant de nous être communiquées. Nous exploitons les informations hachées afin de déterminer plus précisément qui a effectué une action après avoir vu votre publicité. Grâce à ces données, Facebook peut faire correspondre les évènements de conversion avec votre clientèle en vue d'optimiser vos annonces et de redéfinir des audiences plus larges.

Une fois la correspondance établie, Facebook supprime rapidement les données hachées.

Voici les méthodes que vous pouvez utiliser pour configurer la correspondance avancée :

• SDK Facebook : ajoutez le code à votre app mobile Android ou iOS pour envoyer manuellement les données à Facebook.
• API App Events Facebook : ajoutez des requêtes à votre code pour envoyer manuellement les données à Facebook.
• Gestionnaire d’évènements : configurez votre application dans le tableau de bord du Gestionnaire d’évènements pour activer la correspondance avancée automatique afin que les données soient envoyées à Facebook.
• SDK Mobile Measurement Partner (MMP) : ajoutez le code à votre app mobile Android ou iOS pour que les données soient envoyées à votre tableau de bord Adjust.

Utiliser le SDK Facebook

Lorsque vous utilisez le SDK FB pour envoyer les données utilisateur des app events à Facebook, toutes ces données sont hachées. Elles sont conservées entre les instances de l’application.

Conditions requises

• SDK Facebook 4.36 ou une version ultérieure

Android

Définissez les données utilisateur lors de l’initialisation du AppEventsLogger avec la fonction setUserData. Celle-ci va hacher les données utilisateur.

AppEventsLogger logger = AppEventsLogger.newLogger(MainActivity.this);
AppEventsLogger.setUserData(
  “jsmith@example.com”,     //email
  “john”,                   //first name
  “smith”,                  //last name
  “16505554444”,            //phone number
  “19910526”,               //birthdate
  “f”,                      //gender
  “menlopark”,              //city
  “ca”,                     //state
  “94025”,                  //zip code
  “us”                      //country
);

iOS

Définissez les données utilisateur lors de l’initialisation du FBSDKAppEvents avec la fonction setUserData. Les données utilisateur sont hachées et conservées entre les instances de l’application.

Recommandations

• Afin de vous assurer que la correspondance avancée fonctionne correctement, nous vous recommandons d’installer la dernière version du SDK Facebook pour iOS. Pour en savoir plus, consultez le changelog du SDK pour iOS.

Exemple de code permettant de définir un type de données

[FBSDKAppEvents setUserData: @"jsmith@example.com" forType:FBSDKAppEventEmail];

Exemple de code permettant de définir plusieurs types de données

NSDictionary *const userData = @{
        @"em": @"jsmith@example.com",
        @"fn": @"john",
        @"ln": @"smith",
        @"ph": @"16505554444",
        @"db": @"19910526",
        @"ge": @"f",
        @"ct": @"menlopark",
        @"zp": @"94025",
        @"cn": @"us"};
[FBSDKAppEvents setUserEmail:(NSString *)userData["@em"]
     firstName:(NSString*)userData["@fn"]
     lastName:(NSString *)userData[@"ph"]
     phone:(NSString *)userData[@"ph"]
     dateOfBirth:(NSString *)userData[@"db"]
     gender:(NSString *)userData[@"ge"]
     city:(NSString *)userData[@"ct"]
     state:(NSString *)userData[@"st"]
     zip:(NSString *)userData[@"zp"]
     country:(NSString *)userData[@"cn"]];

Utiliser le Gestionnaire d’évènements

La correspondance avancée automatique configure automatiquement votre SDK Facebook de sorte qu’il détecte et reçoive les données utilisateur en même temps que l’évènement survenu ou l’action effectuée dans votre application. Ces données sont hachées avant d’être envoyées à Facebook.

Pour activer la correspondance avancée automatique, accédez à votre Gestionnaire d’évènements, sélectionnez l’onglet Paramètres de votre application et activez la correspondance avancée automatique. Vous pouvez également partager des adresses e-mail et des numéros de téléphone hachés.

Notez que vous devez avoir implémenté le SDK Facebook 5.8.0 ou une version ultérieure.

Utiliser le SDK Adjust

Ajouter les données client aux évènements Adjust

Lorsque vous utilisez le SDK Mobile Measurement Partner (MMP) Adjust, utilisez la fonction de hachage comme indiqué dans l’exemple ci-dessous. En effet, le SDK MMP ne hache pas automatiquement les données. Si vous n’utilisez pas la fonction de hachage, notre API génère une exception et n’accepte pas le texte brut.

Ajoutez les paramètres des données client à transmettre aux partenaires du réseau, qui ont été activés dans votre tableau de bord Adjust en appelant la méthode addPartnerParameter sur votre instance ADJEvent.

Notez que vous n’avez pas besoin d’implémenter le SDK Facebook.

Exemple de code pour Android

AdjustEvent event = new AdjustEvent('abc123');
event.addPartnerParameter('em', 'sha256_hashed_email');
event.addPartnerParameter('ph', 'sha256_hashed_phone');
Adjust.trackEvent(event);

Exemple de code pour iOS

ADJEvent *event = [ADJEvent eventWithEventToken:@'abc123'];

[event addPartnerParameter:@'em' value:@'sha256_hashed_email'];
[event addPartnerParameter:@'ph' value:@'sha256_hashed_phone'];

[Adjust trackEvent:event];

Pour plus d’informations, consultez les exemples de code GitHub.

Faire correspondre les paramètres Adjust aux paramètres Facebook

Suivez la procédure ci-dessous pour faire correspondre les paramètres Adjust aux paramètres Facebook dans le tableau de bord Adjust.

1. Dans le tableau de bord Adjust, cliquez sur les Paramètres de l’application dont vous souhaitez faire correspondre les paramètres de partenaire.
2. Sélectionnez Partner Setup (Configuration du partenaire).
3. Cliquez sur le partenaire qui vous intéresse.
4. Sélectionnez Partner Parameter Mapping (Mise en correspondance des paramètres de partenaire).
5. Saisissez les noms des paramètres de partenaire envoyés à Adjust par le SDK dans la colonne FROM APP de gauche. Les paramètres doivent être identiques pour chaque partenaire. Par exemple, si vous utilisez email en tant que nom de paramètre dans le SDK Adjust, saisissez « email ».
6. Saisissez les noms des paramètres de partenaire conformément au souhait du partenaire en question dans la colonne TO PARTNER de droite. Ce paramètre est spécifique au partenaire. Le paramètre utilisé dans le SDK Facebook doit être au format ud[pii_type_name]. Par exemple, « email » doit utiliser ud[em], « phone » doit utiliser ud[ph].

Pour plus d’informations, consultez la documentation Adjust.