Lägg till Adobe Target

I den här lektionen implementerar vi Adobe Target-tillägget med en sidinläsningsbegäran och anpassade parametrar.

Adobe Target är en Adobe Experience Cloud-lösning som innehåller allt du behöver för att skräddarsy och personalisera kundupplevelsen, så att du kan maximera intäkterna på webbplatser, mobilsajter, appar, sociala medier och andra digitala kanaler.

NOTE
Adobe Experience Platform Launch håller på att integreras i Adobe Experience Platform som en serie datainsamlingstekniker. Flera terminologiska förändringar har introducerats i gränssnittet som du bör vara medveten om när du använder det här innehållet:
  • Platforma launchen (klientsidan) är nu tags
  • Platforma launchens serversida är nu event forwarding
  • Edge-konfigurationer är nu datastreams

Utbildningsmål

När lektionen är klar kan du:

  • Lägg till det fördolda kodutdrag som används för att hantera flimmer när Target används med asynkrona tagginbäddningskoder
  • Lägg till tillägget Target v2
  • Starta begäran om sidinläsning (kallades tidigare"global mbox")
  • Lägg till parametrar i sidinläsningsbegäran
  • Förklara hur profil- och enhetsparametrar kan läggas till i sidans inläsningsbegäran
  • Starta begäran om orderbekräftelse med obligatoriska parametrar
  • Förklara hur du lägger till avancerade konfigurationer som Bibliotekshuvud och Sidfot i bibliotek
  • Validera en målinriktad implementering

Förhandskrav

För att kunna slutföra lektionerna i det här avsnittet måste du först slutföra lektionerna i Konfigurera taggar och Lägg till identitetstjänsten.

Lägg till fördolt målkodfragment

Innan vi börjar måste vi göra en liten uppdatering av taggens inbäddningskoder. När taggens inbäddningskoder läses in asynkront kan sidan slutföra återgivningen innan målbiblioteket har lästs in fullständigt och innehållsväxlingen har utförts. Detta kan leda till det som kallas"flimmer", där standardinnehållet visas kort innan det ersätts av det anpassade innehåll som anges av Target. Om du vill undvika denna flimmer rekommenderar vi att du hårdkodar ett särskilt fragment som döljs innan taggarnas asynkrona inbäddningskoder.

Detta har redan gjorts på Luma-webbplatsen, men vi gör detta på exempelsidan så att du förstår implementeringen. Kopiera följande kodrader:

<script>
   //prehiding snippet for Adobe Target with asynchronous tags deployment
   ;(function(win, doc, style, timeout) {
   var STYLE_ID = 'at-body-style';
   function getParent() {
      return doc.getElementsByTagName('head')[0];
   }
   function addStyle(parent, id, def) {
      if (!parent) {
      return;
      }
      var style = doc.createElement('style');
      style.id = id;
      style.innerHTML = def;
      parent.appendChild(style);
   }
   function removeStyle(parent, id) {
      if (!parent) {
      return;
      }
      var style = doc.getElementById(id);
      if (!style) {
      return;
      }
      parent.removeChild(style);
   }
   addStyle(getParent(), STYLE_ID, style);
   setTimeout(function() {
      removeStyle(getParent(), STYLE_ID);
   }, timeout);
   }(window, document, "body {opacity: 0 !important}", 3000));
</script>

Öppna exempelsidan och klistra in den precis före taggens inbäddningskod enligt bilden nedan (oroa dig inte om radnumren är olika). I den här skärmbilden har det fördolda fragmentet miniatyrbildats:

Hovra över tillägget

