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 *values* = 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 där du kan ange vilken ID-värden du vill att den här funktionen ska returneras.

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 visitor.FIELDS enum. 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 visitor.FIELDS enum. 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
Krypterad Audience Manager metadata som kallas"blob".
MCAAMLH

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

Se DCS-region-ID, -platser och -värdnamnoch getLocationHint.

MCAID
Besökarens Analyser 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 valt bort datainsamling.
  • 'isoptedout-false' : En besökare har inte avanmält sig från datainsamlingen.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a