Correspondência avançada

Este documento explica como enviar os dados de usuários dos eventos do app ao Facebook para a correspondência avançada. Essas informações serão convertidas em hash antes do compartilhamento com o Facebook. Usamos as informações convertidas em hash para definir mais precisamente quais pessoas realizaram ações em resposta ao seu anúncio. Com esses dados, o Facebook pode fazer a correspondência de eventos de conversão com os clientes para otimizar os anúncios e criar públicos de remarketing maiores.

O Facebook descarta os dados com hash imediatamente após a conclusão da correspondência.

É possível configurar a correspondência avançada por meio dos seguintes métodos:

• SDK do Facebook: adicione um código ao seu app para celular Android ou iOS e envie dados manualmente ao Facebook.
• API de Eventos do Aplicativo do Facebook: adicione consultas ao seu código para enviar dados de modo manual ao Facebook.
• Gerenciador de Eventos: configure o seu app no painel do Gerenciador de Eventos para ativar a correspondência avançada automática e enviar dados ao Facebook.
• SDK do Parceiro de Métricas para Aplicativos (MMP, pelas iniciais em inglês): adicione um código ao seu app Android ou iOS e envie dados ao painel do Adjust.

SDK do Facebook

Quando você usa o SDK do FB para enviar dados do usuário de eventos do app ao Facebook, todos os dados do usuário serão convertidos em hash. Esses dados com hash permanecerão entre uma instância de app e outra.

Requisitos

• SDK do Facebook 4.36 ou versões posteriores

Android

Defina os dados do usuário durante a inicialização de AppEventsLogger com a função setUserData. Essa função converterá os dados do usuário em hash.

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

Defina os dados do usuário durante a inicialização de FBSDKAppEvents com a função setUserData. Os dados do usuário serão convertidos em hash e permanecerão entre uma instância de app e outra.

Recomendações

• Para garantir o funcionamento adequado da correspondência avançada, recomendamos que você faça a atualização para a versão mais recente do SDK do Facebook para iOS. Consulte o registro de alterações do SDK do iOS para obter mais informações.

Exemplo de código para a definição de um tipo de dado

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

Exemplo de código para a definição de múltiplos tipos de dados

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

Gerenciador de Eventos

A correspondência avançada automática configura o SDK do Facebook para detectar e receber os dado do usuário, bem como os eventos ou as ações realizadas no seu app. Os dados são convertidos em hash antes de serem enviados ao Facebook.

Para ativar a correspondência avançada automática, acesse o Gerenciador de Eventos, selecione a aba Configurações do seu app e defina Correspondência avançada automática como ATIVADA. Também é possível compartilhar endereços de email e números de telefone com hash.

Para fazer isso, é necessário ter o SDK do Facebook 5.8.0 ou versões posteriores.

SDK do Adjust

Adicionar dados de clientes para eventos do Adjust

Ao optar pelo SDK do Parceiro de Métricas para Aplicativos (MMP) do Adjust, use a função hash conforme o exemplo abaixo, já que o SDK do MMP não aplicará hashes automaticamente. Se você não usar uma função hash, a API lançará uma exceção e não aceitará texto simples.

Adicione os parâmetros de dados do cliente a serem transmitidos aos parceiros de rede que foram ativados no painel do Adjust ao chamar o método addPartnerParameter na instância ADJEvent.

Não é necessário implementar o SDK do Facebook para fazer isso.

Exemplo de código do Android

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

Exemplo de código do iOS

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

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

[Adjust trackEvent:event];

Para mais informações, consulte os exemplos de código do GitHub.

Mapear parâmetros do Adjust para o Facebook

Siga as etapas a seguir para mapear o parâmetro do Adjust para o do Facebook.

1. No painel do Adjust, clique em Settings do app em que você quer mapear os parâmetros do parceiro.
2. Selecione Partner Setup.
3. Clique no parceiro em questão.
4. Selecione Partner Parameter Mapping.
5. Insira os nomes dos parâmetros do parceiro conforme enviados ao Adjust pelo SDK na coluna FROM APP no lado esquerdo. Eles devem ser os mesmos para todos os parceiros. Por exemplo, se você usar email como o nome do parâmetro no SDK do Adjust, insira "email".
6. Insira os nomes dos parâmetros conforme desejado pelo parceiro na coluna TO PARTNER no lado direito. Esse campo é específico ao parceiro. O parâmetro usado no SDK do Facebook deve estar em formato de ud[pii_type_name]. Por exemplo, "email" deve usar ud[em], e smartphone deve usar ud[ph].

Para saber mais, consulte a documentação do Adjust.