getVisitorValues getvisitorvalues

Detta är ett asynkront API som returnerar identifierare för Analytics, ID-tjänsten, avanmälan av datainsamling, geografisk plats och metadatablockinnehåll som standard. Du kan också styra vilka ID:n du vill returnera med den valfria uppräkningen visitor.FIELDS.

Innehåll:

Syntax section-5aebe3907b2b46e997f45a1d1ed35c09

Den här funktionen använder följande syntax (kursiv stil representerar en platshållare för en variabel): var *värden* = visitor.getVisitorValues (callback, [visitor.FIELDS. *ID-typ*, visitor.FIELDS. *ID-typ*]);

I funktionsparametrarna:

  • *callback* representerar din egen callback-kod som tar emot returnerade ID:n.
  • (Valfritt) visitor.FIELDS. *ID-typ * är en uppräkning som gör att du kan ange vilka ID-värden som den här funktionen ska returnera.

Mer information finns i följande användningsexempel och definitioner.

Användningsfall 1: Begär standarddatauppsättning section-36a31683558742a5915db3a391e09f7b

Den här koden returnerar standarddatauppsättningen. Din förfrågan och ditt svar kan se ut som i följande exempel.

//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);

I standardsvaret på samplingen har vissa värden förkortats i demonstrationssyfte.

//Formatted IDs in JSON response
{
    MCMID: 'mid-1234',
    MCOPTOUT: 'isoptedout-true',
    MCAID: 'aid-1234',
    MCAAMLH: 7,
    MCAAMB: 'hgfe54236786oygj'
}

Användningsfall 2: Begär en anpassad datauppsättning section-467b2f4e513344c89b7332b05f6f59f3

Den här koden använder en valfri array för att returnera en specifik uppsättning ID:n med uppräkningen visitor.FIELDS. I det här fallet vill vi bara ha besökarens Experience Cloud ID (MCID) och Analytics ID (MCAID). Din förfrågan och ditt svar kan se ut som i följande exempel.

//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]);

Det anpassade exempelsvaret returnerar endast de ID:n som anges i begäran.

//Formatted IDs in JSON response
{
    MCMID: 'mid-1234',
    MCAID: 'aid-4321'
}

Svarsparametrar definierade section-4c4c300167694c6fbff1d6c612f372b5

I följande tabell visas och definieras svarsparametrarna. Detta är också alla värden i uppräkningen visitor.FIELDS. Observera att den här metoden returnerar en tom sträng om det inte finns några värden för en viss variabel.

Värde
Beskrivning
MCAAMB
Krypterade Audience Manager -metadata som kallas"blobben".
MCAAMLH

Datainsamlingens region-ID. Detta är en numerisk identifierare för den geografiska platsen för ett visst ID-tjänstdatacenter.

Se ID:n för DCS-regionen, platser och värdnamnoch getLocationHint.

MCAID
Besökarens Analytics -ID.
MCMID

Besökarens Experience Cloud-ID.

Se Cookies och Experience Cloud Identity Service.

MCOPTOUT

En flagga som anger om en besökare har valt att inte samla in data.

Värdena är:

  • 'isoptedout-true' : En besökare har avanmält sig från datainsamlingen.
  • 'isoptedout-false' : En besökare har inte avanmält sig från datainsamlingen.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a