Associazione avanzata

Questo documento spiega come inviare i dati utente degli eventi dell'app a Facebook per l'associazione avanzata. A queste informazioni viene applicato l'algoritmo di hashing prima che vengano condivise con noi. Usiamo queste informazioni in formato hash per determinare con maggior precisione quali persone hanno intrapreso azioni in risposta alla tua inserzione. Con questi dati, Facebook può abbinare gli eventi di conversione ai tuoi clienti per ottimizzare le tue inserzioni e creare un pubblico di remarketing più ampio.

Dopo l'operazione di associazione, Facebook elimina tempestivamente i dati in formato hash.

Puoi configurare l'associazione avanzata con uno dei due metodi seguenti:

• SDK di Facebook: aggiungi il codice alla tua app mobile per Android o iOS per inviare manualmente i dati a Facebook.
• API Facebook App Events: aggiungi query al codice per inviare manualmente i dati a Facebook.
• Gestione eventi: configura la tua app nella dashboard Gestione eventi per attivare l'associazione avanzata automatica per l'invio dei dati a Facebook.
• SDK Mobile Measurement Partners (MMP): aggiungi codice all'app per Android o iOS per inviare i dati alla dashboard Adjust.

Uso dell'SDK di Facebook

Quando usi l'SDK di Facebook per inviare i dati degli eventi nell'app degli utenti a Facebook, tutti i dati dell'utente verranno sottoposti a hashing. Questi dati in formato hash persistono tra le varie istanze dell'app.

Requisiti

• SDK di Facebook 4.36 o successiva

Android

Imposta i dati dell'utente durante l'inizializzazione di AppEventsLogger con la funzione setUserData. Questa funzione applicherà l'algoritmo di hashing ai dati utente.

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

Imposta i dati utente durante l'inizializzazione di FBSDKAppEvents con la funzione setUserData . Ai dati utente sarà applicato l'algoritmo di hashing e persisteranno tra un'istanza dell'app e l'altra.

Consigli

• Per assicurarsi che l'associazione avanzata funzioni correttamente, consigliamo di eseguire l'aggiornamento alla versione più recente dell'SDK iOS Facebook. Consulta il registro modifiche SDK iOS per maggiori informazioni.

Esempio di codice per l'impostazione di un tipo di dati

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

Esempio di codice per l'impostazione di più tipi di dati

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

Uso di Gestione eventi

L'associazione avanzata automatica configura automaticamente il tuo SDK di Facebook affinché rilevi e riceva dati utente insieme all'evento o all'azione che ha avuto luogo nella tua app. Questi dati vengono sottoposti all'algoritmo di hashing prima di essere inviati a Facebook.

Per attivare l'associazione avanzata automatica, vai in Gestione eventi, seleziona la tab Impostazioni dell'app e imposta Associazione avanzata automatica su ON. Puoi inoltre condividere indirizzi e-mail e numeri di telefono sottoposti alla procedura di hashing.

Nota: devi aver implementato l'SDK di Facebook 5.8.0 o successiva.

Uso dell'SDK Adjust

Aggiungere dati dei clienti agli eventi Adjust

Quando usi l'SDK Mobile Measurement Partners (MMP) Adjust, usa la funzione di hash come mostrato nell'esempio di seguito, poiché l'SDK MMP non applicherà l'hashing automaticamente. Se non usi una funzione di hash, l'API genererà un'eccezione e non accetterà testo semplice.

Aggiungi i parametri dei dati dei clienti da trasmettere ai partner di rete, che sono stati attivati nella dashboard Adjust dashboard, chiamando il metodo addPartnerParameter sull'istanza ADJEvent .

Nota: non devi implementare l'SDK di Facebook.

Codice di esempio Android

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

Codice di esempio iOS

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

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

[Adjust trackEvent:event];

Per maggiori informazioni, consulta gli esempi di codice Github.

Associare i parametri Adjust ai parametri di Facebook

Segui i passaggi seguenti per associare il parametro Adjust al parametro Facebook nella dashboard Adjust.

1. Nella dashboard Adjust, fai clic sulle Impostazioni dell'app per la quale desideri associare i parametri dei partner.
2. Seleziona Configurazione partner.
3. Clicca sul partner di interesse.
4. Seleziona Mappatura parametri partner.
5. Inserisci i nomi dei parametri partner inviati ad Adjust dall'SDK nella colonna DALL'APP a sinistra. Dovrebbero essere gli stessi per tutti i partner. Ad esempio, se usi email come nome del parametro nell'SDK Adjust, inserisci "email".
6. Inserisci i nomi dei parametri desiderati da questo partner nella colonna A PARTNER a destra. Questi valori sono specifici per singolo partner. Il parametro usato nell'SDK di Facebook deve essere nel formato ud[pii_type_name]. Ad esempio, "email" deve usare ud[em], phone deve usare ud[ph].

Per maggiori informazioni, consulta la documentazione Adjust.