Met responstokens kunt u automatisch specifieke informatie over Adobe Target naar de webpagina van uw merk uitvoeren. Deze informatie kan details over de activiteit, de aanbieding, de ervaring, het gebruikersprofiel, geo informatie, en meer omvatten. Deze details verstrekken extra reactiegegevens om met interne of derdehulpmiddelen te delen of voor het zuiveren te gebruiken.
Met responstokens kunt u kiezen welke variabelen (in sleutelwaardeparen) u wilt gebruiken en deze vervolgens inschakelen als onderdeel van een Target -reactie. U laat een variabele toe gebruikend de schakelaar en de variabele wordt verzonden met Target reacties, die in netwerkvraag kunnen worden bevestigd. Reactietokens werken ook in de modus Preview .
Een belangrijk verschil tussen plug-ins en responstokens is dat plug-ins JavaScript leveren aan de pagina die wordt uitgevoerd na levering. Responstkens leveren echter een object op dat vervolgens kan worden gelezen en verwerkt met behulp van gebeurtenislisteners. De responstoken-aanpak is veiliger en maakt de ontwikkeling en het onderhoud van integratie van derden eenvoudiger.
NOTE
Responstokens zijn beschikbaar in versie 1.1 of hoger van at.js.
Zorg ervoor dat u Platform Web SDK versie 2.6.0 of later gebruikt. Voor informatie over het downloaden van de recentste versie van het Web SDK van het Platform, zie SDKinstalleren in de overzichtsgids van SDK van het Web van het Platform. Voor informatie over nieuwe functionaliteit in elke versie van het Web SDK van het Platform, zie de nota's van de Versiein de overzicht van SDK van het Web van het Platform gids.
Zorg ervoor dat u at.js versie 1.1 of later gebruikt. Voor informatie over het downloaden van de recentste versie van at.js, zie Download at.js. Voor informatie over nieuwe functionaliteit in elke versie van at.js, zie at.js de Details van de Versie. Klanten die at.js gebruiken worden aangemoedigd om reactietokens te gebruiken en zich van stop-ins weg te bewegen. Sommige plug-ins die afhankelijk zijn van interne methoden die in mbox.js (nu afgekeurd) bestaan, maar niet in at.js, worden geleverd, maar mislukken.
Retourneert een array van de activityIds waarvoor de bezoeker gekwalificeerd is. Dit neemt toe naarmate gebruikers gekwalificeerd zijn. Op een pagina met twee Target -aanvragen die twee verschillende activiteiten uitvoeren, omvat het tweede verzoek bijvoorbeeld beide activiteiten.
profile.isFirstSession
Retourneert "true" of "false".
profile.isNewSession
Retourneert "true" of "false".
profile.daysSinceLastVisit
Geeft als resultaat het aantal dagen sinds het laatste bezoek van de bezoeker.
profile.tntId
Retourneert de tntID van de bezoeker
profile.marketingCloudVisitorId
Retourneert de bezoeker-id van het Experience Cloud van de bezoeker.
profile.thirdPartyId
Retourneert de id van de derde partij van de bezoeker.
profile.categoryAffinity
Geeft de favoriete categorie van de bezoeker.
profile.categoryAffinities
Retourneert een array van de bovenste 5 categorieën van de bezoeker als tekenreeksen.
Zie Geovoor meer informatie over het gebruiken van geo het richten in activiteiten.
De Methode van de Toewijzing van het verkeer (is op Auto-Target en Automated Personalization slechts activiteiten van toepassing.)
experience.trafficAllocationId
Keert 0 terug als een bezoeker een ervaring van het zijn in "controle"verkeer en 1 ontving als een bezoeker een ervaring van de "gerichte"verkeersdistributie ontving.
experience.trafficAllocationType
Retourneer "besturingselement" of "gericht".
Kenmerken van gebruikersprofielen en Klantkenmerken worden ook in de lijst weergegeven.
note note
NOTE
Parameters met speciale tekens worden niet in de lijst weergegeven. Alleen alfanumerieke tekens en onderstrepingstekens worden ondersteund.
(Voorwaardelijk) om een profielparameter als reactietoken te gebruiken, maar de parameter is niet overgegaan door een Target verzoek en, zo, geladen niet in Target UI, kunt u de Add Response Token knoop gebruiken om het profiel aan UI toe te voegen.
Klik op Add Response Token , geef de naam van het token op en klik op Activate .
Maak een activiteit.
Luisteren naar reacties en reactietokens lezen
Het proces dat u gebruikt om te luisteren naar Target reacties en om responstokens te lezen, hangt af van het feit of u een Platform Web SDK - of at.js-implementatie hebt.
Platform Web SDK gebruiken van de de objecten van de Handle klasse van SDK van het Web van Adobe Experience Platform platform-web-sdk
Gebruik de Object Handle-klasse, die een metagegevensobject en een gegevensobject bevat om te luisteren naar Target -reacties en de reactietokens te lezen.
In het volgende reactievoorbeeld wordt een Platform Web SDK aangepaste gebeurtenishandler rechtstreeks aan de HTML-pagina toegevoegd (in de tabel worden de objecten in de code uitgelegd):
Object
Informatie
Type - Personalization.Decision
Of de beslissing is genomen door de Target - of Offer decisioning-provider.
DecisionProvider - TGT
TGT-Target. Target bevat de metagegevens en waarden van het reactietoken voor de pagina.
Meta
Metagegevens die aan de pagina worden doorgegeven.
Gegevens
Waarden van de metagegevens die aan de pagina zijn doorgegeven.
Veelgestelde vragen over antwoordtoken section_3DD5F32C668246289CDF9B4CDE1F536D
Welke rol wordt vereist om reactietokens te activeren of te deactiveren?
Responstempels kunnen alleen worden geactiveerd of gedeactiveerd door gebruikers met de rol Target Administrator .
wat gebeurt als ik Platform Web SDK 2.6.0 (of vroeger) in werking stel?
U hebt geen toegang tot reactietokens.
wat gebeurt als ik bij.js 1.0 (of vroeger) loopt?
U ziet de reactietokens, maar at.js kan hen niet gebruiken.
kan ik zowel Target Classic insteekmodules als reactietokens tezelfdertijd actief hebben?
Plugins en reactietokens zijn parallel beschikbaar, maar de plug-ins worden in de toekomst vervangen.
zijn reactietokens die door alle Target reacties of slechts door Target reacties worden geleverd die een activiteit leveren?
Reactietokens worden alleen geleverd via Target reacties die een activiteit leveren.
Mijn Target Classic plug-in bevatte JavaScript. Hoe repliceer ik zijn functionaliteit gebruikend reactietokens?
Wanneer u naar reactietokens migreert, moet dit type JavaScript in uw codebase of oplossing voor tagbeheer worden bewaard. U kunt deze code activeren met behulp van Platform Web SDK - of at.js -aangepaste gebeurtenissen en de waarden van de reactietoken doorgeven aan uw JavaScript-functies.
waarom toont mijn profiel/de parameter van Attributen van de Klant niet in de lijst van reactietokens?
In Target worden parameters gewoonlijk elke 15 minuten vernieuwd. Deze vernieuwing is afhankelijk van de actie van de gebruiker en de gegevens worden alleen vernieuwd wanneer u de pagina voor reactietokens weergeeft. Als de parameters niet worden weergegeven in de lijst met reactietoken, heeft Target de gegevens nog niet vernieuwd.
Als uw parameter behalve alfanumerieke tekens of andere symbolen dan onderstrepingstekens iets anders bevat, wordt de parameter niet in de lijst weergegeven. Momenteel worden alleen alfanumerieke tekens en onderstrepingstekens ondersteund.
levert het reactietoken nog inhoud als het een geschrapt profielmanuscript of een profielparameter gebruikt?
De tokens van de reactie halen informatie uit gebruikersprofielen en leveren dan die informatie. Als u een profielscript of parameter verwijdert, betekent dit niet dat de gegevens uit de gebruikersprofielen zijn verwijderd. De gebruikersprofielen beschikken nog steeds over gegevens die overeenkomen met het profielscript. Het reactietoken gaat door met het leveren van de inhoud. Voor gebruikers die de informatie niet in hun profielen hebben opgeslagen, of voor nieuwe bezoekers, wordt dat token niet geleverd omdat de gegevens niet aanwezig zijn in hun profielen.
Target schakelt het token niet automatisch uit. Als u een profielscript verwijdert en de token niet meer wilt leveren, moet u de token zelf uitschakelen.
ik hernoemde mijn profielmanuscript, maar waarom is het teken dat dat manuscript gebruikt nog actief met de oude naam?
Zoals hierboven vermeld, werken responstokens aan de profielgegevens die zijn opgeslagen voor gebruikers. Ook al hebt u de naam van uw profielscript gewijzigd, gebruikers die uw website hebben bezocht, hebben de oude profielscriptwaarde opgeslagen in hun profielen. De token blijft de oude waarde ophalen die al in de gebruikersprofielen is opgeslagen. Als u nu inhoud op de nieuwe naam wilt leveren, moet u van het vorige token en knevel op het nieuwe token schakelen.
als mijn attributen zijn veranderd, wanneer worden zij verwijderd uit de lijst?
Target vernieuwt kenmerken regelmatig. Om het even welk attribuut dat niet wordt van een knevel voorzien wordt verwijderd tijdens volgende verfrist zich. Als u echter een kenmerk hebt dat is ingeschakeld en verwijderd, wordt dat script pas verwijderd uit de lijst met kenmerken nadat u het hebt uitgeschakeld. U hebt bijvoorbeeld een profielscript verwijderd dat als token is gebruikt. Target verwijdert alleen de in- en uitschakelkenmerken uit de lijst wanneer deze worden verwijderd of hernoemd.
Gegevens verzenden naar Googles Analytics
In de volgende secties wordt beschreven hoe u Target -gegevens naar Googles Analytics 4 kunt verzenden. Gegevens die door responstokens worden verzonden, kunnen ook naar andere integratie van derden worden verzonden.
die gegevens naar Googles Analytics via het Web SDK van het Platform verzendt
Googles Analytics kunnen via Platform Web SDK versie 2.6.0 (of hoger) gegevens worden verzonden door de volgende code in de HTML-pagina toe te voegen.
NOTE
Zorg ervoor dat het sleutelwaardepaar van het reactietoken zich onder het alloy("sendEvent" -object bevindt.
Verzendende gegevens naar Googles Analytics via at.js section_04AA830826D94D4EBEC741B7C4F86156
Googles Analytics kunnen via at.js gegevens worden verzonden door de volgende code op de pagina HTML toe te voegen:
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script type="text/javascript">
document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
var tokens = e.detail.responseTokens;
if (isEmpty(tokens)) {
return;
}
var activityNames = [];
var experienceNames = [];
var uniqueTokens = distinct(tokens);
uniqueTokens.forEach(function(token) {
activityNames.push(token["activity.name"]);
experienceNames.push(token["experience.name"]);
});
gtag('config', 'TAG_ID');
gtag('event', 'action_name', {'eventCategory': 'target',
'eventAction': experienceNames, 'eventLabel': activityNames
});
});
function isEmpty(val) {
return (val === undefined || val == null || val.length <= 0) ? true : false;
}
function key(obj) {
return Object.keys(obj)
.map(function(k) { return k + "" + obj[k]; })
.join("");
}
function distinct(arr) {
var result = arr.reduce(function(acc, e) {
acc[key(e)] = e;
return acc;
}, {});
return Object.keys(result)
.map(function(k) { return result[k]; });
}
</script>
Foutopsporing
De volgende secties verstrekken informatie over het zuiveren reactietokens:
Googles Analytics en het zuiveren
Met de volgende code kunt u fouten opsporen met behulp van Googles Analytics:
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script type="text/javascript">
document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
var tokens = e.detail.responseTokens;
if (isEmpty(tokens)) {
return;
}
var activityNames = [];
var experienceNames = [];
var uniqueTokens = distinct(tokens);
uniqueTokens.forEach(function(token) {
activityNames.push(token["activity.name"]);
experienceNames.push(token["experience.name"]);
});
gtag('config', 'TAG_ID');
gtag('event', 'action_name', {'eventCategory': 'target',
'eventAction': experienceNames, 'eventLabel': activityNames
});
});
function isEmpty(val) {
return (val === undefined || val == null || val.length <= 0) ? true : false;
}
function key(obj) {
return Object.keys(obj)
.map(function(k) { return k + "" + obj[k]; })
.join("");
}
function distinct(arr) {
var result = arr.reduce(function(acc, e) {
acc[key(e)] = e;
return acc;
}, {});
return Object.keys(result)
.map(function(k) { return result[k]; });
}
</script>
Foutopsporing met het equivalent van de ttMeta-plug-in
Het equivalent van de ttMeta-plug-in voor foutopsporingsdoeleinden kan worden gemaakt door de volgende code toe te voegen aan de HTML-pagina:
<script type="text/javascript" >
document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function (e) {
window.ttMETA= typeof(window.ttMETA)!="undefined" ? window.ttMETA : [];
var tokens=e.detail.responseTokens;
if (isEmpty(tokens)) {
return;
}
var uniqueTokens = distinct(tokens);
uniqueTokens.forEach(function(token) {
window.ttMETA.push({
'CampaignName': token["activity.name"],
'CampaignId' : token["activity.id"],
'RecipeName': token["experience.name"],
'RecipeId': token["experience.id"],
'OfferId': token["offer.id"],
'OfferName': token["offer.name"],
'MboxName': e.detail.mbox});
console.log(ttMETA);
});
});
function isEmpty(val){
return (val === undefined || val == null || val.length <= 0) ? true : false;
}
function key(obj) {
return Object.keys(obj)
.map(function(k) { return k + "" + obj[k]; })
.join("");
}
function distinct(arr) {
var result = arr.reduce(function(acc, e) {
acc[key(e)] = e;
return acc;
}, {});
return Object.keys(result)
.map(function(k) { return result[k]; });
}
</script>
de Video van de Opleiding: De Tokens van de Reactie en de Gebeurtenissen van de Douane at.js section_3AA0A6C8DBD94A528337A2525E3E05D5
In de volgende video wordt uitgelegd hoe u responstokens en aangepaste gebeurtenissen at.js kunt gebruiken om profielgegevens van Target naar systemen van derden te delen.
NOTE
De gebruikersinterface van het Target Administration menu (voorheen Setup ) is opnieuw ontworpen om betere prestaties te bieden, de vereiste onderhoudstijd bij het vrijgeven van nieuwe functies te verminderen en de gebruikerservaring in het hele product te verbeteren. De informatie in de volgende video is correct, maar de opties bevinden zich op een iets andere locatie.
De video bespreekt option.name en option.id , die zijn vervangen door respectievelijk offer.name en offer.id .