Läs in exempelsidan igen. Du kommer att märka att sidan kommer att vara dold i tre sekunder innan den visas. Det här beteendet är tillfälligt och försvinner när du har distribuerat Target. Det här fördolda beteendet styrs av två konfigurationer i slutet av fragmentet, som kan anpassas men som oftast finns kvar i standardinställningarna:

  • body {opacity: 0 !important} anger den CSS-definition som ska användas för pre-hide tills Target läses in. Som standard döljs hela brödtexten. Om du har en konsekvent DOM-struktur med ett enkelt identifierbart behållarelement som omsluter allt innehåll under navigeringen, till exempel, och du aldrig vill testa eller anpassa navigeringen, kan du använda den här inställningen för att begränsa det som döljs till behållarelementet.
  • 3000 som anger timeoutinställningen för fördöljning. Som standard visas sidan om Target inte har lästs in på tre sekunder. Detta bör vara extremt sällsynt.

Mer information och information om hur du hämtar det icke-minifierade fördolda fragmentet finns i Adobe Target-tillägget med en asynkron distribution ​.

Lägg till måltillägget

Adobe Target-tillägget stöder implementeringar på klientsidan med Target JavaScript SDK för den moderna webben, at.js. Kunder som fortfarande använder Target:s äldre bibliotek, mbox.js, bör uppgradera till at.js 2.x för att kunna använda taggar.

Tillägget Target v2 består av två huvuddelar:

  1. Tilläggskonfigurationen, som hanterar huvudbiblioteksinställningarna

  2. Regelåtgärder för att göra följande:

    1. Load Target (at.js 2.x)
    2. Lägg till parametrar i sidinläsningsbegäranden
    3. Lägg till parametrar i alla begäranden
    4. Begäran om inläsning av brandsida

I den här första övningen ska vi lägga till tillägget och titta på konfigurationerna. I senare övningar kommer vi att använda åtgärderna.

Lägga till tillägget

  1. Gå till Extensions > Catalog

  2. Skriv target i filtret för att snabbt hitta Adobe Target-tilläggen. Det finns två tillägg - Adobe Target och Adobe Target v2. I den här självstudien används version 2 av tillägget som använder den senaste versionen av at.js (för närvarande 2.x), som är idealisk för både traditionella webbplatser och enkelsidiga program (SPA).

  3. Klicka på Install

    Installera tillägget Target v2

  4. När du lägger till tillägget importeras många, men inte alla dina at.js-inställningar från Target-gränssnittet, enligt bilden nedan. En inställning som inte kommer att importeras är Timeout, som alltid är 3 000 ms efter att tillägget har lagts till. Lämna standardinställningarna för självstudiekursen. Observera, att till vänster visas versionen at.js som levereras med den aktuella versionen av tillägget.

  5. Klicka på Save to Library

    Spara tillägget

För tillfället gör inte Target något, så det finns inget att validera.

NOTE
Varje version av Target-tillägget innehåller en specifik version av at.js, som anges i tilläggsbeskrivningen. Du uppdaterar versionen at.js genom att uppdatera Target-tillägget.

Läs in mål och starta sidinläsningsbegäran

Marknadsförarna använder Target för att styra besökarupplevelsen på sidan när de testar och målar innehåll. På grund av den här viktiga rollen för sidvisningen bör du läsa in Target så tidigt som möjligt för att minimera påverkan på sidsynligheten. I det här avsnittet läser vi in JavaScript-biblioteket Target, at.js, samt utlöser sidinläsningsbegäran (kallas"global mbox" i tidigare versioner av at.js).

Du kan använda regeln All Pages - Library Loaded som du skapade i lektionen Lägg till dataelement, regler och bibliotek för att implementera Target eftersom den redan aktiveras så tidigt som möjligt vid sidinläsning.

Att läsa in mål

  1. Gå till Rules i den vänstra navigeringen och klicka sedan på All Pages - Library Loaded för att öppna regelredigeraren

    Öppna alla sidor - regel för inläst bibliotek

  2. Klicka på plustecknet under Åtgärder för att lägga till en ny åtgärd.

    Klicka på plusikonen för att lägga till en ny åtgärd

  3. Välj Extension > Adobe Target v2

  4. Välj Action Type > Load Target

  5. Klicka på Keep Changes

    Klicka på Behåll ändringar

När åtgärden Load Target har lagts till läses at.js in på sidan. Inga Target-begäranden utlöses dock förrän vi lägger till åtgärden Fire Page Load Request.

