Erweiterter Abgleich

In diesem Dokument wird erläutert, wie du Nutzerdaten deiner App Events für den erweiterten Abgleich an Facebook sendest. Diese Informationen werden gehasht, bevor sie an uns weitergegeben werden. Wir verwenden die gehashten Informationen dann, um genauer zu bestimmen, welche Nutzer Handlungen als Reaktion auf deine Anzeige durchgeführt haben. Anhand dieser Daten kann Facebook Conversion Events mit deinen Kunden abgleichen, um deine Anzeigen zu optimieren und größere Zielgruppen für das Remarketing zu erstellen.

Im Anschluss an den Abgleich verwirft Facebook die gehashten Daten unverzüglich.

Du kannst den erweiterten Abgleich mit einer der folgenden Methoden einrichten:

• Mit dem Facebook-SDK: Füge deiner mobilen Android- oder iOS-App Code hinzu, um Daten manuell an Facebook zu senden.
• Mit der Facebook App Events API: Füge deinem Code Abfragen hinzu, um Daten manuell an Facebook zu senden.
• Mit dem Events Manager: Konfiguriere deine App im Events Manager-Dashboard so, dass der automatische erweiterte Abgleich aktiviert wird, um Daten an Facebook zu senden.
• Mit dem Mobile Measurement Partners (MMP)-SDK: Füge deiner Android- oder iOS-App Code hinzu, um Daten an dein Adjust-Dashboard zu senden.

Facebook-SDK verwenden

Wenn du das FB-SDK verwendest, um Nutzerdaten von App Events an Facebook zu senden, werden alle Nutzerdaten gehasht. Diese gehashten Daten bleiben zwischen App-Instanzen erhalten.

Anforderungen

• Facebook-SDK 4.36 oder höher

Android

Lege Nutzerdaten fest, während AppEventsLogger mit der Funktion setUserData initialisiert wird. Mit dieser Funktion werden die Nutzerdaten gehasht.

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

Lege Nutzerdaten fest, während FBSDKAppEvents mit der Funktion setUserData initialisiert wird. Die Nutzerdaten werden gehasht und bleiben zwischen App-Instanzen erhalten.

Empfehlungen

• Damit der erweiterte Abgleich ordnungsgemäß funktioniert, empfehlen wir ein Upgrade auf die neueste Version des Facebook iOS-SDK. Weitere Informationen findest du im iOS-SDK-Änderungsprotokoll.

Beispielcode zum Festlegen eines Datentyps

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

Beispielcode zum Festlegen mehrerer Datentypen

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"]];

Events Manager verwenden

Der automatische erweiterte Abgleich konfiguriert dein Facebook-SDK automatisch so, dass Nutzerdaten zusammen mit dem Event oder der Handlung in deiner App erkannt und empfangen werden. Diese Daten werden gehasht, bevor sie an Facebook gesendet werden.

Zum Aktivieren des automatischen erweiterten Abgleichs rufe deinen Events Manager auf, wähle den Tab Einstellungen deiner App, und setze Automatischer erweiterter Abgleich auf EIN. Du kannst auch gehashte E-Mail-Adressen und Telefonnummern teilen.

Hinweis: Du musst das Facebook-SDK 5.8.0 oder höher implementiert haben.

Adjust-SDK verwenden

Kundendaten zu Adjust-Events hinzufügen

Wenn du das Adjust Mobile Measurement Partners (MMP)-SDK verwendest, nutze die Hash-Funktion wie im Beispiel unten dargestellt, denn das MMP-SDK hasht Daten nicht automatisch. Wenn du keine Hash-Funktion verwendest, gibt unsere API eine Ausnahme aus und akzeptiert keinen unformatierten Text.

Füge Kundendaten-Parameter hinzu, die an Netzwerkpartner übermittelt werden sollen, die in deinem Adjust -Dashboard aktiviert wurden, indem du die Methode addPartnerParameter in deiner ADJEvent-Instanz aufrufst.

Hinweis: Es ist nicht nötig, das Facebook-SDK zu implementieren.

Beispielcode für Android

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

Beispielcode für iOS

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

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

[Adjust trackEvent:event];

Weitere Informationen findest du in den Github-Codebeispielen.

Adjust-Parameter zu Facebook-Parametern zuordnen

Gehe folgendermaßen vor, um den Adjust-Parameter im Adjust-Dashboard zum Facebook-Parameter zuordnen.

1. Klicke im Adjust-Dashboard auf die Settings (Einstellungen) der App, für die du die Partner-Parameter zuordnen möchtest.
2. Wähle Partner Setup (Partnereinrichtung).
3. Klicke auf den betreffenden Partner.
4. Wähle Partner Parameter Mapping (Partnerparameter-Zuordnung).
5. Gib die Namen der Partnerparameter, die vom SDK an Adjust gesendet wurden, in der linken Spalte FROM APP (VON APP) ein. Diese sollten für jeden Partner gleich sein. Wenn du beispielsweise im Adjust-SDK email als Parameternamen verwendest, dann gib „email“ ein.
6. Gib die Namen der Partnerparameter wie von diesem Partner gewünscht in der rechten Spalte TO PARTNER (AN PARTNER) ein. Dies ist partnerspezifisch. Der im Facebook-SDK verwendete Parameter sollte das Format ud[pii_type_name] aufweisen. Beispiel: „email“ sollte ud[em] verwenden, „phone“ sollte ud[ph] verwenden.

Weitere Informationen findest du in der Adjust-Dokumentation.