Initiera SDK:er
Följ stegen i Initiera SDK-diagrammet för att se till att alla nödvändiga åtgärder som krävs för att läsa in JavaScript-biblioteket Adobe Target at.js körs i rätt sekvens.
Initiera SDK-diagram diagram
För flersidiga program sker det här flödet varje gång sidan läses in igen, eller när besökaren navigerar till en ny sida på webbplatsen.
{width="600" modal="regular"}
Klicka på följande länkar för att navigera till önskade avsnitt:
- 1.1: Läs in besökar-API SDK
- 1.2: Ange kund-ID
- 1.3: Konfigurera automatisk sidinläsningsbegäran
- 1.4: Konfigurera flimmerhantering
- 1.5: Konfigurera datamappning
- 1.6: Kampanj
- 1.7: Cart-baserade kriterier
- 1.8: Popularitetsbaserade kriterier
- 1.9: Objektbaserade kriterier
- 1.10: Användarbaserade villkor
- 1.11: Anpassade villkor
- 1.12: Ange attribut som används i inkluderingsregler
- 1.13: Ange ExcludeIds
- 1.14: Skicka parametern entity.event.detailsOnly=true
- 1.15: Konfigurera fjärrdatamappning
- 1.16: Load at.js
1.1: Läs in besökar-API SDK load
Detta steg hjälper till att säkerställa att biblioteket VisitorAPI.js
läses in, konfigureras och initieras korrekt.
{width="400" modal="regular"}
Förutsättningar
- Om du vill använda besökar-ID/API-tjänsten måste ditt företag vara aktiverat för Adobe Experience Cloud och ha en Organization ID. Mer information finns i Krav för Experience Cloud: Organisations-ID i hjälpen för identitetstjänsten.
- Du behöver filen
VisitorAPI.js
. Du bör redan ha den här filen om du har implementerat Adobe Analytics. Den här filen kan också läggas till med Adobe Experience Platform taggtillägget eller hämtas från Adobe Analytics Code Manager.
Konfigurera och referera till VisitorAPI.js
Mer information finns i Implementera tjänsten Experience Cloud för mål.
Läser
- Översikt över identitetstjänsten i Experience Cloud
- Om ID-tjänsten
- Cookies och Experience Cloud Identity Service
- Så här begär och anger identitetstjänsten i Experience Cloud
- Förstå ID-synkronisering och matchningsfrekvenser
Åtgärder
- Bädda in filen
VisitorAPI.js
på dina webbsidor. - Läs om de tillgängliga konfigurationerna för besökar-ID/API-tjänsten.
- När filen
VisitorAPI.js
har lästs in använder du metodenVisitor.getInstance
för att initiera med de nödvändiga konfigurationer du behöver. - Bekanta dig med de tillgängliga metoderna.
1.2: Ange kund-ID set
Det här steget hjälper dig att se till att dina besökares kända ID:n (CRM-ID, användar-ID o.s.v.) är kopplade till det anonyma ID:t för Adobe för anpassning mellan olika enheter.
{width="400" modal="regular"}
Förutsättningar
- Besökarens kända ID bör vara tillgängligt i datalagret.
Ange kund-ID
Mer information finns i setCustomerID:n.
Läser
Åtgärder
- Använd
visitor.setCustomerIDs
för att ange besökarens kända ID.
Återgå till diagrammet längst upp på den här sidan.
1.3: Konfigurera automatisk sidinläsningsbegäran automatic
I det här steget kan at.js hämta alla upplevelser som måste återges på sidan när JavaScript-biblioteksfilen at.js läses in.
{width="400" modal="regular"}
Förutsättningar
- Alla data i datalagret får inte skickas till Target. Kontakta ert affärsteam (digital marknadsföring) för att ta reda på vilka data som är värdefulla för experiment, optimering och personalisering. Endast dessa data ska skickas till Target.
- Se till att du inte skickar några PII-data (Personally Identiitable Information) till Target.
Konfigurera automatisk sidinläsningsbegäran
Mer information finns i targetGlobalSettings().
Läser
Läs mer om inställningen pageLoadEnabled
i targetGlobalSettings().
Åtgärder
- Ändra objektet
window.targetGlobalSettings
om du vill aktivera automatisk sidinläsning.
1.4: Konfigurera flimmerhantering flicker
Detta steg hjälper till att säkerställa att det inte finns någon sidflimmer när du levererar upplevelser.
{width="400" modal="regular"}
Förutsättningar
- Diskutera med det team som ansvarar för webbsidans prestanda vad gäller fördelar och nackdelar med att styra flimmer med den standardmetod som används av at.js. Du kan söka efter designmönster där du kan använda en anpassad flimmerhanteringslösning, till exempel inläsaranimering. Om du inte hittar något mönster kan du begära ett nytt mönster.
Konfigurera flimmerhantering
Mer information finns i targetGlobalSettings().
Om bodyHidingEnabled
anges till true
döljs hela sidans brödtext medan sidinläsningsbegäran pågår. Om du inte har aktiverat den automatiska sidinläsningsbegäran av någon anledning (data är inte klara senare, till exempel) är det bäst att ange den här inställningen till false
.
Om du har inaktiverat bodyHidingEnabled
eftersom du inte vill utlösa APLR och vill utlösa sidbegäran senare, eller om du inte behöver flimmerhantering, måste du implementera en egen flimmerhantering. Du kan hantera flimmer på två sätt: dölja avsnitten under testet eller genom att visa ett reglage på de avsnitt som testas.
Läser
- Hur at.js hanterar flimmer
- Läs mer om objekten bodyHiddenStyle och bodyHidingEnabled i targetGlobalSettings().
Åtgärder
- Ändra objektet
window.targetGlobalSettings
för att angebodyHiddenStyle
ochbodyHidingEnabled
.
1.5: Konfigurera datamappning data-mapping
Det här steget hjälper till att se till att alla data som måste skickas till Target är angivna.
{width="400" modal="regular"}
Förutsättningar
-
Datalagret ska vara klart med alla data som måste skickas till Target.
-
Recommendations: berika profilen.
- Skicka
entity.id
för att hämta data för nyligen visade villkor och objekt baserat på kriterier som baseras på den senast visade produkten. - Skicka
entity.id
för att hämta data för popularitetskriterier baserat på favoritkategori. - Skicka profilattributet om anpassade villkor är baserade på det eller används i inkluderingsregelfiltrering i alla villkor.
- Skicka
-
Recommendations: importera produktdata.
- Andra entitetsparametrar (reserverade och anpassade) kan skickas till import eller uppdatering av produktkatalogen i Recommendations.
- Produktkatalogen kan också uppdateras med entitetsfeeds med hjälp av användargränssnittet eller API:t Target.
Mappa data tillTarget
Mer information finns i targetPageParams().
Läser
Åtgärder
- Använd funktionen
targetPageParams()
för att ange alla nödvändiga data som måste skickas till Target.
1.6: Kampanj promotion
Lägg till upphöjda objekt och kontrollera deras placering i dina Target Recommendations designer.
Tillgängliga alternativ
- Befordra efter ID
- Befordra efter samling
- Befordra efter attribut
Entitetsparametrar krävs
- Objektattributet i en befordran måste skickas när du använder attributet "Promoby".
Återgå till diagrammet längst upp på den här sidan.
1.7: Cart-baserade kriterier cart
Utför rekommendationer baserat på användarens kundvagnsinnehåll.
Tillgängliga villkor
- People Who Viewed These, Viewed Those
- People Who Viewed These, Bought Those
- People Who Bought These, Bought Those
Entitetsparametrar krävs
- cartIds
Läser
Återgå till diagrammet längst upp på den här sidan.
1.8: Popularitetsbaserade kriterier popularity
Utför rekommendationer baserat på hur populärt ett objekt på webbplatsen är eller utifrån hur populärt det är att ha objekt inom en användares favoritkategori, varumärke, genre osv.
Tillgängliga villkor
- Most Viewed Across the Site
- Most Viewed by Category
- Most Viewed by Item Attribute
- Top Sellers Across the Site
- Top Sellers by Category
- Top Sellers by Item Attribute
- Top by Analytics Metric
Entitetsparametrar krävs
entity.categoryId
eller objektattributet för popularitet baserat på om villkoret är baserat på det aktuella objektet eller objektattributet.- Ingenting får skickas för Most Viewed/Top sålt på webbplatsen.
Läser
1.9: Objektbaserade kriterier item
Rekommendationer baserade på sökning efter liknande objekt för ett objekt som användaren visar eller nyligen har visat.
Tillgängliga villkor
- People Who Viewed This, Viewed That
- People Who Viewed This, Bought That
- People Who Bought This, Bought That
- Items with Similar Attributes
Entitetsparametrar krävs
entity.id
eller ett profilattribut som används som nyckel
Läser
Återgå till diagrammet längst upp på den här sidan.
1.10: Användarbaserade villkor user
Utför rekommendationer baserat på användarens beteende.
Tillgängliga villkor
- Recently Viewed Items
- Recommended for You
Entitetsparametrar krävs
entity.id
Läser
Återgå till diagrammet längst upp på den här sidan.
1.11: Anpassade villkor custom
Utför rekommendationer baserat på en anpassad fil som du överför.
Tillgängliga villkor
- Custom algorithm
Entitetsparametrar krävs
entity.id
eller det attribut som används som nyckel för den anpassade algoritmen
Läser
Återgå till diagrammet längst upp på den här sidan.
1.12: Ange attribut som används i inkluderingsregler inclusion
1.13: Ange ExcludeIds exclude
Skicka enhets-ID:n för entiteter som du vill utesluta från dina rekommendationer. Du kan t.ex. utesluta artiklar som redan finns i kundvagnen.
Återgå till diagrammet längst upp på den här sidan.
1.14: Skicka parametern entity.event.detailsOnly=true
true
Använd entitetsattribut för att skicka produkt- eller innehållsinformation till Target Recommendations.
Läser
Återgå till diagrammet längst upp på den här sidan.
1.15: Konfigurera fjärrdatamappning
Det här steget ser till att alla data som måste skickas till Target har angetts.
{width="400" modal="regular"}
Förutsättningar
- Datalagret ska vara klart med alla data som måste skickas till Target.
Konfigurera dataleverantörer
Mer information finns i Dataleverantörer.
Läser
Åtgärder
Använd funktionen targetPageParams()
för att ange alla nödvändiga data som måste skickas till Target.
Återgå till diagrammet längst upp på den här sidan.
1.16: Load at.js web
Detta steg säkerställer att JavaScript-biblioteket at.js läses in och initieras.
{width="400" modal="regular"}
Förutsättningar
- Hämta eller fråga ditt digitala marknadsföringsteam om JavaScript-biblioteksfilen
at.js 2.*x*
.
Läser
Åtgärder
Bädda in filen at.js på alla dina webbsidor där experimenterande, optimering, personalisering och datainsamling måste ske.
Återgå till diagrammet längst upp på den här sidan.
Fortsätt till steg 2: Konfigurera datainsamling.