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.
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.
De Experience Cloud-id van de bezoeker.
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.