Show Menu
TEMAS×

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. La solicitud y la respuesta podrían ser similares a 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 muestra predeterminada, algunos valores se han abreviado con fines demostrativos.
//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). La solicitud y la respuesta podrían ser similares a 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. Tenga en cuenta que este método devuelve una cadena vacía si no hay valores para una variable en particular.
Valor Descripción
MCAAMB
Metadatos de Audience Manager cifrados conocidos como el "blob".
MCAAMLH
ID de región de recopilación de datos. Es un identificador numérico para la ubicación geográfica de un centro de datos de servicio de ID en particular.
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 especifica 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.