DokumentationTargetTarget Developer Guide

Initiera SDK:er

Senast uppdaterad: 5 maj 2025
  • Ämnen:
  • APIs/SDKs

Skapat för:

  • Erfaren
  • Utvecklare

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.

TIPS
Klicka på bilderna i det här avsnittet för att utöka till helskärm.

Initiera SDK-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.

OBSERVERA
Stegnumren i följande bild motsvarar avsnitten nedan. Stegnumren är inte i någon speciell ordning och återspeglar inte ordningen på steg som vidtas i användargränssnittet för Target när aktiviteten skapas.

Initiera SDK-diagram

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

Detta steg hjälper till att säkerställa att biblioteket VisitorAPI.js läses in, konfigureras och initieras korrekt.

Se information

Läs in SDK-diagram för Visitor-API

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 metoden Visitor.getInstance för att initiera med de nödvändiga konfigurationer du behöver.
  • Bekanta dig med de tillgängliga metoderna.

Återgå till diagrammet längst upp på den här sidan.

1.2: Ange kund-ID

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.

Se information

Ange kund-ID

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

  • Profilsynkronisering i realtid för mbox3rdPartyId

Å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

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.

Se information

Konfigurera automatisk sidinläsningsbegäran

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.

Återgå till diagrammet längst upp på den här sidan.

1.4: Konfigurera flimmerhantering

Detta steg hjälper till att säkerställa att det inte finns någon sidflimmer när du levererar upplevelser.

Se information

Konfigurera flimmerhanteringsdiagram

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 ange bodyHiddenStyle och bodyHidingEnabled.

Återgå till diagrammet längst upp på den här sidan.

1.5: Konfigurera datamappning

Det här steget hjälper till att se till att alla data som måste skickas till Target är angivna.

Se information

Datamappningsdiagram

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.
  • 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

  • targetPageParams()
  • Planera och implementera Recommendations
  • Konfigurera Recommendations-katalogen

Å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.6: Kampanj

Lägg till upphöjda objekt och kontrollera deras placering i dina Target Recommendations designer.

Se information

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

Utför rekommendationer baserat på användarens kundvagnsinnehåll.

Se information

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

  • Kundvagnsbaserad

Återgå till diagrammet längst upp på den här sidan.

1.8: Popularitetsbaserade kriterier

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.

Se information

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

  • Popularitetsbaserad

Återgå till diagrammet längst upp på den här sidan.

1.9: Objektbaserade kriterier

Rekommendationer baserade på sökning efter liknande objekt för ett objekt som användaren visar eller nyligen har visat.

Se information

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

  • Objektbaserad

Återgå till diagrammet längst upp på den här sidan.

1.10: Användarbaserade villkor

Utför rekommendationer baserat på användarens beteende.

Se information

Tillgängliga villkor

  • Recently Viewed Items
  • Recommended for You

Entitetsparametrar krävs

  • entity.id

Läser

  • Användarbaserad

Återgå till diagrammet längst upp på den här sidan.

1.11: Anpassade villkor

Utför rekommendationer baserat på en anpassad fil som du överför.

Se information

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

  • Anpassade villkor

Återgå till diagrammet längst upp på den här sidan.

1.12: Ange attribut som används i inkluderingsregler

Se information

Läser

  • Använd dynamiska och statiska inkluderingsregler

Återgå till diagrammet längst upp på den här sidan.

1.13: Ange ExcludeIds

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.

Se information

Läser

  • Kan jag utesluta en entitet dynamiskt?

Återgå till diagrammet längst upp på den här sidan.

1.14: Skicka parametern entity.event.detailsOnly=true

Använd entitetsattribut för att skicka produkt- eller innehållsinformation till Target Recommendations.

Se information

Läser

  • Entitetsattribut

Å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.

Se information

Diagram över fjärrdatamappning

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

Funktionen targetPageParams

Å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

Detta steg säkerställer att JavaScript-biblioteket at.js läses in och initieras.

Se information

Läs in Adobe Target at.js-diagram

Förutsättningar

  • Hämta eller fråga ditt digitala marknadsföringsteam om JavaScript-biblioteksfilen at.js 2.*x*.

Läser

  • Så fungerar Target
  • Hur at.js fungerar
  • Implementera mål utan tagghanterare

Å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.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3