Audências – atributos dos utilizadores

Como marqueteiro de aplicações, está a realizar as seguintes tarefas:

• Gerenciar duas aplicações de jogos: jogo_a e jogo_b.
• Lançar o jogo_c
• Direcionar os utilizadores atuais da aplicação com estes atributos:
  • Desporto favorito: Críquete
  • Pontuação atual do jogo: 15 ou mais em algum dos jogos atuais

A tabela contém dados de atributos dos utilizadores do seu CRM. Os conjuntos de regras de audiências necessitam de acesso a esses dados. 

Utilizar dados CRM em conjuntos de regras

Em Audiências, crie atributos de utilizador (como desporto favorito e pontuação de jogo). Isto permite que o conjunto de regras aceda aos dados do CRM. 

Atributos dos utilizadores no cenário

Atributos do utilizador em conjuntos de regras

Os atributos do utilizador funcionam como filtros nos conjuntos de regras dos Públicos. Este exemplo usa critérios (desporto favorito e pontuação do jogo) definidos pelo marketeer. 

altUserAttributedExample.jpgalt

Pré-requisito:

Para gerir atributos ao nível da aplicação, o utilizador da conta deve ter permissão para tal. 

Para configurar os atributos do utilizador, siga os procedimentos seguintes:

1. Adicionar atributos do utilizador.

2. Realize uma das seguintes ações

   • Importe dados de atributos do utilizador via CSV.

   • Importe dados de atributos do utilizador via API.

3. Implemente os atributos do utilizador em conjuntos de regras.

Para adicionar atributos do utilizador:

1. Na AppsFlyer, no menu lateral, selecione Envolver > Públicos-alvo.
2. Clique no separador Atributos do Utilizador.
3. Clique em Adicionar atributo do utilizador.
   

   

4. Preencha os campos. As especificações dos campos estão listadas na tabela seguinte. 
   
   • Nome do atributo
   • Formato
   • Nível
5. Clique em Guardar.

Para gerir os atributos do utilizador, vá para Públicos-alvo > separador Atributos do Utilizador.

Apenas um utilizador administrador pode eliminar um atributo.

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

1. Remova o atributo do conjunto de regras.
2. Elimine o atributo.

Os dados dos atributos do utilizador são adicionados ou removidos via ficheiro CSV. A figura e o ficheiro CSV de exemplo que se seguem correspondem ao cenário descrito neste artigo.

Exemplo-atributo-do-utilizador.csv

Requisitos do ficheiro CSV

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

Para importar um ficheiro CSV:

1. Aceda a Públicos > separador Atributos do utilizador.
2. Clique em Importar dados.
3. Selecione CSV.
4. Escolha uma das opções:
   • Adicionar dados
   • Remover dados
5. Escolha um ficheiro CSV para importar. 
6. Clique em Fazer upload; aparecerá uma mensagem de estado da carga.

Nota: Ao importar atributos de utilizador, todos os dispositivos conhecidos associados a um ID de cliente recebem também o atributo. Por exemplo, se um utilizador importar 10 dispositivos (por customer_id) para o atributo “Game Score”, e um dos customer_ids estiver associado a 2 dispositivos (por exemplo, 2 GAIDs com o mesmo CUID), então esta importação conterá 11 registos de atributos do utilizador.

Este método de importação requer um URL de solicitação e um JSON com os dados dos atributos do utilizador.

1. No painel, obtenha as chamadas de solicitação de API preparadas e o modelo de JSON.
2. Preencha o modelo JSON com os seus dados de acordo com as especificações dos campos. 

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

1. Clique em Importar dados.
2. Selecione API.
3. Escolha uma ação:
   
   • Atualizar os atributos do utilizador: Substituir ou adicionar.
   • Remover os atributos do utilizador.
   • Remover dados do utilizador: Remove todos os dados relacionados a um utilizador específico. O utilizador é identificado pelo seu ID AppsFlyer.
   • Remover dados da aplicação: Remove todos os dados ao nível da aplicação. 
4. Copie o URL de solicitação da API gerado.
5. Copie o corpo da solicitação de API gerado.
6. Prepare o JSON (com dados de atributos do utilizador) utilizando o formato JSON especificado. Para os atributos ao nível da conta, defina "app_ids": ["*"]
7. Prepare a chamada da API baseada no 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

• Apenas números inteiros (números inteiros) são suportados nos dados de importação CSV/API. Números do tipo float (decimais) não são suportados. Exemplo: Um valor de atributo "pontuação" pode ser 90, mas não 90,5.
• Os dados sobre atributos de utilizador não podem ser impressos ou descarregados. 

• Limitações dos valores de atributos:

  • Não são permitidas vírgulas, pontos ou outros caracteres especiais nos valores de atributos.
  • Os valores de atributo de tipo sequência de caracteres estão limitados a 40 caracteres.
  • Os valores dos atributos não devem começar por 0.

Limitações de importação via API

• Máximo de 350 pedidos API por minuto, podendo a carga útil abranger até 10 mil dispositivos (10 mil dispositivos com um atributo, 5 mil dispositivos com dois atributos, etc.)
• As chaves device_id e customer_id são necessárias em todas as chamadas de importação. Se desejar importar atributos com apenas um desses identificadores, a chamada deve incluir o "cabeçalho" do outro identificador com uma sequência de caracteres vazia. Por exemplo, se quiser importar atributos por device_id e não por customer_id, a chamada deve ser semelhante a esta:

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

Limitações de importação de CSV

• Ao adicionar valores de atributos de utilizador, cada ficheiro CSV pode ter no máximo 10 milhões de linhas.