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:
- Use o seu CRM interno para criar uma lista de utilizadores com as suas datas de aniversário.
- Divida a lista de acordo com o mês de aniversário e exporte-a como listas individuais de IDs de publicidade.
- Importe as listas para o AppsFlyer como públicos e conecte-os aos parceiros para as campanhas promocionais que pretende realizar.
- 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:
- Obtenha a lista de IDs de dispositivos do estúdio adquirido e importe-a para o AppsFlyer como um público.
- Ligue o público importado aos parceiros com os quais pretende conduzir campanhas.
- 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 dados—um 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:
hash do identificador
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:
- No painel esquerdo da AppsFlyer, vá até Engage > Públicos.
- Clique em Novo público.
- Escolha Importar público.
A janela Importar público será aberta. - Insira um Nome de Público exclusivo.
- Selecione a plataforma do público: Android ou iOS.
- 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 no estado atual, marque a caixa. (Nota: Apenas disponível para administradores.)
- Clique em Guardar público e prossiga.
O separador Importar é mostrado. - 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).
- Escolha o ficheiro CSV para carregar.
Aguarde a mensagem de confirmação Carregado com sucesso. - Clique em Seguinte.
O separador Conectar é exibido. - (Opcional) Siga as instruções para ligar um público a parceiros.
- 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:
- No painel esquerdo da AppsFlyer, vá até Engage > Públicos.
- Clique no nome do público que deseja atualizar.
Aparece o ecrã Editar público, com o separador Definir. - 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.
- Na secção Importar utilizando CSV, escolha a ação a realizar com a lista carregada:
- Adicionar novos dispositivos/utilizadores: Adicione identificadores de dispositivos/utilizadores ao público existente.
- Remover dispositivos/utilizadores do público existente: Remova os identificadores de dispositivos/utilizadores da lista carregada do público.
- Substituir o público existente por novos dispositivos/utilizadores: Substitua o público completo pela lista carregada.
- Escolha o ficheiro CSV para carregar.
Aguarde a mensagem de confirmação Carregado com sucesso. - Clique em Seguinte.
O separador Conectar é exibido. - Faça alterações nas ligações de parceiros para este público, se necessário.
- 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:
|
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. |
|
|
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:
- No painel esquerdo da AppsFlyer, vá até Engage > Públicos.
- Clique em Novo público.
- Escolha Importar público.
A janela Importar público será aberta. - Insira um Nome de Público exclusivo.
- Selecione a plataforma do público: Android ou iOS.
- 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.
- Clique em Guardar.
É apresentada a página Importar. - 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).
- 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).
- Depois, copie e cole o corpo do pedido da API.
- Clique em Concluído.
O separador Conectar é exibido. - (Opcional) Siga as instruções para ligar um público a parceiros.
- Clique em Concluir.
- 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:
- No painel esquerdo da AppsFlyer, vá até Engage > Públicos.
- Clique no nome do público que deseja atualizar.
Aparece o ecrã Editar público, com o separador Definir. - Se pretender alterar o nome do público, poderá fazê-lo aqui. Caso contrário, selecione o separador Importar.
- Na secção Importar utilizando API, escolha o que fazer com a lista carregada:
- Adicionar novos dispositivos/utilizadores: Adicione identificadores de dispositivo/utilizador ao público existente.
- Remover dispositivos/utilizadores do público existente: Remova os identificadores de dispositivo/utilizador do público existente.
- 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).
- De seguida, copie o corpo do pedido da API.
- Clique em Seguinte.
O separador Conectar é exibido. - Faça alterações nas ligações de parceiros para este público, se necessário.
- Clique em Concluir.
- 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.
|
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:
|
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.