How can we help?

Audiências – Configure identificadores adicionais para a criação de audiências de parceiros

  • Atualizado

Visão geral: Configure identificadores de utilizador adicionais para enviar audiências personalizadas aos seus parceiros de publicidade.

Sobre os identificadores adicionais

O AppsFlyer Audiences suporta automaticamente os seguintes identificadores de dispositivos para envio de audiências personalizadas a parceiros de publicidade:

  • iOS: IDFA
  • Android (Google Play): GAID
  • Android (lojas de aplicações de terceiros): OAID e IMEI

Alguns parceiros de publicidade também permitem a correspondência de audiências personalizadas com base em identificadores de utilizador adicionais. O Audiences oferece-lhe a opção de utilizar estes identificadores, se forem configurados especificamente através do SDK da AppsFlyer ou da API S2S-mobile.

Estes identificadores adicionais podem incluir números de telefone e e-mails, sendo que só podem ser usados se encriptados com hash SHA256.  A utilização desses identificadores adicionais está sujeita aos Termos de Utilização de Identificadores Adicionais.

Próximos passos

  1. Selecione os identificadores adicionais que deseja usar (se houver) a partir da tabela de identificadores disponíveis. Tenha em atenção que nem todos os parceiros de publicidade suportam todas as opções de identificadores.
  2. ProgramadoresConfigure os identificadores selecionados, utilizando:
  3. No painel de Audiências:

Identificadores disponíveis

Pode optar por configurar um ou mais identificadores, listados na tabela abaixo.

Identificadores adicionaisparâmetros e formatação

Identificador Nome do parâmetro Formato Valor de exemplo (antes da aplicação de hash)
Endereço de email email_sha256

SDK v7.0.0 e anteriores:

  • Minúscula
  • Sem espaços
  • Aplicar hash no cliente (SHA256) antes de enviar

SDK v7.0.1 e posteriores: Texto simples. O SDK normaliza e aplica hash automaticamente.

name@domain.com
Número de telefone
(ver nota abaixo)

v7.0.0 e anteriores (ou S2S): phone_number_sha256

v7.0.1 e posteriores: phone_number_hashed

v7.0.0 e anteriores (ou S2S):

  • Sem símbolos, letras ou zeros iniciais
  • Inclua o código do país
  • Com hash SHA256

v7.0.1 e posteriores: Texto simples. O SDK concatena o código do país e o número, normaliza e aplica hash automaticamente.

442070313000

Número de telefone E164

(ver nota abaixo)

v7.0.0 e anteriores (ou S2S): phone_number_e164_sha256

v7.0.1 e posteriores: phone_number_e164_hashed

v7.0.0 e anteriores (ou S2S):

  • Número de telefone E164
  • Com hash SHA256

v7.0.1 e posteriores: Texto simples. O SDK concatena o código do país e o número, normaliza e aplica hash automaticamente.

+442070313000

 Nota 

Diferentes parceiros de publicidade aceitam diferentes formatos de número de telefone. Portanto, se optar por usar o número de telefone, configure ambos os identificadores: Número de telefone e Número de telefone E164.

Referência do SDK e exemplos de código

Ao enviar identificadores para Públicos através do SDK:

  • Para identificadores que não sejam Endereço de e-mail com hash, utilize
  • Para Endereço de e-mail com hash, use
    • SDK v7.0.1 e posteriores: use setUserEmail.
    • SDK v7.0.0 e anteriores: use setUserEmails.
  • Com hash SHA256
    • SDK v7.0.1 e posteriores: use setUserPhone (recomendado).
    • SDK v7.0.0 e anteriores: use setAdditionalData com dados personalizados.

 Nota

Lembre-se das seguintes mudanças dependentes da versão:

  • E-mail: A partir do SDK v7.0.1, setUserEmails (iOS/Android) foi totalmente removido e substituído por setUserEmail. Esta é uma mudança incompatível, não uma descontinuação. Apps na v7.0.0 e anteriores devem continuar a usar setUserEmails. Apps na v7.0.1 e posteriores devem mudar para setUserEmail. Verifique a versão integrada do SDK antes de escolher qual exemplo seguir.
  • Telefone: A partir do SDK v7.0.1, está disponível uma API dedicada setUserPhone. Esta é a forma recomendada de enviar identificadores de números de telefone para Advanced Matching. Esta não é uma mudança incompatível: setAdditionalData ainda funciona. Para novas integrações e para clientes que atualizarem para v7.0.1 e posterior, recomendamos migrar para setUserPhone. Aplicativos na v7.0.0 e versões anteriores devem continuar usando setAdditionalData, porque setUserPhone não existe nessas versões do SDK.

Configuração do SDK para iOS

Para definir o Número de telefone com hash como um identificador de utilizador adicional:

SDK v7.0.0 and earlier — setAdditionalData

Objective-C Swift
NSDictionary *customData = @{
  @"audiences": @{
    @"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
    @"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
  }
};
[[AppsFlyerLib shared] setAdditionalData:customData];

