Segmentos de público — importar um público-alvo

Premium

Visão geral: Importe segmentos de público pré-definidos dos seus sistemas internos (como BI e CRM) para o AppsFlyer Audiences, o que lhe permite ligar e manter esses segmentos com os seus parceiros de publicidade.

Por que importar públicos?

Em certas situações, pode possuir segmentos de público pré-definidos nos seus sistemas internos. Ao importar estes públicos (como listas de IDs de dispositivos e/ou utilizadores) para o AppsFlyer, pode utilizar o Audiences como o ponto central para ligar e gerir todos os seus segmentos de público com os seus parceiros publicitários. Além disso, possibilita a plena utilização de outras funcionalidades do Audiences, como a correspondência de identificadores/enriquecimento de dados e métricas de campanhas ligadas.

Considere os exemplos seguintes:

 Exemplos

Remarketing Promocional
Deseja enviar ofertas promocionais para os utilizadores no mês dos seus aniversários.

Veja como fazer isso com o Audiences:

  1. Use o seu CRM interno para criar uma lista de utilizadores com as suas datas de aniversário.
  2. Divida a lista de acordo com o mês de aniversário e exporte-a como listas individuais de IDs de publicidade.
  3. Importe as listas para o AppsFlyer como públicos e conecte-os aos parceiros para as campanhas promocionais que pretende realizar.
  4. Configure campanhas com os parceiros adequados para direcionar corretamente os públicos.

Aquisição de Novos Utilizadores
O seu estúdio de desenvolvimento de aplicações adquire outro. O estúdio que adquiriu tem os IDs dos dispositivos dos utilizadores que instalaram apps anteriormente, e pretende motivar estes utilizadores a instalarem as suas apps atuais.

Veja como fazer isso com o Audiences:

  1. Obtenha a lista de IDs de dispositivos do estúdio adquirido e importe-a para o AppsFlyer como um público.
  2. Ligue o público importado aos parceiros com os quais pretende conduzir campanhas.
  3. Configure campanhas com os parceiros relevantes para alcançar esses utilizadores de forma adequada.

Importação de Públicos V2.0

Este artigo descreve conceitos e procedimentos relacionados com a nova funcionalidade de importação de Audiences V2.0, que inclui opções para importação por CSV e API. 

Tipos de público importados

Quando importar um público, deverá designá-lo como um de dois tipos, o que determina como a AppsFlyer processa e envia o público carregado para os parceiros. A designação é feita aquando da primeira importação de um público e não pode ser alterada posteriormente.

Um público importado padrão:

  • Passa por correspondência de identificadores e enriquecimento de dadosum processo em que o Audiences combina os identificadores importados com os existentes na base de dados (para o mesmo utilizador na mesma aplicação) para enriquecer os dados enviados aos parceiros.
  • É carregado para parceiros conforme a política de identificadores de utilizador da sua conta.
  • Deve ser importado utilizando a funcionalidade de importação V2.0 descrita neste artigo.

Um público importado "como está":

  • Não passa por correspondência de identificadores e enriquecimento de dados.
  • É enviado para os parceiros sem obedecer à política de identificadores de utilizador da sua conta (ou seja, todos os identificadores importados são enviados para os parceiros).
  • Pode ser importado utilizando a funcionalidade de importação V2.0 (descrita neste artigo).

Importante!

  • Todos os públicos existentes a partir de 23 de novembro de 2021, são designados como públicos "como estão" e não podem ser alterados para públicos padrão. Pode continuar a atualizar esses públicos conforme necessário, utilizando a funcionalidade de importação V2.0 (descrita neste artigo).
  • Pode ter até 500 públicos importados ativos simultaneamente.
  • Apenas um administrador pode designar um novo público importado como "como está".
  • Ao importar um público com CUID como identificador, a associação CUID deve ter sido recebida pela AppsFlyer na instalação (não apenas em eventos pós-instalação) para garantir uma associação completa com os dispositivos relevantes e um enriquecimento bem sucedido com identificadores de dispositivo (GAID, IDFA). Saber mais

Procedimentos para importação de público

Importe um público, carregando um ficheiro CSV ou usando a API Import Audience.

Importar um ficheiro CSV

Prepare um ficheiro CSV com as seguintes especificações:

Formato

  • Uma coluna para cada identificador de utilizador a ser carregado
  • Uma linha de cabeçalho com o nome do identificador em cada coluna (todas as letras minúsculas)
  • Sem linhas em branco
  • Número máximo de linhas: 10 milhões
  • Se preparar o ficheiro no Excel, guarde-o como CSV (delimitado por vírgula) (*.csv), conforme ilustrado na imagem a seguir:

    CSV.jpg

Colunas e identificadores

  • Os dados são processados usando a linha de cabeçalho para identificar os dados em cada coluna, portanto:
    • Não é necessário que as colunas apareçam numa ordem específica.
    • Não é obrigatório incluir colunas para identificadores que não estão a ser carregados.
    • Pode importar tantos identificadores quanto desejar num único ficheiro CSV, desde que cada linha inclua os identificadores obrigatórios, conforme detalhado abaixo.
  • Identificadores disponíveis:
    • app_id
    • idfv
    • idfa
    • gaid
    • oaid
    • imei
    • cuid
    • emails
    • telefone
    • telefone_e164
    • braze_id
    • amplitude_id
  • Identificadores obrigatórios:
    • Para audiências Android: app_id + um dos seguintes: gaid, oaid, imei, cuid, braze_id ou amplitude_id
    • Para audiências iOS: app_id + um dos seguintes: idfv, cuid, braze_id ou amplitude_id
  • Em conformidade com a imposição do Digital Markets Act (DMA) da Google a partir de 6 de março de 2024, ao importar uma audiência "como está", será necessário adicionar duas colunas adicionais de consentimento da AppsFlyer. São elas:
Colunas de consentimento da AppsFlyer  Campo do Google  Valores Explicação do campo
ad_personalization_enabled personalização_de_anúncio verdadeiro/falso O utilizador deu consentimento à Google para utilizar os seus dados em publicidade personalizada?
ad_user_data_enabled dados_do_utilizador_do_anúncio verdadeiro/falso O utilizador deu consentimento para enviar os seus dados de utilizador à Google? 

Se os campos de consentimento não forem preenchidos com valores, serão enviados para a Google como "Não especificado" e provavelmente não serão incluídos na audiência do lado da Google. Preencher estes campos garante a máxima inclusão de utilizadores do Espaço Económico Europeu (EEE) nas suas audiências do Google.

Exemplos de ficheiros CSV:

new-import-android-example.csv
new-import-ios-example.csv

Para criar e importar uma nova audiência utilizando um ficheiro CSV:

  1. No painel esquerdo da AppsFlyer, vá até Engage > Públicos.
  2. Clique em Novo público.
  3. Escolha Importar público.
    A janela Importar público será aberta.
  4. Insira um Nome de Público exclusivo.
  5. Selecione a plataforma do público: Android ou iOS.
  6. Indique se este público é um público padrão ou como está .
  7. Para um público padrão, mantenha a caixa desmarcada.
  8. Para um público no estado atual, marque a caixa. (Nota: Apenas disponível para administradores.)
  9. Clique em Guardar público e prossiga.
    O separador Importar é mostrado.
  10. Na secção Importar utilizando CSV, mantenha a opção padrão de Adicionar novos dispositivos/utilizadores (já que se trata de um novo público).
  11. Escolha o ficheiro CSV para carregar.
    Aguarde a mensagem de confirmação Carregado com sucesso.
  12. Clique em Seguinte.
    O separador Conectar é exibido.
  13. (Opcional) Siga as instruções para ligar um público a parceiros.
  14. Clique em Concluir.

O seu público já aparece no painel de Públicos, e já foi importado e ligado a parceiros. Note, no entanto, que a lista de público recém-importada ainda não está disponível para envio a parceiros, pois os públicos importados são processados com atualizações diárias de dados.

