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 staat voor een tijdelijke aanduiding voor een variabele): var *waarden* = visitor.getVisitorValues (callback, [visitor.FIELDS. *Type id*, visitor.FIELDS. *Type id*]);

In de functieparameters:

  • *callback* vertegenwoordigt uw eigen callback code die teruggekeerde IDs ontvangt.
  • (Optioneel) visitor.FIELDS. *Type id* is een opsomming waarmee u kunt opgeven welke ID-waarden u wilt dat deze functie wordt geretourneerd.

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
Gecodeerd Audience Manager metagegevens die "de blob" worden 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, locaties en hostnamen van DCS-regio'sen getLocationHint.

MCAID
De bezoeker Analyse ID.
MCMID

De Experience Cloud-id van de bezoeker.

Zie Cookies en de Experience Cloud Identity Service.

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 de gegevensverzameling niet verlaten.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a