getVisitorValues getvisitorvalues

Dit is een asynchrone API die herkenningstekens voor Analytics, de dienst van identiteitskaart, de optieoptie van de gegevensinzameling, geografische plaats, en meta-gegevens "blob"inhoud door gebrek terugkeert. U kunt ook bepalen welke id's u wilt retourneren met de optionele bezoeker.FIELDS-enum.

Inhoud:

Syntaxis section-5aebe3907b2b46e997f45a1d1ed35c09

Deze functie gebruikt de volgende syntaxis (cursief vertegenwoordigt placeholder voor een variabele): var * waarden * = visitor.getVisitorValues (callback, [visitor.FIELDS. * type van identiteitskaart *, visitor.FIELDS. * identiteitskaart *]);

In de functieparameters:

  • * callback * vertegenwoordigt uw eigen callback code die teruggekeerde IDs ontvangt.
  • (Facultatief) visitor.FIELDS. * het type van identiteitskaart * is een opsomming die u laat specificeren welke waarden van identiteitskaartu deze functie wilt terugkeren.

Zie de volgende gebruiksgevallen en definities voor meer informatie.

Hoofdlettergebruik 1: de standaardgegevensset aanvragen section-36a31683558742a5915db3a391e09f7b

Deze code retourneert de standaardgegevensset. Uw verzoek en antwoord kunnen er ongeveer als volgt uitzien.

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

In de standaardvoorbeeldreactie zijn sommige waarden voor demonstratiedoeleinden ingekort.

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

Hoofdlettergebruik 2: een aangepaste gegevensset aanvragen section-467b2f4e513344c89b7332b05f6f59f3

Deze code gebruikt een optionele array om een specifieke set id's te retourneren met behulp van de visitor.FIELDS enum. In dit geval willen we alleen de Experience Cloud-id (MCID) en de Analytics ID (MCAID) van de bezoeker. Uw verzoek en antwoord kunnen er ongeveer als volgt uitzien.

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

De aangepaste voorbeeldreactie retourneert alleen de id's die in de aanvraag zijn opgegeven.

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

Responsparameters gedefinieerd section-4c4c300167694c6fbff1d6c612f372b5

In de volgende tabel worden de responsparameters weergegeven en gedefinieerd. Dit zijn ook alle waarden in de visitor.FIELDS enum. Nota, keert deze methode en leeg koord terug als er geen waarden voor een bepaalde variabele zijn.

Waarde
Beschrijving
MCAAMB
Gecodeerde metagegevens van Audience Manager , ook wel 'de blob' genoemd.
MCAAMLH

The data collection region ID. Dit is een numerieke id voor de geografische locatie van een bepaald datacenter van de ID-service.

Zie ID's van DCS-regio's, locaties en hostnamenen getLocationHint.

MCAID
De Analytics -id van de bezoeker.
MCMID

De Experience Cloud-id van de bezoeker.

Zie Cookies en de service Identiteit Experience Cloud.

MCOPTOUT

Een markering die aangeeft of een bezoeker zich heeft teruggetrokken uit de gegevensverzameling.

Waarden zijn:

  • 'isoptedout-true' : een bezoeker heeft ervoor gekozen geen gegevens meer te verzamelen.
  • 'isoptedout-false' : een bezoeker heeft ervoor gekozen de gegevensverzameling niet te beĆ«indigen.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a