Para atualizar um público existente usando um ficheiro CSV:

  1. No painel esquerdo da AppsFlyer, vá até Engage > Públicos.
  2. Clique no nome do público que deseja atualizar.
    Aparece o ecrã Editar público, com o separador Definir.
  3. Se pretender alterar o nome do público, poderá fazê-lo aqui. Caso contrário, selecione o separador Importar para carregar o novo ficheiro CSV.
  4. Na secção Importar utilizando CSV, escolha a ação a realizar com a lista carregada:
  5. Adicionar novos dispositivos/utilizadores: Adicione identificadores de dispositivos/utilizadores ao público existente.
  6. Remover dispositivos/utilizadores do público existente: Remova os identificadores de dispositivos/utilizadores da lista carregada do público.
  7. Substituir o público existente por novos dispositivos/utilizadores: Substitua o público completo pela lista carregada.
  8. Escolha o ficheiro CSV para carregar.
    Aguarde a mensagem de confirmação Carregado com sucesso.
  9. Clique em Seguinte.
    O separador Conectar é exibido.
  10. Faça alterações nas ligações de parceiros para este público, se necessário.
  11. Clique em Concluir.

O seu público foi atualizado com o ficheiro CSV. No entanto, tenha em atenção que a lista de público-alvo revista ainda não foi carregada para os parceiros, pois os públicos importados são processados com uma atualização de dados diária.

Mensagens de erro

Mensagem Causa O que fazer
Existe um problema com a lista de dispositivos Um ou mais problemas com a lista de dispositivos Verifique se o ficheiro CSV:
  • está preenchido com dispositivos e identificadores GAID/IDFA no formato correto
  • contém os identificadores necessários
  • tem uma linha de cabeçalho com os cabeçalhos no formato correto
  • não possui linhas em branco
  • app_id está associado à aplicação correta que utiliza para os públicos
Parece que a sua lista de dispositivos está vazia. Adicione alguns IDs de dispositivos e tente novamente. O ficheiro CSV está vazio

Assegure-se de que o CSV contém pelo menos um ID de dispositivo.

Não conseguimos compreender um ou mais dos seus IDs de dispositivo.
  • O formato do CSV está incorreto
  • O ficheiro que carregou não é um ficheiro CSV
  • O ficheiro CSV foi editado e guardado por um programa que não é um editor CSV válido (por exemplo, Microsoft Excel)
  • Um ou mais IDs de dispositivos estão no formato errado
  • Assegure-se de que o CSV está no formato exigido.
  • Verifique se todos os IDs de dispositivos estão no formato correto.
  • Se tiver utilizado o Excel, guarde o ficheiro como um ficheiro CSV como descrito acima.
Não é possível usar a importação v1 ao aplicar a política de conta de utilizador ao público. Submeteu um ficheiro CSV para um público padrão utilizando a estrutura de importação V1.0. Os públicos padrão devem ser carregados usando um CSV na estrutura V2.0. Edite o ficheiro CSV que está a carregar para utilizar o formato, as colunas e os identificadores descritos acima.
Tivemos um problema temporário de ligação e não conseguimos carregar o seu ficheiro. Pode tentar novamente agora. Possível erro de rede Tente carregar novamente o ficheiro CSV.

Utilize a API de Importação de Público

A API de Importação de Público é usada para adicionar ou remover dispositivos de um público. 

Para importar um novo público utilizando a API:

  1. No painel esquerdo da AppsFlyer, vá até Engage > Públicos.
  2. Clique em Novo público.
  3. Escolha Importar público.
    A janela Importar público será aberta.
  4. Insira um Nome de Público exclusivo.
  5. Selecione a plataforma do público: Android ou iOS.
  6. Indique se este público é um público padrão ou como está .
    • Para um público padrão, mantenha a caixa desmarcada.
    • Para um público tal como está, marque a caixa (note que esta opção está disponível apenas para administradores). Dois campos adicionais de consentimento são necessários ao importar um público "tal como está", em conformidade com a aplicação da Lei dos Mercados Digitais (DMA) pela Google a partir de 6 de março de 2024. Preencher estes campos assegura a máxima inclusão de utilizadores do Espaço Económico Europeu (EEE) nos seus públicos do Google.
  7. Clique em Guardar.
    É apresentada a página Importar.
  8. Na secção Importar utilizando API, mantenha a opção padrão de Adicionar novos dispositivos/utilizadores (já que se trata de um novo público).
  9. Copie a URL de pedido da API da página Importar uma nova API de audiência (o token da API já está incluído).
  10. Depois, copie e cole o corpo do pedido da API.
  11. Clique em Concluído.
    O separador Conectar é exibido.
  12. (Opcional) Siga as instruções para ligar um público a parceiros.
  13. Clique em Concluir.
  14. Prepare o pedido da API incluindo os identificadores de utilizador/dispositivo e envie-o para a AppsFlyer. 

