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.

Recursos do Business.Adobe.com