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.
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.
A Experience Cloud ID do visitante.
Consulte Cookies e o serviço de identidade da Experience Cloud.
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.