Starta sidinläsningsbegäran

  1. Klicka på plustecknet en gång till under Åtgärder för att lägga till ytterligare en åtgärd.

    Klicka på plusikonen om du vill lägga till en annan åtgärd

  2. Välj Extension > Adobe Target v2

  3. Välj Action Type > Fire Page Load Request

  4. Det finns vissa konfigurationer tillgängliga för sidinläsningsbegäran som gäller huruvida sidan och CSS-väljaren ska döljas eller inte. De här inställningarna fungerar tillsammans med det fragment som är hårdkodat på sidan innan det döljs. Lämna standardinställningarna.

  5. Klicka på Keep Changes

    Åtgärd för att starta sidinläsning

  6. Den nya åtgärden läggs till i sekvens efter åtgärden Load Target och åtgärderna kommer att köras i den här ordningen. Du kan dra och släppa åtgärderna för att ordna om ordningen, men i det här scenariot måste Load Target vara före Fire Page Load Request.

  7. Klicka på Save to Library and Build

    Spara och bygg

Validera sidinläsningsbegäran

Nu när du har lagt till tillägget Target v2 och utlöst åtgärderna Load Target och Fire Page Load Request bör det finnas en sidinläsningsbegäran på alla sidor där taggegenskapen används.

Så här validerar du åtgärderna Läs in mål och Läs in brandsida

  1. Läs in exempelsidan igen. Du bör inte längre se en fördröjning på tre sekunder innan sidan syns. Om du läser in exempelsidan med protokollet file:// bör du göra det här steget i Firefox- eller Safari-webbläsare eftersom Chrome inte startar en Target-begäran när file:// -protokollet används.

  2. Öppna Luma-webbplatsen

  3. Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, vilket beskrivs i tidigare lektion

    Din taggutvecklingsmiljö visas i Felsökning

  4. Gå till fliken Sammanfattning i Felsökning

  5. Bekräfta att Target visas under rubriken Extensions i avsnittet Launch

  6. I avsnittet Target bekräftar du att din at.js-biblioteksversion visas

    Bekräfta att Mål visas på fliken Sammanfattning i Felsökning

  7. Till sist går du till fliken Target, utökar klientkoden och bekräftar att sidinläsningsbegäran visas:

    Bekräfta att sidinläsningsbegäran har gjorts

Grattis! Du har implementerat Target!

Lägg till parametrar

Genom att skicka parametrar i Target-begäran får ni kraftfulla funktioner för målinriktning, testning och personalisering. Taggtillägget innehåller två åtgärder för att skicka parametrar:

  1. Add Params to Page Load Request, som lägger till parametrar i sidinläsningsbegäranden (motsvarande metoden targetPageParams()))

  2. Add Params to All Requests, som lägger till parametrar i alla Target-begäranden, t.ex. sidinläsningsbegäran plus ytterligare begäranden från åtgärder för anpassad kod eller hårdkodade på din plats (motsvarar metoden targetPageParamsAll() )

Dessa åtgärder kan användas före åtgärden Load Target och kan ange olika parametrar på olika sidor baserat på dina regelkonfigurationer. Använd funktionen för regelordning som du använde när du ställde in kund-ID:n med identitetstjänsten för att ställa in ytterligare parametrar för händelsen Library Loaded innan regeln som startar sidinläsningsbegäran.

TIP
Eftersom de flesta implementeringar använder sidinläsningsbegäran för aktivitetsleverans, räcker det oftast med att bara använda åtgärden Add Params to Page Load Requests.

Begäranparametrar (mbox)

Parametrar används för att skicka anpassade data till Target, vilket förbättrar dina personaliseringsfunktioner. De är idealiska för attribut som ändras ofta under en webbläsarsession, t.ex. sidnamn, mall osv. och kvarstår inte.

Låt oss lägga till dataelementet Page Name som vi skapade tidigare i lektionen Lägg till dataelement, regler och bibliotek som en begärandeparameter.

