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.
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.
Besökarens Experience Cloud-ID.
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.