getVisitorValues 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 section-5aebe3907b2b46e997f45a1d1ed35c09

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 section-36a31683558742a5915db3a391e09f7b

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'
}

Caso de uso 2: solicitar um conjunto de dados personalizado section-467b2f4e513344c89b7332b05f6f59f3

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'
}

Parâmetros de resposta definidos section-4c4c300167694c6fbff1d6c612f372b5

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 DCSe 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:

  • 'isoptedout-true': um visitante recusou a coleta de dados.
  • 'isoptedout-false': um visitante não recusou a coleta de dados.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a