Så här lägger du till begärandeparametern

  1. Gå till Rules i den vänstra navigeringen och klicka sedan på All Pages - Library Loaded för att öppna regelredigeraren.

    Öppna alla sidor - regel för inläst bibliotek

  2. Klicka på plustecknet under Åtgärder för att lägga till en ny åtgärd.

    Klicka på plusikonen för att lägga till en ny åtgärd

  3. Välj Extension > Adobe Target v2

  4. Välj Action Type > Add Params to Page Load Request

  5. Ange pageName som Name

  6. Klicka på ikonen för dataelement för att öppna det modala dataelementet

  7. Klicka på dataelementet Page Name

  8. Klicka på knappen Select

    Klicka på knappen Välj

  9. Klicka på Keep Changes

    Klicka på Behåll ändringar

  10. Klicka och dra i den vänstra kanten av åtgärden Add Params to Page Load Request för att ändra ordningen på åtgärder som den har innan åtgärden Fire Page Load Request (kan vara före eller efter Load Target)

  11. Klicka på Save to Library and Build

    Klicka på Spara i bibliotek och skapa

Validera begärandeparametrar

För närvarande är anpassade parametrar som skickas med at.js 2.x-begäranden inte så lätta att se i Felsökning, så vi kommer att använda webbläsarens utvecklingsverktyg.

Verifiera parametern för pageName-begäran

  1. Läs in Luma-webbplatsen igen och kontrollera att den är mappad till din egen taggegenskap
  2. Öppna webbläsarens utvecklarverktyg
  3. Klicka på fliken Nätverk
  4. Filtrera begäranden till tt.omtrdc (eller din CNAME-domän för Target-begäranden)
  5. Expandera avsnittet Headers > Request Payload > execute.pageLoad.parameters för att validera parametern och värdet pageName

pageName-parametern i felsökaren

Profilparametrar

Profilparametrar skickas också via Target-begäran, på samma sätt som begärandeparametrar. Profilparametrar lagras emellertid i målets databas för besökarprofiler och kommer att finnas kvar under varaktigheten för besökarens profil. Du kan ange dem på en sida på webbplatsen och använda dem i Target-aktiviteter på en annan sida. Här är ett exempel från en bilwebbplats. När en besökare går till en fordonssida kan du skicka profilparametern "profile.lastViewed=sportscar" för att registrera deras intresse för just det fordonet. När besökaren bläddrar till andra sidor som inte är avsedda för fordon kan du rikta innehåll baserat på det senast visade fordonet. Profilparametrar är idealiska för attribut som sällan ändras eller bara är tillgängliga på vissa sidor

Du skickar inga profilparametrar i den här självstudien, men arbetsflödet är nästan identiskt med det du gjorde när du skickade parametern pageName. Den enda skillnaden är att du måste ge profilparameternamn ett profile.-prefix. Så här ser en profilparameter som kallas userType ut i åtgärden Add Params to Page Load Request:

Anger en profilparameter

Enhetsparametrar

Enhetsparametrar är särskilda parametrar som används i Recommendations-implementeringar av tre huvudorsaker:

  1. Som en nyckel för att utlösa produktrekommendationer. Om du till exempel använder en rekommendationsalgoritm som"Personer som visade produkt X, även visade Y", är"X" rekommendationens"nyckel". Det är vanligtvis den produktsku (entity.id) eller kategori (entity.categoryId) som besökaren för närvarande visar.
  2. Samla in besökares beteende för att driva rekommendationer som"Senast visade produkter" eller"De mest visade produkterna"
  3. Fylla i Recommendations-katalogen. Recommendations innehåller en databas över alla produkter och artiklar på din webbplats, så att de kan visas i rekommendationserbjudandet. Om du till exempel rekommenderar produkter vill du vanligtvis visa attribut som produktnamnet (entity.name) och bilden (entity.thumbnailUrl). Vissa kunder fyller i sin katalog med serverdelsflöden, men de kan också fyllas i med enhetsparametrar i Target-begäranden.

