Konfigurera Adobe Target med Platform Web SDK

Lär dig implementera Adobe Target med Adobe Experience Platform Web SDK. Lär dig hur du levererar upplevelser och hur du skickar ytterligare parametrar till Target.

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

Utbildningsmål

I slutet av lektionen kan du göra följande med en Web SDK-implementering av Target:

Förhandskrav

För att slutföra lektionerna i det här avsnittet måste du först:

Lägg till flimmerhantering

Innan du startar avgör du om en extra flimmerhanteringslösning krävs beroende på hur taggbiblioteket läses in.

Asynkron implementering

När ett taggbibliotek läses in asynkront kan det hända att sidan sluts återgivningen innan Target har ersatt standardinnehållet med anpassat innehåll. Det här beteendet kan leda till det som kallas"flimmer", där standardinnehållet visas kort innan det ersätts av det anpassade innehållet. Om du vill undvika denna flimmer rekommenderar Adobe att du lägger till ett särskilt fragment som döljs innan den asynkrona taggen bäddar in.

Det här fragmentet finns redan på Luma-webbplatsen, men vi ska titta närmare på vad koden gör:

<script>
  !function(e,a,n,t){var i=e.head;if(i){
  if (a) return;
  var o=e.createElement("style");
  o.id="alloy-prehiding",o.innerText=n,i.appendChild(o),setTimeout(function(){o.parentNode&&o.parentNode.removeChild(o)},t)}}
  (document, document.location.href.indexOf("adobe_authoring_enabled") !== -1, ".personalization-container { opacity: 0 !important }", 3000);
</script>

Det fragment som döljs före skapar en formattagg i sidhuvudet med den CSS-definition som du väljer. Den här stiltaggen tas bort när ett svar från Target tas emot eller när tidsgränsen nås.

Beteendet före döljning styrs av två konfigurationer i slutet av fragmentet.

Det fragment som döljs är också tillgängligt i taggar:

Synkron implementering

Adobe rekommenderar att du implementerar taggar asynkront enligt anvisningarna på Luma-webbplatsen. Men om taggbiblioteket läses in synkront behöver inte det föregående dolda fragmentet användas. I stället anges det fördolda formatet i SDK-tilläggsinställningarna för plattformen.

Stilen för att dölja i förväg för synkrona implementeringar kan konfigureras på följande sätt:

Om du vill veta mer om hur Platform Web SDK kan hantera flimmer kan du läsa hjälpavsnittet: hantera flimmer för personaliserade upplevelser.

Konfigurera datastream

Målet måste vara aktiverat i datastream-konfigurationen innan målaktiviteter kan levereras av Platform Web SDK.

Så här konfigurerar du Target i datastream:

Egenskapstoken

Målgrupper för Premium-kunder kan hantera användarbehörigheter med egenskaper. Med målegenskaper kan du skapa gränser runt var användare kan köra Target-aktiviteter. Mer information finns i avsnittet Företagsbehörigheter i måldokumentationen.

Navigera till Adobe Target > Administration > Properties om du vill konfigurera eller söka efter egenskapstoken. Ikonen </> visar implementeringskoden. Värdet at_property är den egenskapstoken som du skulle använda i din datastream.

Endast en egenskapstoken kan anges per datastream, men med åsidosättningar av egenskapstoken kan du ange alternativa egenskapstoken som ersätter den primära egenskapstoken som definierats i datastream. En uppdatering av sendEvent-åtgärden krävs också för att åsidosätta datastream.

Målmiljö-ID

Med miljöer i Target kan du hantera implementeringen i alla utvecklingsfaser. Den här valfria inställningen anger vilken målmiljö du ska använda för varje datastream.

Adobe rekommenderar att du ställer in målmiljö-ID på olika sätt för alla dina dataströmmar för utveckling, staging och produktion för att göra det enkelt. Du kan också ordna dina miljöer i målgränssnittet med funktionen hosts .

Navigera till Adobe Target > Administration > Environments för att konfigurera eller hitta miljö-ID:n.

Målnamnområde för tredjeparts-ID

Med den här valfria inställningen kan du ange vilken identitetssymbol som ska användas för mål-ID:t för tredje part. Target stöder bara profilsynkronisering för en enskild identitetssymbol eller ett namnutrymme. Mer information finns i avsnittet Synkronisering av realtidsprofiler för mbox3rdPartyId i målguiden.

Identitetssymbolerna finns i identitetslistan under Datainsamling > Customer > Identities.

I den här självstudiekursen med Luma-webbplatsen använder du den identitetssymbol lumaCrmId som ställdes in under lektionen om Identiteter.

Ge visuella personaliseringsbeslut

De visuella personaliseringsbesluten avser de upplevelser som har skapats i Adobe Target Visual Experience Composer. För det första bör du förstå terminologin som används i Target- och tagggränssnitten:

Uppdatera åtgärden Send event

Visuella personaliseringsbeslut från Target levereras av Platform Web SDK, om Target är aktiverat i datastream. De återges dock inte automatiskt. Du måste uppdatera åtgärden Send event för att aktivera automatisk återgivning.

Inställningen för beslut om visuell återgivning gör att Platform Web SDK automatiskt tillämpar de ändringar som har angetts med Target Visual Experience Composer eller"global mbox".

Om du föredrar att själv återge eller vidta åtgärder för de här besluten med egen kod kan du låta inställningen Render visual personalization decisions vara inaktiverad. Platform Web SDK är flexibelt och ger dig fullständig kontroll. Mer information om att återge anpassat innehåll manuellt finns i handboken.

Konfigurera en Target-aktivitet med Visual Experience Composer

