Reactietokens

Last update: Fri Oct 06 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:
Administration & Configuration

Gemaakt voor:

Admin

Met respontokens kunt u automatisch specifieke informatie uitvoeren voor Adobe Target op de webpagina van uw merk. 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.

De tekenen van de reactie laten u kiezen welke variabelen (in zeer belangrijke waardeparen) te gebruiken en dan hen toe te laten om als deel van a worden verzonden 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 Preview -modus.

Een belangrijk verschil tussen insteekmodules en reactietokens is dat insteekmodules JavaScript leveren aan de pagina die wordt uitgevoerd bij 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.

Doel-SDK

Voorgestelde acties

Adobe Experience Platform Web SDK

Zorg ervoor dat u versie 2.6.0 of later van SDK van het Web van het Platform gebruikt. Voor informatie over het downloaden van de recentste versie van Platform Web SDK, zie De SDK installeren in de Overzicht van Platform Web SDK hulplijn. Voor informatie over nieuwe functionaliteit in elke versie van het Web SDK van het Platform, zie Opmerkingen bij de release in de Overzicht van Platform Web SDK hulplijn.

at.js

Zorg ervoor dat u at.js versie 1.1 of later gebruikt. Voor informatie over het downloaden van de nieuwste versie van at.js raadpleegt u Downloaden om.js. For information about new functionality in each version of at.js, see at.js Version Details.
Klanten die at.js gebruiken, worden aangeraden om reactietokens te gebruiken en zich van plug-ins af te verplaatsen. 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.

Reactietokens gebruiken section_A9E141DDCBA84308926E68D05FD2AC62

Zorg ervoor dat u Platform Web SDK versie 2.6.0 (of later) of versie 1.1 (of later) gebruikt.

Voor meer informatie:
- Platform Web SDK: Zie De SDK installeren in de Overzicht van Platform Web SDK hulplijn.
- at.js: Zie Downloaden om.js.
In Target, klikt u op Administration > Response Tokens.

De gewenste reactietokens activeren, zoals activity.id en offer.id.