Du behöver inte skicka några enhetsparametrar i den här självstudiekursen, men arbetsflödet är identiskt med det du gjorde tidigare när du skickade parametern pageName för begäran. Ge bara parametern ett namn som är prefix med "entity". och mappa det till det relevanta dataelementet. Observera att vissa vanliga entiteter har reserverade namn som måste användas (t.ex. entity.id för produktsku). Så här skulle det se ut att ange enhetsparametrar i åtgärden Add Params to Page Load Request:

Lägger till enhetsparametrar

Lägg till parametrar för kund-ID

Samlingen av kund-ID:n med Adobe Experience Platform Identity Service gör det enkelt att importera CRM-data till Target med funktionen Kundattribut i Adobe Experience Cloud. Det möjliggör även sammanfogning av besökare mellan olika enheter, vilket gör att du kan upprätthålla en konsekvent användarupplevelse när dina kunder växlar mellan sina bärbara datorer och sina mobila enheter.

Du måste ange kund-ID:t i identitetstjänstens Set Customer IDs-åtgärd innan sidinläsningsbegäran aktiveras. Kontrollera därför att du har följande funktioner på din webbplats:

  • Kund-ID måste vara tillgängligt på sidan före taggarna Embed Code
  • Tillägget Adobe Experience Platform Identity Service måste vara installerat
  • Du måste använda åtgärden Set Customer IDs i en regel som utlöses vid händelsen Biblioteksinläsning (överst på sidan)
  • Använd åtgärden Fire Page Load Request i en regel som utlöses efter åtgärden Ange kund-ID

I föregående lektion, Lägg till Adobe Experience Platform identitetstjänst, skapade du regeln All Pages - Library Loaded - Authenticated - 10 för att starta åtgärden Ange kund-ID. Eftersom den här regeln har en Order-inställning på 10, anges kund-ID:n innan vår sidinläsningsbegäran aktiveras från All Pages - Library Loaded-regeln med dess Order-inställning på 50. Så du har redan implementerat samlingen med kund-ID:n för Target!

Validera kund-ID

För närvarande är anpassade parametrar som skickas med at.js 2.x-begäranden inte så lätta att se i Felsökning, så vi kommer att använda webbläsarens utvecklingsverktyg.

Verifiera kund-ID:t

  1. Öppna Luma-webbplatsen

  2. Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, vilket beskrivs i tidigare lektion

    Din taggutvecklingsmiljö visas i Felsökning

  3. Logga in på Luma-webbplatsen med inloggningsuppgifterna test@adobe.com/test

  4. Återgå till Lumas hemsida

  5. Öppna webbläsarens utvecklarverktyg

  6. Klicka på fliken Nätverk

  7. Filtrera begäranden till tt.omtrdc (eller din CNAME-domän för Target-begäranden)

  8. Expandera avsnittet Headers > Request Payload > id.customerIds.0 för att validera kundens ID-inställningar och värde:

Inställningar för kund-ID i felsökaren

WARNING
Med Adobe Experience Platform Identity Service kan du skicka flera ID:n till tjänsten, men bara det första skickas till Target.

Lägg till parametern för egenskapstoken

NOTE
Det här är en valfri övning för Target Premium-kunder.

Egenskapstoken är en reserverad parameter som används med funktionen Företagsanvändarbehörigheter i Target Premium. Det används för att definiera olika digitala egenskaper så att olika medlemmar i en Experience Cloud-organisation kan tilldelas olika behörigheter för varje egenskap. Du kanske till exempel vill att en grupp användare ska kunna konfigurera Target-aktiviteter på din webbplats, men inte i ditt mobilprogram.

Målegenskaperna motsvarar taggegenskaper och analysrapportsviter. Ett företag med flera varumärken, webbplatser och marknadsföringsteam kan använda olika Target-egenskaper, taggegenskap och Analytics-rapporteringsprogram för varje webbplats eller mobilapp. Taggegenskaperna skiljs åt med hjälp av deras inbäddningskoder, Analytics-rapportsviterna skiljs åt med hjälp av deras rapportritets-ID och Target-egenskaperna skiljs åt med deras egenskapstokenparameter.

