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
• Caso de uso 1: solicitar o conjunto de dados padrão
• Caso de uso 2: solicitar um conjunto de dados personalizado
• Parâmetros de resposta definidos

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

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

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.