Namespaces
A cada ID para a qual você deseja poder pesquisar, é atribuído um namespace, que é uma sequência de caracteres personalizada que identifica essa ID em qualquer variável em que for usada em todos os conjuntos de relatórios.
A sequência de caracteres do namespace é usada para identificar os campos que você deseja pesquisar ao fornecer uma ID como parte de uma solicitação de Privacidade de dados. Quando uma solicitação de Privacidade de dados for enviada, ela incluirá uma seção JSON especificando as IDs dos titulares de dados que devem ser usadas. Várias IDs podem ser incluídas como parte de uma única solicitação de um titular de dados. O JSON inclui:
- Um campo de “namespace” contendo a sequência de caracteres do namespace.
- Um campo de “type” que, para a maioria das solicitações do Adobe Analytics, contém o valor “analytics”.
- Um campo de “value” contendo a ID que o Analytics deve pesquisar nas variáveis de namespace associadas a cada um dos conjuntos de relatórios.
Consulte a documentação da API da Privacidade de dados da Experience Cloud para obter mais detalhes.
ID de cookies
Cookie herdado de rastreamento do Analytics, também conhecido como a Adobe Analytics ID (AAID):
{
namespace: "AAID",
type: "standard",
value: "2CCEEAE88503384F-1188000089CA"
}
O valor deve ser especificado como dois números hexadecimais separados por um traço. Todos os dígitos hexadecimais que são caracteres alfabéticos devem ser especificados usando letras maiúsculas. Os valores hexadecimais não devem ter zeros à esquerda (observe a diferença em relação ao mesmo valor especificado na forma obsoleta, onde zeros à esquerda eram obrigatórios).
Também é aceitável usar "namespaceId": 10 em vez de ou além de "namespace": "AAID", e você pode ver outros produtos da Adobe usarem esse formulário.
Cookie herdado de rastreamento do Analytics: forma obsoleta
{
"namespace": "visitorId",
"type": "analytics",
"value": "2cceeae88503384f-00001188000089ca"
}
Forma obsoleta:
O valor deve ser especificado como dois números hexadecimais de 16 dígitos ou dois números decimais de 19 dígitos. Os números devem ser separados por um traço (-), sublinhado (_) ou dois pontos (:). Zeros à esquerda devem ser adicionados se um dos dois números não tiver dígitos suficientes.
Cookie do serviço de identidade
{
namespace: "ECID",
type: "standard",
value: "00497781304058976192356650736267671594"
}
O valor deve ser especificado como um número decimal de 38 dígitos. Se você estiver extraindo esse número das duas colunas mcvisid_high/low ou post_msvisid_high/low de um feed de dados ou do relatório Data Warehouse, você deve zerar cada um dos números até atingir 19 dígitos e concatená-los com o primeiro valor alto.
Também é aceitável usar "namespaceId": 4 em vez de ou além de "namespace": "ECID", e você pode ver outros produtos da Adobe usarem esse formulário.
Se o formato da porção do valor de qualquer uma dessas IDs de cookie não seguir o formato descrito para essa ID, ocorrerá uma falha na solicitação de Privacidade de dados, com um erro de “Valor não formatado corretamente”.
Você normalmente coletará essas IDs de cookies com o novo JavaScript de privacidade, que fornecerá automaticamente todos os pares de chave/valor relevantes para essas IDs JSON.
Esse código JavaScript preenche o JSON com outros pares de chave/valor além dos listados acima (namespace, tipo, valor), mas os campos listados são os mais importantes para o processamento da Privacidade de dados do Analytics e os únicos que você precisa fornecer se coletar IDs de alguma outra maneira.
ID de visitante personalizada
{
namespace: "customVisitorID",
type: "analytics",
value: "<ID>"
}
O namespace também é predefinido para a ID de visitante personalizada.
IDs em variáveis personalizadas
{
namespace: "Email Address",
type: "analytics",
value: "john@xyz.com" },
{
namespace: "CRM ID",
type: "analytics",
value: "123456-ABCD"
}
Para IDs em variáveis de conversão ou de tráfego personalizadas (props ou eVars), identifique a variável com um rótulo ID-DEVICE ou ID-PERSON, depois atribua seu próprio nome de namespace a esse tipo de ID. Consulte Fornecer um namespace ao rotular uma variável como ID-DEVICE ou ID-PERSON.
Também é possível ver os namespaces definidos anteriormente para outras variáveis ou conjuntos de relatórios e reutilizá-los, para que um mesmo namespace possa ser facilmente usado em todos os conjuntos de relatórios que armazenam esse tipo de ID. Também é possível atribuir o mesmo namespace a várias variáveis em um conjunto de relatórios. Por exemplo, alguns clientes armazenam uma ID do CRM em uma variável de tráfego e em uma variável de conversão (dependendo da página, às vezes, somente em uma delas ou em ambas) e podem atribuir o namespace “ID do CRM” às duas variáveis.
Para obter mais informações, consulte Fornecer um namespace ao rotular uma variável como ID-DEVICE ou ID-PERSON.