Egenskapstoken måste implementeras med en anpassad kodåtgärd i taggar med funktionen targetPageParams(). Om du implementerar flera webbplatser med olika värden för at_property med en enda taggegenskap kan du hantera värdet at_property via ett dataelement.

Här är en valfri övning om du är en Target Premium-kund och vill implementera en egenskapstoken i egenskapen Tutorial:

  1. Öppna målanvändargränssnittet på en separat flik

  2. Gå till Administration > Properties

  3. Identifiera den egenskap som du vill använda och klicka på </> (eller skapa en ny egenskap)

  4. Kopiera kodfragmentet inom <script></script> till Urklipp

    Hämta egenskapstoken från Adobe Target-gränssnittet

  5. Gå till Rules i den vänstra navigeringen på fliken Taggar och klicka sedan på All Pages - Library Loaded för att öppna regelredigeraren.

    Öppna alla sidor - regel för inläst bibliotek

  6. Klicka på åtgärden Core - Custom Code under Åtgärder för att öppna Action Configuration

    Öppna åtgärden Lägg till parametrar i sidinläsningsbegäran

  7. Öppna kodredigeraren och klistra in koden från målgränssnittet som innehåller funktionen targetPageParams()

  8. Klicka på knappen Save

    Öppna åtgärden Lägg till parametrar i sidinläsningsbegäran

  9. Markera rutan Execute globally så att targetPageParams() deklareras i det globala omfånget

  10. Klicka på Keep Changes

    Klicka på Behåll ändringar

  11. Klicka på Save to Library and Build
    Klicka på Spara och skapa i bibliotek

WARNING
Om du försöker lägga till parametern at_property via åtgärden Add Params to Page Load Request fylls parametern i i nätverksbegäran, men Target's Visual Experience Composer (VEC) kan inte identifiera den automatiskt när sidan läses in. Fyll alltid i at_property med funktionen targetPageParams() i en anpassad kodsåtgärd.

Validera egenskapstoken

För närvarande är anpassade parametrar som skickas med at.js 2.x-begäranden inte så lätta att se i Felsökning, så vi kommer att använda webbläsarens utvecklingsverktyg.

Verifiera egenskapstokenparametern

  1. Öppna Luma-webbplatsen

  2. Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, vilket beskrivs i tidigare lektion

    Din taggutvecklingsmiljö visas i Felsökning

  3. Öppna webbläsarens utvecklarverktyg

  4. Klicka på fliken Nätverk

  5. Filtrera begäranden till tt.omtrdc (eller din CNAME-domän för Target-begäranden)

  6. Expandera avsnittet Headers > Request Payload > property.token för att validera värdet
    Egenskapstoken ska vara synlig som parametern at_property i varje begäran

Lägg till anpassade begäranden

Lägg till en beställningsbekräftelse

Begäran om orderbekräftelse är en särskild typ av begäran som används för att skicka orderinformation till Target. Det som gör en vanlig Target-begäran till en beställningsbegäran är att tre specifika frågeparametrar (orderId, orderTotal och productPurchasedId) ingår. Förutom att rapportera intäkter gör beställningsbegäran även följande:

  1. Dubbletter av oavsiktliga orderåterinskick
  2. Filtrerar extrema order (alla order vars totalbelopp var mer än tre standardavvikelser från medelvärdet)
  3. Använder en annan algoritm bakom scenen för att beräkna statistisk säkerhet
  4. Skapar en särskild, nedladdningsbar revideringsrapport över information om enskilda order

Det bästa sättet är att använda en orderbekräftelsebegäran i alla ordergrupper, även på icke-butikssajter. Exempelvis har leadgenereringswebbplatser vanligtvis lead-trattar med ett unikt lead-id som genereras i slutet. Dessa platser bör implementera en beställningsbegäran med ett statiskt värde (t.ex. "1") för orderTotal.

