Show Menu
TOPICS×

getVisitorValues

Se trata de una API asíncrona que devuelve identificadores para Analytics, el servicio de ID, la exclusión de la recopilación de datos, la ubicación geográfica y el contenido “blob” de metadatos de forma predeterminada. Además, se puede controlar cuáles son los ID que desea que se devuelvan con la enumeración opcional visitor.FIELDS.
Contenido:

Sintaxis

Esta función utiliza la siguiente sintaxis (la cursiva representa un marcador de posición para una variable):
var *
valores
* = visitor.getVisitorValues (callback, [visitor.FIELDS. *
tipo de ID
*, visitor.FIELDS. *
tipo de ID
*]);
En los parámetros de función:
  • *
    Callback
    *
    representa su propio código de rellamada que recibe los ID devueltos.
  • (Opcional)
    visitor.FIELDS. *
    tipo de ID
    *
    es una enumeración que le permite especificar qué valores de ID desea que devuelva esta función.
Consulte los casos de uso y definiciones siguientes para obtener más información.

Caso de uso 1: Solicitar el conjunto de datos predeterminado

Este código devuelve el conjunto de datos estándar. Su solicitud y respuesta pueden tener un aspecto similar al de los ejemplos siguientes.
//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);
En la respuesta de ejemplo predeterminada, se han acortado algunos valores para realizar la demostración.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCOPTOUT: 'isoptedout-true', MCAID: 'aid-1234', MCAAMLH: 7, MCAAMB: 'hgfe54236786oygj' }

Caso de uso 2: Solicitar un conjunto de datos personalizado

Este código utiliza una matriz opcional para devolver un conjunto de ID específico mediante la
visitor.FIELDS
enumeración. En este caso, solo queremos el Experience Cloud ID (MCID) y el ID de Analytics (MCAID). Su solicitud y respuesta pueden tener un aspecto similar al de los ejemplos siguientes.
//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]);
La respuesta de ejemplo personalizada devuelve solo los ID especificados en la solicitud.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCAID: 'aid-4321' }

Parámetros de respuesta definidos

La tabla que se muestra a continuación enumera y define los parámetros de respuesta. Estos son también todos los valores de la
visitor.FIELDS
enumeración. Observe que este método devuelve una cadena vacía si no hay valores para una variable en concreto.
Valor
Descripción
MCAAMB
Metadatos de
Audience Manager
cifrados conocidos como el "blob".
MCAAMLH
El ID de región de recopilación de datos. Se trata de un identificador numérico para la ubicación geográfica de un centro de datos de servicio de ID concreto.
Consulte DCS Region IDs, Locations, and Host Names (ID de región de DCS, ubicaciones y nombres de host) y getLocationHint.
MCAID
El ID de
Analytics
del visitante.
MCMID
El Experience Cloud ID del visitante.
Consulte la información relativa a las cookies y el servicio de identidad de Experience Cloud .
MCOPTOUT
Un indicador que indica si un visitante se ha excluido de la recopilación de datos.
Los valores incluyen:
  • 'isoptedout-true'
    : un visitante ha excluido la recopilación de datos.
  • 'isoptedout-false'
    : un visitante no ha excluido la recopilación de datos.