Para atualizar um público existente utilizando a API:

  1. No painel esquerdo da AppsFlyer, vá até Engage > Públicos.
  2. Clique no nome do público que deseja atualizar.
    Aparece o ecrã Editar público, com o separador Definir.
  3. Se pretender alterar o nome do público, poderá fazê-lo aqui. Caso contrário, selecione o separador Importar.
  4. Na secção Importar utilizando API, escolha o que fazer com a lista carregada:
  5. Adicionar novos dispositivos/utilizadores: Adicione identificadores de dispositivo/utilizador ao público existente.
  6. Remover dispositivos/utilizadores do público existente: Remova os identificadores de dispositivo/utilizador do público existente.
  7. Copie o URL de pedido da API da página Importar uma nova API de público (o token da API já está incluído). Nota: Alterar esta opção modifica o caminho do endpoint no código a ser copiado. Certifique-se de que está a usar o endpoint correto para a ação que está a realizar (nesta e em futuras solicitações de API).
  8. De seguida, copie o corpo do pedido da API.
  9. Clique em Seguinte.
    O separador Conectar é exibido.
  10. Faça alterações nas ligações de parceiros para este público, se necessário.
  11. Clique em Concluir.
  12. Prepare o pedido da API incluindo os identificadores de utilizador/dispositivo e envie-o para a AppsFlyer.

Nota: Ao importar através da API, a atualização do público levará 24 horas.

Códigos de resposta

Código Mensagem Descrição

200

A solicitação foi bem-sucedida

Público importado com sucesso

400 Plataforma de público-alvo inválida. Este público já está configurado para Android/iOS. Para usar uma plataforma diferente, crie um novo público na interface do utilizador. A plataforma especificada no corpo do pedido não corresponde à plataforma especificada ao criar o público.
400 X ou mais das suas linhas não contêm um ID de aplicação. É necessário anexar um ID de aplicação a cada linha.

Cada linha deve incluir um app_id.

  • Nota: o app_id não é necessário para um público tal como se encontra, quando importado utilizando a funcionalidade legada de importação da versão V1.0.
400 X ou mais das suas linhas não contêm um identificador único válido.

Algumas ou todas as linhas não contêm pelo menos um dos seguintes identificadores num formato válido:

  • Para públicos Android: gaid OU oiad OU imei OU cuid OU braze_id OU amplitude_id
  • Para públicos iOS: idfv OU cuid OU braze_id OU amplitude_id
400 Não é possível processar mais de Y dispositivos por pedido (foram contados n dispositivos neste pedido)

O corpo do pedido inclui uma lista com mais de 10.000 IDs de dispositivos

400 A lista de dispositivos não pode estar vazia

O corpo do pedido contém uma lista de dispositivos vazia

É necessário fornecer pelo menos um ID de dispositivo por pedido

400 Não conseguimos interpretar um ou mais dos IDs dos seus dispositivos Alguns ou todos os IDs de dispositivos não estão num formato válido

400

X ou mais dispositivos a remover contêm mais do que um identificador por dispositivo

Foi enviada uma solicitação de remoção com mais de um identificador por dispositivo

403 Proibido Pedido não autorizado: Chave de importação incorreta ou ausente
429 Pedidos em excesso Os pedidos estão limitados a 350 por minuto
500 Não foi possível interpretar o pedido

Formato do corpo do pedido inválido (não corresponde à estrutura JSON esperada ou não é JSON)

Consulte o exemplo de pedido acima

Limitações da API

  • Só pode adicionar dispositivos a uma audiência por pedido.
  • Pode apenas remover dispositivos de uma audiência por pedido.
  • Pode enviar até 20.000 IDs de dispositivos por pedido.
  • Pode fazer até 350 pedidos por minuto.

API de Gestão de Audiências Importadas

A API de Gestão de Audiência Importada permite aos anunciantes criar e configurar audiências importadas, conectar estas audiências a parceiros, carregar essas audiências aos parceiros e muito mais.