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
• Caso de uso 1: Solicitar el conjunto de datos predeterminado
• Caso de uso 2: Solicitar un conjunto de datos personalizado
• Parámetros de respuesta definidos

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.