Nu när den grundläggande implementeringsdelen är klar skapar du en XT-aktivitet (Experience Targeting) i Target för att kontrollera att allt fungerar som det ska. Om du behöver hjälp kan du hänvisa till målsjälvstudiekursen för att skapa aktiviteter för Experience Targeting.

Validera med felsökaren

Om du ställer in en aktivitet bör du se innehållet renderas på sidan. Men även om inga aktiviteter är aktiva kan du kontrollera att Target är korrekt konfigurerat genom att titta på nätverksanropet för Skicka händelse.

Konfigurera och återge ett anpassat beslutsutrymme

Anpassade beslutsomfattningar (tidigare kallade"mboxes") kan användas för att leverera HTML- eller JSON-innehåll på ett strukturerat sätt med den Target-formulärbaserade Experience Composer. Innehåll som levereras till något av dessa anpassade omfång återges inte automatiskt av Platform Web SDK. Den kan återges med en åtgärd i Taggar.

Lägg till ett omfång i Send event action

Ändra sidans inläsningsregel för att lägga till ett anpassat beslutsomfång:

Bearbeta svaret från Target

Nu när du har konfigurerat Platform Web SDK att begära innehåll för scopet homepage-hero måste du göra något med svaret. Platsens SDK-taggtillägg innehåller en Send Event Complete-händelse som kan användas för att omedelbart aktivera en ny regel när ett svar från en Send Event-åtgärd tas emot.

Konfigurera en Target-aktivitet med den formulärbaserade Experience Composer

Nu när du har en regel för att manuellt återge ett anpassat beslutsområde kan du skapa en annan XT-aktivitet (Experience Targeting) i Target. Den här gången använder du den formulärbaserade Experience Composer.

Validera med felsökaren

Om du har aktiverat din aktivitet bör du se innehållet återges på sidan. Men även om inga aktiviteter är aktiva kan du titta på Send Event-nätverksanropet för att bekräfta att Target begär innehåll för dina anpassade omfattningar.

Skicka parametrar till mål

I det här avsnittet skickar du Target-specifika data och tar en närmare titt på hur XDM-data mappas till Target-parametrar.

Sidparametrar (mbox) och XDM

Alla XDM-fält skickas automatiskt till Target som sidparametrar eller mbox-parametrar.

Vissa av dessa XDM-fält mappas till specialobjekt i Target serverdel. web.webPageDetails.URL kommer till exempel automatiskt att vara tillgänglig för att skapa URL-baserade målinriktningsvillkor eller som objektet page.url när profilskript skapas.

Du kan också lägga till sidparametrar med dataobjektet.

Särskilda parametrar och dataobjektet

Det finns vissa datapunkter som kan vara användbara för Target som inte har mappats från XDM-objektet. Dessa speciella Target-parametrar inkluderar:

Parametrarna måste skickas i objektet data i stället för i objektet xdm. Dessutom kan sidparametrar (eller mbox-parametrar) också inkluderas i objektet data.

Om du vill fylla i dataobjektet skapar du följande dataelement och återanvänder dataelement som skapats i lektionen Skapa dataelement:

Uppdatera sidans inläsningsregel

Om ytterligare data för Target skickas utanför XDM-objektet måste tillämpliga regler uppdateras. I det här exemplet är den enda ändringen du måste göra att inkludera det nya dataelementet data.content i den allmänna sidinläsningsregeln och produktsidans visningsregel.

Dela upp förfrågningar från Personalization och Analytics

Datalagret på Luma-webbplatsen definieras fullständigt innan taggarna bäddar in kod. Detta gör att vi kan använda ett enda anrop för att både hämta personaliserat innehåll (t.ex. från Adobe Target) och skicka analysdata (t.ex. till Adobe Analytics).

På många webbplatser kan datalagret dock inte läsas in tillräckligt tidigt eller tillräckligt snabbt för att använda ett enda anrop för båda programmen. I sådana fall kan du använda två Send event-åtgärder på en enda sidinläsning och använda den första för personalisering och den andra för analys. Genom att dela upp händelserna på det här sättet kan personaliseringshändelsen utlösas så tidigt som möjligt, samtidigt som datalagret läses in helt innan Analytics-händelsen skickas. Detta liknar många SDK-implementeringar som gjorts före webben, där Adobe Target utlöser target-global-mbox högst upp på sidan och Adobe Analytics utlöser s.t()-anropet längst ned på sidan

Så här skapar du en begäran om anpassning överst:

Så här skapar du en begäran som baseras på analys:

Validera med felsökaren

Nu när reglerna har uppdaterats kan du validera om data skickas korrekt med Adobe Debugger.

Validera i målgränssnittet

Titta sedan i Target-gränssnittet för att bekräfta att data har tagits emot och är tillgängliga för användning i målgrupper och aktiviteter. XDM-data mappas automatiskt till anpassade Target-parametrar. Du kan validera att XDM-data har tagits emot av Target och är tillgängliga genom att skapa en målgrupp.

Verifiera sedan att attributet för inloggningstillståndsprofilen har skickats.

Om du har Target Premium kan du även validera att entitetsdata skickades korrekt och att produktdata skrevs till Recommendations produktkatalog.

Validera med Assurance

Dessutom kan du använda Assurance där det är lämpligt för att bekräfta att målbeslutsbegäranden hämtar rätt data och att eventuella serveromvandlingar sker korrekt. Du kan också bekräfta att kampanj- och upplevelseinformation finns i Adobe Analytics-anropen även när Target-beslutet och Adobe Analytics-anrop skickas separat.

Detta bekräftar att A4T-informationen som ställdes i kö för senare överföring när vi gjorde målbeslutsanropet skickades korrekt när analysspårningsanropet utlöstes senare på sidan.

Nu när du är klar med den här lektionen bör du ha en fungerande implementering av Adobe Target med Platform Web SDK.

Nästa: