Audências – atributos dos utilizadores

Premium

Visão Geral: Aumente a sua capacidade de segmentar utilizadores em grupos relevantes ao adicionar dados sobre suas características aos Públicos.

altUserAttributionNavigationXL3_us-en.pngalt

Sobre os atributos dos utilizadores

Os atributos dos utilizadores, ao contrário de dados baseados em eventos, são características gerais que os seus utilizadores partilham com a sua empresa. Podem ser estáticos, como género, idade, data de nascimento e país, ou dinâmicos, como a pontuação de um jogo.

Os dados dos atributos dos utilizadores são:

  • Atualizados através da importação de ficheiros CSV ou JSON via API. 
  • Armazenados em formato encriptado.
  • Disponíveis para uso em qualquer conjunto de regras de audiências.

Os dados dos atributos dos utilizadores não são partilhados com parceiros publicitários.

Os atributos dos utilizadores estão disponíveis quer ao nível da aplicação quer ao nível da conta, conforme descrito neste artigo. Se utilizar atributos ao nível da aplicação, o utilizador da conta precisará de ter permissão da aplicação para gerir e utilizar os atributos. 

O cenário seguinte oferece uma explicação detalhada dos atributos dos utilizadores.

Cenário – requisitos para marqueteiros de aplicações

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. 
UserAttributuesExample_us-en.png

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

Nome Formato Nível
Pontuação do jogo Número: Permite definir regras como 'PontuaçãoJogoB é maior que 29'.

Nível da aplicação: A pontuação do utilizador é registada para cada jogo jogado.

Significado: PontuaçãoJogoA, PontuaçãoJogoB.

Desporto favorito

String: Permite definir regras como "cujo desporto favorito é ténis".

Nota! Os valores distinguem entre maiúsculas e minúsculas.

Nível da conta: O desporto favorito do utilizador mantém-se o mesmo, independentemente da aplicação.

Nota! Um utilizador pode ter apenas um valor associado a atributos ao nível da conta.

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

Implementar atributos de utilizador

Configure, adicione, gere e elimine atributos de utilizador.

Configurar

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

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

Adicionar

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.

    UserAttributeAdd.png

  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.
Campos de atributos do utilizador
Campo Características
Nome do atributo
  • Apenas caracteres em inglês
  • Sem pontuação ou caracteres especiais
  • O mesmo nome não pode ser usado tanto ao nível da aplicação quanto da conta
  • O mesmo nome pode ser usado ao nível da aplicação; por exemplo, conforme o cenário acima, a utilização de ScoreGameA e ScoreGameB
Formato
  • Texto: Teste se o valor do atributo é ou não é igual a um valor de regra especificado. Exemplo: É críquete ou não é críquete.
  • Número: Teste se o valor do atributo é maior, menor ou igual a um valor de regra especificado. Exemplo: Pontuação superior a 15
Nível
  • Nível da conta: Um atributo não tem ligação com a aplicação.
    Exemplo: género, desporto favorito
  • Nível da aplicação: Um atributo está relacionado com a aplicação. Selecione as aplicações associadas ao atributo. 

Gerir

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

altAudiencesUserAttributes_us-en.pngalt
Gerir atributos de utilizador
Função Descrição
Pesquisa e filtro

Por nome de atributo, nome da aplicação e nível de atributo.

Ordenar por  Clique no cabeçalho da coluna para ordenar as linhas da tabela.
Importar dados
Alterar chave de importação da API 

Para alterar a chave de importação da API:

  1. Clique em Importar dados.
  2. Selecione API.
  3. Clique em Atualizar chave de importaçãoy. 

Nota! Se os scripts tiverem chaves incluídas, atualize-as com a nova chave. 

Eliminar

AppsFlyerAdmin_us-en.png 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.

Importar dados

Especificações dos campos de importação

Lista de campos de atributos do utilizador
Campo Conteúdo Formato Adicionar dados
por CSV
Remover dados por CSV
ID_do_dispositivo 

Inclui um destes IDs de utilizador:

  • IDFA
  • GAID
 Texto Obrigatório que device_id ou customer_id sejam fornecidos

Obrigatório que device_id ou customer_id sejam fornecidos

 

Para remover dados existentes, não os envie

ID_do_cliente  ID do utilizador do cliente  Texto Obrigatório que device_id ou customer_id sejam fornecidos

Obrigatório que device_id ou customer_id sejam fornecidos

 

Para remover dados existentes, não os envie

ID_da_aplicação

Atributo a nível da aplicação: ID da aplicação conforme exibido no painel.

Para aplicações iOS, inclua o prefixo ID

Atributo a nível da conta: Preencha sempre com * 

Texto Obrigatório Obrigatório
chave_atributo Nome do atributo do utilizador, tal como apresentado no separador de atributos do utilizador. Texto Obrigatório Obrigatório
valor_atributo

Valor atribuído

*Consulte as limitações

Texto ou número Obrigatório Não enviar

Importar dados por CSV

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

FileForAttributes.png

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.

 

Importar dados através de API

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.
Exemplo de solicitação e JSON
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": ""
        }
      ]
    }
  ]
}

Nota

Deve autenticar a solicitação usando um cabeçalho de autorização Bearer com um token API V2.0

Exemplo com múltiplos IDs de dispositivos, chaves de atributos e valores de atributos
{
    "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
                }
            ]
        }]
}
Exemplo com um único ID de dispositivo e várias chaves e valores de atributos
{
    "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
                }
            ]
        }
    ]
}

 

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. Limitações de importação de CSV

Limitações

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.