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:
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. 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.
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'
}
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'
}
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 Experience Cloud ID. |
MCOPTOUT |
Un indicador que especifica si un visitante se ha excluido de la recopilación de datos. Los valores incluyen:
|