Atenção

Você deve aplicar hash previamente aos dois valores (SHA-256) antes de passá-los.

SDK v7.0.1 and later — setUserPhone (recomendado)

Audiências — identificadores adicionais
- (void)setUserPhone:(NSString *_Nonnull)countryCode
phoneNumber:(NSString *_Nonnull)phoneNumber;
Exemplo de utilização
Objective-C Swift
[[AppsFlyerLib shared] setUserPhone:@"1" phoneNumber:@"(650) 555-1212"];

Atenção

Passe o código de discagem do país e o número local como texto simples. Símbolos e espaços são permitidos no número local. O SDK concatena, normaliza e aplica hash aos dois valores localmente (SHA-256). Não aplique hash previamente.

Para definir um Endereço de e-mail com hash como um identificador de utilizador adicional:

SDK v7.0.0 and earlier

Assinatura de método
- (void)setUserEmails:(NSArray<NSString *> *_Nullable)userEmails 
withCryptType:(EmailCryptType)type;
Exemplo de utilização
Objective-C Swift
NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType:EmailCryptTypeSHA256];

SDK v7.0.1 and later

Assinatura de método
- (void)setUserEmail:(NSString *_Nonnull)email;
Exemplo de utilização
Objective-C Swift
[[AppsFlyerLib shared] setUserEmail:@"name@domain.com"];

Atenção

Passe o e-mail em texto simples. O SDK o normaliza e faz o hashing localmente (SHA-256). Não aplique hash previamente. Apenas um único e-mail é aceito por chamada: chamar setUserEmail novamente substitui o valor definido anteriormente em vez de adicioná-lo.

Configuração do SDK para Android

Para definir o Número de telefone com hash como um identificador de utilizador adicional:

SDK v7.0.0 e anteriores — setAdditionalData

Java Kotlin
HashMap<String, Object> audiences = new HashMap<>();
audiences.put("phone_number_sha256", "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37");
audiences.put("phone_number_e164_sha256", "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E");
HashMap<String, Object> customDataMap = new HashMap<>();
customDataMap.put("audiences", audiences);
AppsFlyerLib.getInstance().setAdditionalData(customDataMap);

Nota

Você deve aplicar hash previamente aos dois valores (SHA-256) antes de passá-los.

SDK v7.0.1 e posteriores — setUserPhone (recomendado)

Audiências — identificadores adicionais
public abstract void setUserPhone(String countryCode, String phoneNumber);
Exemplo de utilização
JavaKotlin
AppsFlyerLib.getInstance().setUserPhone("1", "(650) 555-1212");

Atenção

Passe o código de discagem do país e o número local como texto simples. O SDK concatena, normaliza e aplica hash aos dois valores localmente (SHA-256). Não aplique hash previamente.

Para definir um Endereço de e-mail com hash como um identificador de utilizador adicional:

SDK v7.0.0 e anteriores

Todas as letras em minúscula
public abstract void setUserEmails(
  AppsFlyerProperties. EmailsCryptType cryptMethod,
  String... emails
);
Exemplo de utilização
JavaKotlin
AppsFlyerLib.getInstance().setUserEmails(
  AppsFlyerProperties.EmailsCryptType.SHA256,
  "name@domain.com",
  "another_name@another_domain.com"
);

SDK v7.0.1 e posterior

Audiências — identificadores adicionais
public abstract void setUserEmail(String email);
Exemplo de utilização
AppsFlyerLib.getInstance().setUserEmail("name@domain.com");

numero_telefone_sha256

Apenas um único e-mail é aceito por chamada na v7.0.1 e posterior. Não há suporte para vários e-mails: chamar setUserEmail novamente substitui o valor definido anteriormente, em vez de adicioná-lo.

Referência S2S e exemplos de código

Ao enviar identificadores para públicos-alvo por S2S, utilize o parâmetro para todos os identificadores (inclusive Endereço de e-mail com hash). Pode enviar um ou mais identificadores.

Envio de identificadores através de S2S

Formato:

  • JSON aninhado
  • O valor da chave deve ser audiences
  • Todos os valores devem ser convertidos para string conforme mostrado no exemplo de código a seguir
  • Os nomes dos parâmetros devem coincidir com os listados na tabela de identificadores disponíveis acima

Formato geral:

"custom_data" : { 
\"audiences\" : { \"parameter_name_a\" : \"hashed_identifer_a\", \"parameter_name_a\" : \"hashed_identifer_b\", \"parameter_name_c\" : \"hashed_identifer_c\" } }

Exemplo preenchido para Número de telefone e Endereço de e-mail com hash:

"custom_data" : {
\"audiences\" : { \"phone_number_sha256\" : \"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37\", \"phone_number_e164_sha256\" : \"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E\", \"email_sha256\" : \"34D31BE18022626DE6B311D6A76E791176D2691B6EEF406F524D8F56364C187A\" } }

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: