Show Menu
TOPICS×

getVisitorValues

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:

Sintaxe

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:
  • O
    *
    retorno de chamada
    *
    representa seu próprio código de retorno de chamada que recebe as IDs retornadas.
  • (Opcional)
    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.

Caso de uso 1: solicitar o conjunto de dados padrão

Esse código retorna o conjunto de dados padrão. Sua solicitação e a resposta podem ser semelhantes aos seguintes exemplos.
//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 exemplo padrão, alguns valores foram reduzidos para fins de demonstração.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCOPTOUT: 'isoptedout-true', MCAID: 'aid-1234', MCAAMLH: 7, MCAAMB: 'hgfe54236786oygj' }

Caso de uso 2: solicitar um conjunto de dados personalizado

Esse código usa uma matriz para retornar um conjunto específico de IDs usando o
visitor.FIELDS
enum. Nesse caso, queremos apenas a Experience Cloud ID (MCID) e a Analytics ID (MCAID) do visitante. Sua solicitação e a resposta podem ser semelhantes aos seguintes exemplos.
//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 da amostra personalizada retorna somente as IDs especificadas na solicitação.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCAID: 'aid-4321' }

Parâmetros de resposta definidos

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 retorna uma sequência de caracteres vazia se não existirem valores para uma variável específica.
Valor
Descrição
MCAAMB
Metadados criptografados do
Audience Manager
conhecido como “a bolha”.
MCAAMLH
A ID de região para coleta de dados. É um identificador numérico da localização geográfica de um data center do serviço de ID específico.
MCAID
A
Analytics
ID do visitante.
MCMID
A Experience Cloud ID do visitante.
MCOPTOUT
Um sinalizador que indica se um visitante recusou a coleta de dados.
Os valores incluem:
  • 'isoptedout-true'
    : um visitante recusou a coleta de dados.
  • 'isoptedout-false'
    : um visitante não recusou a coleta de dados.