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
- 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.
- Programadores—Configure os identificadores selecionados, utilizando:
- Os parâmetros e requisitos de formatação apresentados na tabela de identificadores disponíveis
- As referências e amostras de código para SDK e S2S
- No painel de Audiências:
- Defina a sua política de identificadores de utilizador a nível da conta
- Selecione os identificadores a serem carregados em cada uma das suas conexões de parceiros
Identificadores disponíveis
Pode optar por configurar um ou mais identificadores, listados na tabela abaixo.
Identificadores adicionais—parâ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:
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):
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):
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 |
NotaDiferentes 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.
- SDK v7.0.1 e posteriores: use
- Com hash SHA256
- SDK v7.0.1 e posteriores: use
setUserPhone(recomendado). - SDK v7.0.0 e anteriores: use
setAdditionalDatacom dados personalizados.
- SDK v7.0.1 e posteriores: use
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 porsetUserEmail. Esta é uma mudança incompatível, não uma descontinuação. Apps na v7.0.0 e anteriores devem continuar a usarsetUserEmails. Apps na v7.0.1 e posteriores devem mudar parasetUserEmail. 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:setAdditionalDataainda funciona. Para novas integrações e para clientes que atualizarem para v7.0.1 e posterior, recomendamos migrar parasetUserPhone. Aplicativos na v7.0.0 e versões anteriores devem continuar usandosetAdditionalData, porquesetUserPhonenã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
NSDictionary *customData = @{
@"audiences": @{
@"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
@"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
}
};
[[AppsFlyerLib shared] setAdditionalData:customData];numero_telefone_e164_sha256Atençã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 | |
| Exemplo de utilização | |
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 | |
| Exemplo de utilização | |
SDK v7.0.1 and later
| Assinatura de método | |
| Exemplo de utilização | |
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
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);
val audiences = hashMapOf<String, Any>(
"phone_number_sha256" to "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
"phone_number_e164_sha256" to "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
)
val customDataMap = hashMapOf<String, Any>("audiences" to 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 | |
| Exemplo de utilização | |
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 | |
| Exemplo de utilização | |
SDK v7.0.1 e posterior
| Audiências — identificadores adicionais | |
| Exemplo de utilização | |
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\"
}
}
Consulte também
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.