Kunder som använder integreringen med Analytics for Target (A4T) för de flesta rapporter kanske också vill implementera beställningsförfrågan om de använder Automated Personalization-aktiviteter, som inte har stöd för A4T. Dessutom är beställningsbegäran en viktig del i Recommendations implementeringar, som driver algoritmer baserat på inköpsbeteenden. Den senaste informationen om A4T-stöd finns i dokumentationen.

Begäran om orderbekräftelse ska utlösas från en regel som bara aktiveras på din orderbekräftelsesida eller -händelse. Den kan ofta kombineras med en regel som ställer in Adobe Analytics-händelsen purchase. Den måste konfigureras med åtgärden Custom Code för Core-tillägget, med lämpliga dataelement för att ställa in parametrarna orderId, orderTotal och productPurchasedId.

Låt oss lägga till dataelementen och regeln vi måste skicka en orderbekräftelseförfrågan på Luma-webbplatsen. Eftersom du redan har skapat flera dataelement kommer dessa instruktioner att förkortas.

Skapa dataelementet för order-ID

  1. Klicka på Data Elements i den vänstra navigeringen
  2. Klicka på Add Data Element
  3. Namnge dataelementet Order Id
  4. Välj Data Element Type > JavaScript Variable
  5. Använd digitalData.cart.orderId som JavaScript variable name
  6. Markera alternativet Clean text
  7. Klicka på Save to Library
    (Vi skapar inte biblioteket förrän vi har gjort alla ändringar för orderbekräftelsebegäran.)

Skapa dataelementet för kundvagnsmängden

  1. Klicka på Add Data Element
  2. Namnge dataelementet Cart Amount
  3. Välj Data Element Type > JavaScript Variable
  4. Använd digitalData.cart.cartAmount som JavaScript variable name
  5. Markera alternativet Clean text
  6. Klicka på Save to Library

Så här skapar du dataelementet för kundvagn-SKU:er (mål)

  1. Klicka på Add Data Element

  2. Namnge dataelementet Cart SKUs (Target)

  3. Välj Data Element Type > Custom Code

  4. För Target måste skalet vara en kommaseparerad lista. Den här anpassade koden formaterar om datalagrets array till rätt format. Klistra in följande i den anpassade kodredigeraren:

    code language-javascript
    var targetProdSkus="";
    for (var i=0; i<digitalData.cart.cartEntries.length; i++) {
      if(i>0) {
        targetProdSkus = targetProdSkus + ",";
      }
      targetProdSkus = targetProdSkus + digitalData.cart.cartEntries[i].sku;
    }
    return targetProdSkus;
    
  5. Markera alternativet Force lowercase value

  6. Markera alternativet Clean text

  7. Klicka på Save to Library

Nu måste vi skapa en regel för att utlösa orderbekräftelsebegäran med dessa dataelement som parametrar på orderbekräftelsesidan.

