Visão geral: Importe segmentos de audiências de seus sistemas internos (como BI e CRM) para o Audiences. Assim, você pode usar o Audiences para conectar e manter esses segmentos com seus parceiros de publicidade.
Por que você deve importar suas audiências?
É possível que você já tenha segmentos de audiência predefinidos em seus sistemas internos. Importar essas audiências (como listas de identificadores de dispositivos e/ou usuários) para a AppsFlyer permite que você use o Audiences como ponto central para conectar todos os seus segmentos de audiências com seus parceiros de publicidade. Além disso, você pode aproveitar outras funcionalidades do Audiences, como a correspondência de identificadores/enriquecimento de dados e métricas de campanha conectada.
Veja os exemplos abaixo:
Exemplos
Remarketing promocional
Você quer direcionar ofertas promocionais para os seus usuários durante o mês dos seus aniversários.
Você pode fazer isso usando o Audiences:
- Use o seu CRM interno para gerar uma lista de usuários com seus respectivos aniversários.
- Segmente a lista de acordo com o mês de aniversário e exporte-a através de listas individuais de IDs de publicidade.
- Importe essas listas para a AppsFlyer na forma de audiências e conecte-as aos parceiros com os quais você deseja executar essas campanhas promocionais.
- Configure as campanhas com os parceiros relevantes para atingir os públicos-alvo desejados.
Aquisição de usuários adicionais
O seu studio de desenvolvimento de aplicativos adquire outro studio. O novo studio tem os device IDs de usuários que instalaram anteriormente os seus aplicativos, e você quer direcionar esses usuários para a instalação dos seus aplicativos existentes.
Você pode fazer isso usando o Audiences:
- Obtenha a lista de device IDs e importe-a como uma audiência para a AppsFlyer.
- Conecte a audiência aos parceiros com os quais você deseja executar campanhas.
- Configure as campanhas com os parceiros relevantes para atingir os usuários desejados.
Audiences import V2.0
Vamos falar sobre os conceitos e procedimentos necessários para o novo recurso de importação V2.0 do Audiences (com opções de importação por CSV e API).
Tipos de audiências
Ao importar uma audiência, você deve definir o seu tipo, pois isso determina como a AppsFlyer fará o processamento e o upload dessa audiência para seus parceiros. Você define o tipo de audiência quando assim que ela é importada pela primeira vez. Isso não pode ser alterado posteriormente.
Audiência padrão:
- Passa por correspondência de identificadores e enriquecimento de dados — um processo no qual o Audiences faz a correspondência dos identificadores importados com os identificadores existentes na base de dados do Audiences (para o mesmo usuário no mesmo app), enriquecendo os dados da audiência para os parceiros.
- Seu upload é feito para os parceiros sujeitos à política de identificadores de usuário da sua conta.
- Deve ser importada utilizando a funcionalidade de importação V2.0 descrita neste artigo.
Uma audiência importada "sem alterações”:
- Não passa pela correspondência de identificadores e enriquecimento de dados.
- Seu upload é feito para parceiros sem recorrer à política de identificadores de usuário da sua conta (o que significa que todos os identificadores importados são enviados para os parceiros).
- Pode ser importada utilizando a funcionalidade de importação V2.0 (descrita neste artigo).
Importante!
- Todas as audiências a partir de 23 de novembro de 2021 são designadas como audiências sem alterações e não podem ser definidas como audiências padrão. Você pode continuar atualizando essas audiências conforme necessário utilizando a funcionalidade de importação V2.0 (descrita neste artigo).
- Você pode ter até 500 audiências importadas ativas de uma só vez.
- Apenas um administrador pode designar uma nova audiência importada como uma audiência sem alterações.
- Ao criar uma audiência que possui um CUID como identificador, a associação de CUID deve ser recebida pela AppsFlyer na instalação (e não apenas em eventos pós-instalação), garantindo a associação completa com os dispositivos relevantes e um enriquecimento eficaz com os identificadores de dispositivos (como GAID, IDFA, etc.). Saiba mais
Procedimentos de importação de audiências
Importe uma audiência através do upload de um arquivo CSV ou utilizando a Import Audience API.
Importar um arquivo CSV
Prepare um arquivo CSV, com as seguintes especificações:
Formato
- Uma coluna para cada identificador de usuário que está sendo importado
- Uma linha de cabeçalho com o nome do identificador em cada coluna (em letras minúsculas)
- Sem linhas em branco
- Número máximo de linhas: 10 milhões
- Se você preparar o arquivo utilizando o Excel, salve-o como um arquivo CSV (delimitado por vírgulas) (*.csv), como mostra a imagem abaixo:
identificador anônimo
Colunas e identificadores
- Os dados são ingeridos utilizando a linha de cabeçalho para identificar os dados em cada coluna, portanto:
- Não é necessário que as colunas apareçam em uma ordem específica.
- Não é necessário incluir colunas para identificadores que não estão sendo importados.
- Você pode importar quantos identificadores quiser em um único arquivo CSV, desde que cada linha inclua os identificadores necessários, como explicamos abaixo.
- Identificadores disponíveis:
- app_id
- idfv
- idfa
- gaid
- oaid
- imei
- CUID
- e-mails
- celular
- phone_e164
- braze_id
- amplitude_id
- Identificadores necessários:
- Para audiências do Android: app_id + uma de: gaid OU oiad OU imei OU cuid OU braze_id OU amplitude_id
- Para audiências do iOS: app_id + um de: idfv OU cuid OU braze_id OU amplitude_id
- Em compliance com a aplicação do Digital Markets Act (DMA) pelo Google em 6 de março de 2024, ao importar uma audiência "sem alterações", duas colunas adicionais de consentimento da AppsFlyer precisarão ser adicionadas. Veja abaixo:
| Colunas de consentimento da AppsFlyer | Campo do Google | Valores | Campo explicado |
|---|---|---|---|
| ad_personalization_enabled | ad_personalization | true/false | O usuário permitiu que o Google use seus dados para receber anúncios personalizados? |
| ad_user_data_enabled | ad_user_data | true/false | O usuário permitiu o compartilhamento de seus dados com o Google? |
Se os campos de consentimento não forem preenchidos, eles serão enviados ao Google como "não especificados" e provavelmente não serão incluídos na audiência do lado do Google. O preenchimento desses campos garante a inclusão máxima de usuários do Espaço Econômico Europeu (EEE) em suas audiências do Google.
Exemplo de arquivos CSV:
new-import-android-example.csv
new-import-ios-example.csv
Para criar e importar uma nova audiência utilizando um arquivo CSV:
- No painek esquerdo da AppsFlyer, acesse engajamento>Audiences.
- Clique em nova audiência.
- Selecione importar audiência.
A janela importar audiência se abre. - Insira um nome de audiência exclusivo.
- Selecione a plataforma da audiência: Android ou iOS.
- Indique se essa audiência é uma audiência padrão ou uma audiência sem alterações.
- Para a audiência padrão, deixe a caixa desmarcada.
- Para uma audiência sem alterações, assinale a caixa. (Observação: Essa opção está disponível apenas para administradores).
- Clique em salvar público e continuar.
A aba importar é exibida. - Em importar usando CSV, mantenha a predefinição de adicionar novos dispositivos/usuários (uma vez que se trata de uma nova audiência).
- Selecione o arquivo CSV para upload.
Aguarde pela mensagem de confirmação upload feito com sucesso. - Clique em próximo.
A aba conectar é exibida. - (Opcional) Siga as instruções para conectar uma audiência aos seus parceiros.
- Clique em concluído.
A sua audiência agora está visível no dashboard do Audieneces e foi importada e conectada aos seus parceiros. É importante observar, no entanto, que a lista de audiências recém-importada ainda não está disponível para upload para os parceiros, pois as audiências importadas são processadas com uma atualização de dados diária.
Para atualizar uma audiência existente usando um arquivo CSV:
- No painek esquerdo da AppsFlyer, acesse engajamento>Audiences.
- Clique no nome da audiência que você deseja atualizar.
A tela editar audiência é aberta, exibindo a aba definir. - Se você quiser editar o nome da audiência, você pode fazê-lo agora. Caso contrário, selecione a aba importar para fazer o upload do novo arquivo CSV.
- Em importar usando CSV, escolha o que fazer com a lista importada:
- Adicione novos dispositivos/usuários: Adicione identificadores de dispositivo/usuários à audiência existente
- Remova dispositivos da lista de audiência existente: Remova identificadores de dispositivo/usuário da audiência na lista importada
- Substitua a audiência existente por novos dispositivos/usuários: Substitua toda a audiência pela lista importada
- Selecione o arquivo CSV para upload.
Aguarde pela mensagem de confirmação upload feito com sucesso. - Clique em próximo.
A aba conectar é exibida. - Faça alterações às conexões de parceiros para essa audiência, se necessário.
- Clique em concluído.
A sua audiência foi atualizada usando o arquivo CSV. É importante observar, no entanto, que a lista de audiências revisada ainda não está disponível para upload para os parceiros, pois as audiências importadas são processadas com uma atualização de dados diária.
Mensagens de confirmação
| Mensagem | Causa | O que fazer |
|---|---|---|
| Upload feito com sucesso | ||
| Há um problema com a lista de dispositivos | Um ou vários problemas com a lista de dispositivos | Verifique se o arquivo CSV:
|
| Parece que a sua lista de dispositivos está vazia. Adicione alguns device IDs e tente novamente. | O arquivo CSV está vazio |
Certifique-se de que o CSV contém pelo menos um device ID. |
| Não conseguimos entender um ou mais dos seus device IDs. |
|
|
| Não é possível usar a importação v1 ao aplicar sua política de conta à audiência. | Você fez o upload de um arquivo CSV para uma audiência padrão utilizando a estrutura de importação V1.0. As audiências padrão devem ser importadas utilizando um CSV na estrutura V2.0. | Edite o arquivo CSV e use o formato, colunas e os identificadores descritos acima. |
| Tivemos um problema de conexão temporária e não foi possível carregar seu arquivo. Você pode tentar novamente agora. | Possível erro de rede | Tente carregar novamente o arquivo CSV. |
Usando a Import Audience API
A Import Audience API é usada para adicionar ou remover dispositivos de uma audiência.
Para importar uma nova audiência usando a API:
- No painek esquerdo da AppsFlyer, acesse engajamento>Audiences.
- Clique em nova audiência.
- Selecione importar audiência.
A janela importar audiência se abre. - Insira um nome de audiência exclusivo.
- Selecione a plataforma da audiência: Android ou iOS.
- Indique se essa audiência é uma audiência padrão ou uma audiência sem alterações.
- Para uma audiência padrão, deixe a caixa desmarcada.
- Para uma audiência sem alterações, assinale a caixa (obs: essa opção só está disponível para administradores). São necessários dois campos de consentimento adicionais ao importar uma audiência “sem alterações”, de acordo com a aplicação do Digital Markets Act (DMA) pelo Google a 6 de março de 2024. O preenchimento desses campos garante a inclusão máxima de usuários do Espaço Econômico Europeu (EEE) em suas audiências do Google.
- Clique em Salvar.
A página importar é exibida - Em importar utilizando a API, mantenha a predefinição de adicionar novos dispositivos/usuários (uma vez que se trata de uma nova audiência).
- Copie a URL de solicitação da API da página importar uma nova audiência da API (o token da API já está incluído).
- Em seguida, copie e cole o corpo de solicitação.
- Clique em concluído.
A aba conectar é exibida. - (Opcional) Siga as instruções para conectar uma audiência aos seus parceiros.
- Clique em concluído.
- Prepare a solicitação da API incluindo os identificadores de usuário/dispositivo e envie-o para a AppsFlyer.
Para atualizar uma audiência existente usando a API:
- No painek esquerdo da AppsFlyer, acesse engajamento>Audiences.
- Clique no nome da audiência que você deseja atualizar.
A tela editar audiência é aberta, exibindo a aba definir. - Se você quiser editar o nome da audiência, você pode fazê-lo agora. Caso contrário, selecione a aba importar.
- Em importar usando a API, escolha o que fazer com a lista carregada:
- Adicione novos dispositivos/ usuários: Adicione identificadores de dispositivo/usuários à audiência existente.
- Remova dispositivos/usuários da audiência existente: Remova os identificadores de dispositivo/usuário da audiência existente.
- Copie a URL de solicitação da API da página importar uma nova audiência da API (o token da API já está incluído). Observação: A alteração dessa opção altera o caminho do endpoint no código a ser copiado. Certifique-se de usar o endpoint correto para a ação que você está realizando (nessa e em futuras solicitações da API).
- Em seguida, copie o corpo de solicitação da API.
- Clique em próximo.
A aba conectar é exibida. - Faça alterações às conexões de parceiros para essa audiência, se necessário.
- Clique em concluído.
- Prepare a solicitação da API incluindo os identificadores de usuário/dispositivo e envie-o para a AppsFlyer.
Códigos de resposta
| Código | Mensagem | Descrição |
|---|---|---|
|
200 |
A solicitação foi bem-sucedida |
Audiência importada com sucesso |
| 400 | Plataforma de audiências inválida, essa audiência já está configurada para Android/iOS. Para usar uma plataforma diferente, crie uma nova audiência na interface do usuário | A plataforma especificada no corpo da solicitação não corresponde à plataforma especificada durante a criação do público |
| 400 | X ou mais das suas linhas não contêm um app ID. É necessário anexar um app ID a cada linha. |
Cada linha deve conter um app_id
|
| 400 | X ou mais das suas linhas não contêm um identificador único válido |
Todas ou algumas linhas não contêm pelo menos um dos seguintes identificadores num formato válido:
|
| 400 | Não é possível processar mais de Y dispositivos por solicitação (n dispositivos contados nessa solicitação) |
O corpo da solicitação contém uma lista de mais de 10.000 device IDs |
| 400 | A lista de dispositivos não pode estar vazia |
O corpo da solicitação contém uma lista vazia de dispositivos É necessário fornecer pelo menos um device ID por solicitação |
| 400 | Não conseguimos entender um ou mais dos seus device IDs. | Todos ou alguns device IDs não estão em um formato válido |
|
400 |
X ou mais dos dispositivos que devem ser removidos contêm mais do que um identificador por dispositivo |
Uma solicitação de remoção foi enviada com mais do que um identificador por dispositivo |
| 403 | Proibido | Solicitação não autorizada: Chave de importação incorreta ou em falta |
| 429 | Muitas solicitações | Há um limite de 350 solicitações por minuto |
| 500 | Não foi possível processar a solicitação |
Formato inválido do corpo da solicitação (não é a estrutura JSON esperada ou não é um JSON) Veja o exemplo de solicitação acima |
Limitações da API.
- Só é possível adicionar dispositivos a uma audiência por solicitação.
- Só é possível remover dispositivos de uma audiência por solicitação.
- Você pode enviar até 10.000 device IDs por solicitação.
- Você pode enviar até 350 solicitações por minuto.
Imported Audience Management API
A Imported Audience Management API permite que os anunciantes criem, configurem, façam o upload e conectem audiências importadas a parceiros, e muito mais.