De volgende parameters zijn standaard beschikbaar:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3
Type	Parameter	Notities
Ingebouwde profielen	`profile.activeActivities`	Hiermee wordt een array van de `activityIds` de bezoeker is gekwalificeerd voor. Dit neemt toe naarmate gebruikers gekwalificeerd zijn. Bijvoorbeeld op een pagina met twee Target verzoeken om twee verschillende activiteiten te verrichten, omvat het tweede verzoek 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.
Activiteit	`activity.name` `activity.id` `experience.name` `experience.id` `offer.name` `offer.id`	Details van de huidige activiteit. Merk op dat de waarden voor aanbiedingsparameters op het ervaringsniveau worden geëvalueerd.
Geo	`geo.country` `geo.state` `geo.city` `geo.zip` `geo.dma` `geo.domainName` `geo.ispName` `geo.connectionSpeed` `geo.mobileCarrier`	Zie Geo voor meer informatie over het gebruik van geo - gerichte toepassingen in activiteiten .
Methode voor verkeerstoewijzing (Van toepassing op Auto-Target en Automated Personalization alleen activiteiten.)	`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) Een profielparameter gebruiken als reactietoken, maar de parameter is niet doorgegeven via een Target en heeft dus niet in de Target UI, kunt u gebruiken Add Response Token om het profiel aan de gebruikersinterface toe te voegen.

Klikken Add Response Token, geef de naam van het token op en klik vervolgens op Activate.
Maak een activiteit.

Luisteren naar reacties en reactietokens lezen

Het proces dat u gebruikt om te luisteren naar Target reacties en leestekens voor reacties verschillen afhankelijk van of u een Platform Web SDK of at.js-implementatie.

Platform Web SDK de klasse Handle-object gebruiken platform-web-sdk

Gebruik de Object Handle-klasse, die een metagegevensobject en een gegevensobject bevat om naar te luisteren Target reacties en lees de reactietokens.

In het volgende reactievoorbeeld wordt een Platform Web SDK de manager van de douanegebeurtenis direct aan de pagina van de HTML (de lijst verklaart voorwerpen die in de code worden gebruikt):

Object

Informatie

Type - Personalisatie.Besluit

Of de beslissing door de Target of Offer decisioning provider.

DecisionProvider - TGT

TGT-Target. Target Hiermee geeft u de metagegevens en waarden van het reactietoken op de pagina op.

at.js gebruiken, aangepaste gebeurtenissen

Gebruiken at.js, aangepaste gebeurtenissen om te luisteren naar Target reactietokens lezen en erop reageren.

Het volgende codevoorbeeld voegt een at.js aangepaste gebeurtenishandler rechtstreeks naar de pagina HTML:

<html>
  <head>
    ....
    <script src="at.js"></script>
    <script>
      document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) {
        console.log("Request succeeded", e.detail);
      });
    </script>
  <head>
  <body>
  ...
  </body>
</html>

Veelgestelde vragen over antwoordtoken section_3DD5F32C668246289CDF9B4CDE1F536D

Welke rol wordt vereist om reactietokens te activeren of te deactiveren?

De tokens van de reactie kunnen slechts door gebruikers met worden geactiveerd of worden gedeactiveerd Target Administrator rol.

Wat gebeurt er als ik werk? Platform Web SDK 2.6.0 (of eerder)?

U hebt geen toegang tot reactietokens.

Wat gebeurt er als ik om 1.js 1.0 (of vroeger) loop?

U ziet de reactietokens, maar at.js kan hen niet gebruiken.

Kan ik beide hebben Target Classic insteekmodules en reactietokens die tegelijkertijd actief zijn?

Plugins en reactietokens zijn parallel beschikbaar, maar de plug-ins worden in de toekomst vervangen.

Zijn reactietokens die door allen worden geleverd Target reacties of alleen via Target reacties die een activiteit leveren?

Reactietokens worden alleen geleverd via Target reacties die een activiteit leveren.

Mijn Target Classic opgenomen JavaScript. Hoe repliceer ik zijn functionaliteit gebruikend reactietokens?

Bij het migreren naar reactietokens moet dit type JavaScript in uw codebase of oplossing voor tagbeheer worden bewaard. U kunt deze code activeren met Platform Web SDK of at.js aangepaste gebeurtenissen en geef de waarden van de reactietoken door aan uw JavaScript-functies.

Waarom wordt mijn profiel/parameter van Attributen van de Klant niet getoond in de lijst van reactietokens?

Target worden parameters gewoonlijk om de 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 responstoken, Target heeft 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 heb mijn profielmanuscript anders genoemd, 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 kenmerken zijn gewijzigd, wanneer worden ze dan uit de lijst verwijderd?

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 Hiermee verwijdert u 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 kunt verzenden Target gegevens aan Googles Analytics 4. Gegevens die door responstokens worden verzonden, kunnen ook naar andere integratie van derden worden verzonden.

Gegevens verzenden naar Googles Analytics via Platform Web SDK

Googles Analytics kunnen gegevens via Versie 2.6.0 van SDK van het Web van het Platform (of recenter) worden verzonden door de volgende code in de pagina van de HTML toe te voegen.

NOTE

Zorg ervoor dat het sleutelwaardepaar van het reactietoken zich onder de alloy("sendEvent" object.

<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script type="text/javascript">
    alloy("sendEvent", {


    })
    .then(({ renderedPropositions, nonRenderedPropositions }) => {
        // concatenate all the propositions
        const propositions = [...renderedPropositions, ...nonRenderedPropositions];
        // extractResponseTokens() extract the meta from item -> meta
        const tokens = extractResponseTokens(propositions);
        const activityNames = [];
        const experienceNames = [];
        const uniqueTokens = distinct(tokens);


        uniqueTokens.forEach(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
        });
    });
</script>

Gegevens naar Googles Analytics verzenden 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 foutopsporing

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>

Trainingsvideo: respontokens en aangepaste gebeurtenissen at.js section_3AA0A6C8DBD94A528337A2525E3E05D5

In de volgende video wordt uitgelegd hoe u responstokens en aangepaste gebeurtenissen at.js kunt gebruiken om profielgegevens te delen van Target naar systemen van derden.

NOTE

De Target Administration menu-interface (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.

In de video wordt gesproken over option.name en option.id, die zijn vervangen door offer.name en offer.id, respectievelijk.

https://video.tv.adobe.com/v/23253/

recommendation-more-help

3d9ad939-5908-4b30-aac1-a4ad253cd654