Så här skapar du regeln för orderbekräftelsesidan

  1. Klicka på Rules i den vänstra navigeringen

  2. Klicka på Add Rule

  3. Namnge regeln Order Confirmation Page - Library Loaded - 60

  4. Klicka på Events > Add

    1. Välj Event Type > Library Loaded (Page Top)
    2. Under Advanced Options ändrar du Order till 60 så att den aktiveras efter åtgärden Load Target (som finns i vår All Pages - Library Loaded-regel där Order är inställd på 50)
    3. Klicka på Keep Changes
  5. Klicka på Conditions > Add

    1. Välj Condition Type > Path Without Query String

    2. Ange thank-you.html för Path equals

    3. Växla till alternativet Regex om du vill ändra logiken från equals till contains (du kan använda funktionen Test för att bekräfta att testet kommer att skickas med URL:en https://luma.enablementadobe.com/content/luma/us/en/user/checkout/order/thank-you.html)

      Ange dummy-värden för förnamn och efternamn

    4. Klicka på Keep Changes

  6. Klicka på Actions > Add

    1. Välj Action Type > Custom Code

    2. Klicka på Open Editor

    3. Klistra in följande kod i Edit Code modal

      code language-javascript
      adobe.target.getOffer({
        "mbox": "orderConfirmPage",
        "params":{
           "orderId": _satellite.getVar('Order Id'),
           "orderTotal": _satellite.getVar('Cart Amount'),
          "productPurchasedId": _satellite.getVar('Cart SKUs (Target)')
        },
        "success": function(offer) {
          adobe.target.applyOffer({
            "mbox": "orderConfirmPage",
            "offer": offer
          });
        },
        "error": function(status, error) {
          console.log('Error', status, error);
        }
      });
      
    4. Klicka på Save för att spara den anpassade koden

    5. Klicka på Keep Changes om du vill behålla åtgärden

  7. Klicka på Save to Library and Build

Validera beställningsbekräftelsebegäran

För närvarande är anpassade parametrar som skickas med at.js 2.x-begäranden inte så lätta att se i Felsökning, så vi kommer att använda webbläsarens utvecklingsverktyg.

  1. Öppna Luma-webbplatsen

  2. Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, vilket beskrivs i tidigare lektion

    Din taggutvecklingsmiljö visas i Felsökning

  3. Bläddra på webbplatsen och lägg till flera produkter i kundvagnen

  4. Fortsätt till kassan

  5. Under utcheckningsprocessen är de enda obligatoriska fälten First Name och Last Name

    Ange dummy-värden för förnamn och efternamn

  6. Klicka på knappen Place Order på sidan Granska beställning

  7. Öppna webbläsarens utvecklarverktyg

  8. Klicka på fliken Nätverk

  9. Filtrera begäranden till tt.omtrdc (eller din CNAME-domän för Target-begäranden)

  10. Klicka på den andra begäran

  11. Expandera avsnittet Headers > Request Payload > execute.mboxes.0 för att validera begäransnamnet och orderparametrarna:

inställningar för beställningsförfrågan i felsökaren

Anpassade begäranden

Det finns sällsynta tillfällen när du behöver göra andra Target-begäranden än sidinläsning och beställningsbekräftelsebegäran. Ibland definieras inte viktiga data som du vill använda för personalisering på sidan före taggens inbäddningskoder. De kan vara hårdkodade längst ned på sidan eller returneras från en asynkron API-begäran. Dessa data kan skickas till Target med en extra begäran, men det är inte optimalt att använda denna begäran för innehållsleverans eftersom sidan redan är synlig. Dessa data kan användas för att förbättra besökarprofilen för senare bruk (med hjälp av profilparametrar) eller för att fylla i Recommendations-katalogen.

I dessa fall använder du åtgärden Egen kod i Core-tillägget för att utlösa en begäran med metoderna getOffer()/applyOffer() och trackEvent() . Detta liknar mycket det du gjorde i beställningsbekräftelsebegäran, men du använder bara ett annat begärandenamn och kommer inte att använda de särskilda orderparametrarna. Var noga med att använda åtgärden Load Target innan du gör Target-begäranden från anpassad kod.

Bibliotekshuvud och bibliotekets sidfot

Skärmen Edit at.js i användargränssnittet Target har platser där du kan klistra in anpassad JavaScript som körs omedelbart före eller efter filen at.js. Library Header används ibland för att åsidosätta at.js-inställningarna via
Funktionen targetGlobalSettings() eller skicka data från tredje part med funktionen Data Providers . Library Footer används ibland för att lägga till at.js-avlyssnare för anpassade händelser.

Om du vill replikera den här funktionen i taggar behöver du bara använda åtgärden Anpassad kod i Core-tillägget och sekvensera åtgärden före (Bibliotekshuvud) eller efter (Biblioteksfot) åtgärden Läs in mål. Detta kan göras i samma regel som åtgärden Load Target (se bilden nedan) eller i separata regler med händelser eller orderinställningar som kommer att aktiveras före eller efter regeln som innehåller Load Target:

Bibliotekshuvud och sidfot i åtgärdssekvensen

Mer information om användningsexempel för anpassade sidhuvuden och sidfötter finns i följande resurser:

Nästa"Lägg till Adobe Analytics" >

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2