Esta é uma API assíncrona que retorna os identificadores para o Analytics, o serviço de ID, o cancelamento da coleta de dados, a localização geográfica e o conteúdo “blob” de metadados por padrão. Além disso, você pode controlar quais IDs deseja retornar com a enumeração opcional visitor.FIELDS.
Conteúdo:
Essa função usa a seguinte sintaxe (itálico representa um espaço reservado para uma variável): var *
valores* = visitor.getVisitorValues (callback, [visitor.FIELDS. *
tipo de ID*, visitor.FIELDS. *
tipo de ID*]);
Nos parâmetros da função:
*
retorno de chamada*
representa seu próprio código de retorno de chamada que recebe as IDs retornadas. visitor.FIELDS. *
Tipo de ID*
é um enum que permite especificar quais valores de ID você deseja que a função retorne.Consulte os casos de uso e as definições a seguir para obter mais informações.
Esse código retorna o conjunto de dados padrão. Sua solicitação e resposta podem ser semelhantes aos exemplos a seguir.
//Call the ID service
var visitor = Visitor.getInstance ("Insert Experience Cloud organization ID here",{...});
//Add your callback to the GET method to return IDs and data.
visitor.getVisitorValues(visitorIdsCallback);
Na resposta de amostra padrão, alguns valores foram encurtados para fins de demonstração.
//Formatted IDs in JSON response
{
MCMID: 'mid-1234',
MCOPTOUT: 'isoptedout-true',
MCAID: 'aid-1234',
MCAAMLH: 7,
MCAAMB: 'hgfe54236786oygj'
}
Esse código usa uma matriz para retornar um conjunto específico de IDs usando o visitor.FIELDS
enum. Nesse caso, desejamos apenas a Experience Cloud ID (MCID) e a Analytics ID (MCAID) do visitante. Sua solicitação e resposta podem ser semelhantes aos exemplos a seguir.
//Call the ID service
var visitor = Visitor.getInstance("Insert Experience Cloud organization ID here", { ... });
// Add an optional array to specify which IDs you want to return.
visitor.getVisitorValues(visitorIdsCallback, [visitor.FIELDS.MCMID, visitor.FIELDS.MCAID]);
A resposta de amostra personalizada retorna somente as IDs especificadas na solicitação.
//Formatted IDs in JSON response
{
MCMID: 'mid-1234',
MCAID: 'aid-4321'
}
A tabela a seguir lista e define os parâmetros de resposta. Esses são todos os valores no visitor.FIELDS
enum. Observe que esse método retornará uma string vazia se não houver valores para uma variável específica.
Valor | Descrição |
---|---|
MCAAMB |
Metadados criptografados do Audience Manager conhecido como “a bolha”. |
MCAAMLH |
A ID da região de coleta de dados. Este é um identificador numérico para a localização geográfica de um data center de serviço de ID específico. Consulte IDs de região, locais e nomes de host do DCS e getLocationHint. |
MCAID |
A Analytics ID do visitante. |
MCMID |
A Experience Cloud ID do visitante. Consulte Cookies e o serviço de identidade da Experience Cloud. |
MCOPTOUT |
Um sinalizador que indica se um visitante recusou a coleta de dados. Os valores incluem:
|