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.
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.
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:
Adicionar
Para adicionar atributos do utilizador:
- Na AppsFlyer, no menu lateral, selecione Envolver > Públicos-alvo.
- Clique no separador Atributos do Utilizador.
- Clique em Adicionar atributo do utilizador.
- Preencha os campos. As especificações dos campos estão listadas na tabela seguinte.
- Nome do atributo
- Formato
- Nível
- Clique em Guardar.
Campo | Características |
---|---|
Nome do atributo |
|
Formato |
|
Nível |
|
Gerir
Para gerir os atributos do utilizador, vá para Públicos-alvo > separador Atributos do Utilizador.
altAudiencesUserAttributes_us-en.pngaltFunçã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:
Nota! Se os scripts tiverem chaves incluídas, atualize-as com a nova chave. |
Eliminar
Apenas um utilizador administrador pode eliminar um atributo.
Para eliminar um atributo que faz parte de um conjunto de regras:
- Remova o atributo do conjunto de regras.
- Elimine o atributo.
Importar dados
Especificações dos campos de importação
Campo | Conteúdo | Formato | Adicionar dados por CSV |
Remover dados por CSV |
---|---|---|---|---|
ID_do_dispositivo |
Inclui um destes IDs de utilizador:
|
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 |
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
Requisitos do ficheiro CSV
- Sem linha de cabeçalho
- Contém todas as colunas listadas na tabela anterior.
Para importar um ficheiro CSV:
- Aceda a Públicos > separador Atributos do utilizador.
- Clique em Importar dados.
- Selecione CSV.
- Escolha uma das opções:
- Adicionar dados
- Remover dados
- Escolha um ficheiro CSV para importar.
- 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.
- No painel, obtenha as chamadas de solicitação de API preparadas e o modelo de JSON.
- 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:
- Clique em Importar dados.
- Selecione API.
- 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.
- Copie o URL de solicitação da API gerado.
- Copie o corpo da solicitação de API gerado.
- 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": ["*"]
- Prepare a chamada da API baseada no URL e no corpo da solicitação.
- 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": ""
}
]
}
]
}
Nota
Deve autenticar a solicitação usando um cabeçalho de autorização Bearer com um token API V2.0
{
"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
ecustomer_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 pordevice_id
e não porcustomer_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.