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 den Adobe Experience Cloud-applikation som innehåller allt ni behöver för att skräddarsy och personalisera kundupplevelsen, så att ni kan maximera intäkterna på era 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örutsättningar

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. Se Enterprise permissions i Target-dokumentationen för mer information.

Om du vill konfigurera eller söka efter egenskapstoken går du till Adobe Target > Administration > Properties. The </> -ikonen visar implementeringskoden. The at_property värde ä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ärd krävs också för att åsidosätta datastream.

Målmiljö-ID

Miljö i Target hjälper er att 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 Target-gränssnittet med hjälp av värdar -funktion.

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

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 Synkronisering av realtidsprofiler för mbox3rdPartyId i målguiden.

Identitetssymbolerna finns i identitetslistan under Datainsamling > Customer > Identities.

I den här självstudiekursen om du vill använda Luma-webbplatsen använder du identitetssymbolen lumaCrmId 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 Send event åtgärd

Visuella personaliseringsbeslut från Target levereras av Platform Web SDK, om Target är aktiverat i datastream. Men de återges inte automatiskt. Du måste uppdatera Send event åtgärd 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 själv föredrar att återge eller vidta åtgärder för dessa beslut med egen kod kan du lämna Render visual personalization decisions inställningen inaktiverad. Platform Web SDK är flexibelt och ger dig fullständig kontroll. Mer information om manuellt återge anpassat innehåll.

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. Du kan använda självstudiekursen Mål för skapa aktiviteter för Experience Targeting om du behöver hjälp.

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 för att begära innehåll för homepage-hero måste du göra något med svaret. Taggtillägget Platform Web SDK ger 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ärden har tagits 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. Även om inga aktiviteter finns tillgängliga kan du titta på Send Event nätverksanrop 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. Till exempel: web.webPageDetails.URL kommer automatiskt att vara tillgängligt för att skapa URL-baserade villkor för målinriktning eller som page.url när du skapar profilskript.

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:

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

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

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 den nya data.content dataelement till den allmänna sidinläsningsregeln och visningsregeln för produktsidor.

Dela upp personaliserings- och analysförfrågningar

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 dessa situationer kan du använda två Send event åtgärder på en enda sida laddas och används 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 skulle starta target-global-mbox överst på sidan så avfyrar Adobe Analytics s.t() ring 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: