getVisitorValues 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 section-5aebe3907b2b46e997f45a1d1ed35c09

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 section-36a31683558742a5915db3a391e09f7b

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 section-467b2f4e513344c89b7332b05f6f59f3

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 section-4c4c300167694c6fbff1d6c612f372b5

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:

  • 'isoptedout-true': un visitante ha excluido la recopilación de datos.
  • 'isoptedout-false': un visitante no ha excluido la recopilación de datos.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a