Audiences—atributos do usuário

Você, um profissional de marketing de aplicativos, está bastante ocupado:

• Gerenciando 2 aplicativos de jogos, o game_a e o game_b.
• Lançando o game_c.
• Segmentando usuários que possuem os seguintes atributos:
  • Esporte favorito: críquete
  • Pontuação atual: 15 ou mais em qualquer um dos jogos já lançados

A tabela abaixo mostra os dados de atributos do usuário do seu CRM. Os conjuntos de regras do Audiences precisam acessar esses dados. 

Use dados de CRM em conjuntos de regras

No Audiences, crie atributos de usuário (por exemplo, esporte favorito e pontuação no jogo). Assim, o conjunto de regras terá acesso aos seus dados de CRM. 

Cenários de atributos de usuário

Atributos do usuário nos conjuntos de regras

Os atributos do usuário atuam como filtros nos conjuntos de regras do Audiences. Esse exemplo usa critérios (como esporte favorito e pontuação no jogo) definidos pelo profissional de marketing. 

Pré-requisito:

Para gerenciar atributos no nível do aplicativo, o usuário da conta precisará da permissão do aplicativo. 

Para configurar atributos do usuário, siga os passos abaixo: 

1. Adicionar atributos de usuário.

2. Siga um dos procedimentos abaixo:

   • Importar dados de atributos via CSV.

   • Importar dados de atributos via API.

3. Implementar atributos de usuário em conjuntos de regras.

Para adicionar atributos de usuário:

1. Na AppsFlyer, no menu lateral, selecione engajamento>Audiences.
2. Clique na aba atributos de usuário.
3. Clique em adicionar atributo de usuário.
   

   

4. Preencha os campos. As características do campo estão listadas na tabela a seguir. 
   
   • Nome do atributo
   • Formato
   • Nível
5. Clique em Salvar.

Para gerenciar os atributos do usuário, acesse Audiences > aba Atributos do usuário.

Somente um usuário administrador pode excluir um atributo.

Para excluir um atributo que faz parte de um conjunto de regras:

1. Remova-o do conjunto de regras.
2. Delete o atributo.

Os dados de atributos de usuário são adicionados ou removidos por meio de um arquivo CSV. A figura e o arquivo CSV do exemplo a seguir correspondem ao cenário descrito neste artigo.

User-attribute-example.csv

Requisitos do arquivo CSV

• Nenhuma linha de cabeçalho
• Contém todas as colunas listadas na tabela anterior. 

Para importar um arquivo CSV:

1. Acesse Audiences > aba Atributos do usuário ).
2. Clique em importar dados.
3. Selecione CSV.
4. Selecione uma das opções:
   • Adicionar dados
   • Remover dados 
5. Escolha um arquivo CSV. 
6. Clique em upload; uma mensagem com o status do upload será exibida.

Observação: ao importar atributos de usuário, todos os dispositivos associados a um customer ID também recebem um atributo. Por exemplo, se um usuário importou 10 dispositivos (por customer_id) para atribuir a "Pontuação no jogo" e um desses customer_ids está associado a 2 dispositivos (ou seja, 2 GAIDs com o mesmo CUID), então serão registrados 11 atributos de usuário.

Esse método requer uma URL de solicitação e JSON com dados de atributos de usuário.

1. No dashboard, obtenha as chamadas de solicitação de API e o modelo JSON.
2. Preencha o modelo JSON com os dados de acordo com as especificações do campo. 

Para gerar a URL de solicitação da API e o modelo JSON:

1. Clique em importar dados.
2. Selecione API.
3. Selecione uma ação:
   
   • Atualizar atributos de usuário: substituir ou adicionar.
   • Remover os atributos de usuário.
   • Remover dados do usuário: remove todos os dados relacionados a um usuário específico. O usuário é identificado por seu AppsFlyer ID.
   • Remover dados do aplicativo: remove todos os dados no nível do aplicativo. 
4. Copie a URL da solicitação da API.
5. Copie o corpo da solicitação da API.
6. Prepare o JSON (com seus dados de atributo de usuário) usando o formato especificado. Para atributos em nível de conta, defina "app_ids": ["*"]
7. Prepare a chamada da API com base na URL e no corpo da solicitação.
8. Envie a solicitação de forma programática.

https://hq1.appsflyer.com/api/user-attributes-import-api/set-user-data
{
  "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
  "attributes_values": [
    {
      "device_id": "",
      "customer_id": "",
      "app_ids": [],
      "attributes": [
        {
          "attribute_key": "",
          "attribute_value": ""
        }
      ]
    }
  ]
}

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "2222222",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 5
                }
                ,
                {
                    "attribute_key": "favorite_sport",
                    "attribute_value": "cricket"
                }
            ]
        }
        ,
        {
            "device_id": "555555-d1d1-d1d1-555-fffffffff",
            "customer_id": "111111",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "order",
                    "attribute_value": 7
                }
                ,
                {
                    "attribute_key": "number",
                    "attribute_value": 8
                }
            ]
        }]
}

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "12345678",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 90
                }
                ,
                {
                    "attribute_key": "favorite-sport",
                    "attribute_value": "cricket"
                }
                ,
                {
                    "attribute_key": "orderNumber",
                    "attribute_value": 93
                }
                ,
                {
                    "attribute_key": "netPromoterScore",
                    "attribute_value": 94
                }
            ]
        }
    ]
}

Limitações gerais

• Somente números inteiros são aceitos nos dados de importação CSV/API. Os números do tipo flutuante (decimal) não são compatíveis. Exemplo: um atributo pode ter um valor de 90, mas não 90,5.
• Os dados de atributos do usuário não podem ser impressos ou baixados. 

• Limitações do valor do atributo:

  • Não é possível incluir vírgulas, pontos ou outros caracteres especiais dentro dos valores de atributos.
  • Há um limite de 40 caracteres para uma string de valor de atributo.
  • Os valores de atributos não podem começar com 0.

Limitações de importação da API

• Máximo de 1.000 solicitações de API por minuto, 5.000 dispositivos para carga útil fixa (5.000 dispositivos com um atributo, 2,5K dispositivos com 2 atributos, etc.)
• As chaves device_id e customer_id são obrigatórias para cada chamada de importação. Se você quiser importar atributos com apenas um desses identificadores, a chamada deverá incluir o "cabeçalho" do outro identificador com uma string de vazia. Por exemplo, se você quiser importar atributos por device_id e não por customer_id, a chamada deverá ser semelhante a esta:

"attributes_values": [
{
"device_id": "39e123.......",
"customer_id": "",

• Máximo de 10 milhões de linhas