personalization

Objektet personalization konfigurerar vilka personaliseringsbeslut (erbjudanden eller förslag) som begärs och hur de hanteras i begäran och svaret. Det är särskilt värdefullt i Adobe Target- och Adobe Journey Optimizer-implementeringar, eftersom det är den pådrivande kraften som gör att du kan anpassa visuellt innehåll per användare.

alloy("sendEvent", {
  personalization: {
    decisionScopes: ["hero-banner"],
    surfaces: ["web://example.com"],
    schemas: ["https://ns.adobe.com/personalization/dom-action"],
    sendDisplayEvent: true,
    sendDisplayNotifications: true,
    includePendingDisplayNotifications: true,
    defaultPersonalizationEnabled: false
  },
  renderDecisions: true,
  xdm: adobeDataLayer.getState(reference)
});

Objektet personalization innehåller följande egenskaper:

personalization.decisionScopes

Egenskapen decisionScopes är en matris med strängar som instruerar Web SDK att hämta och returnera personaliseringsbeslut. Varje objekt i arrayen identifierar en plats, kontext eller logisk placering där personaliserat innehåll önskas.

Den här egenskapen är användbar när du uttryckligen vill hämta anpassat innehåll för specifika områden eller komponenter på en sida. Det är särskilt värdefullt i enkelsidiga program som kan kräva olika uppsättningar erbjudanden när användarens navigering eller vy ändras. Du kan också använda den här egenskapen för att optimera prestanda genom att bara hämta erbjudanden för de gränssnittselement som är relevanta för användaren.

personalization: {
  decisionScopes: ["hero-banner", "cart-offer"]
}

I Adobe Target mappas varje beslutsomfattning till en mbox eller aktivitet. I Adobe Journey Optimizer mappas varje beslutsomfång till beslutsbaserade webbplatser eller kampanjer. I Offer Decisioning mappas beslutsomfattningar till vilka erbjudanden eller erbjudanden som besökaren ska ta emot.

personalization.surfaces

Egenskapen surfaces är en matris med ​ yt-URI-strängar som manuellt definierar kanalen, enheten eller kontexten som personalisering begärs från. De gör det möjligt för er att skilja mellan olika digitala upplevelser, som domäner, appar eller enhetsplattform i ert flerkanalssystem. Som standard ligger biblioteket under standardytan från den aktuella sidan. Du kan använda den här egenskapen för att åsidosätta den automatiskt härledda ytan för den aktuella sidan.

Den här egenskapen är värdefull när ni vill använda personalisering över flera kanaler och måste skilja på hur personalisering fungerar mellan olika kanaler. Det gör att ni kan skapa distinkta erbjudanden för olika webbplatser inom samma Adobe Experience Platform-organisation.

personalization: {
  surfaces: ["web://example.com", "web://support.example.com/contact"]
}

Den här egenskapen används till grunden med Adobe Journey Optimizer, eftersom den matchar ytor som skapats i Journey Optimizer-kampanjer och ythantering.

personalization.schemas

Egenskapen schemas är en matris med URI-strängar för schema som filtrerar de typer av personaliseringsinnehåll som begärs från Edge Network. Om du ställer in den här egenskapen begränsas det svar du får från Adobe så att endast erbjudanden som matchar de innehållstypdefinitioner du anger tas med. Om det utelämnas begär biblioteket erbjudanden av alla tillgängliga scheman för de matchade områdena eller ytorna.

Den här egenskapen hjälper till att optimera svarsstorleken och ser till att din webbplats eller ditt program bara får erbjudandetyper som den kan hantera. Det är också användbart när det används med enkelsidiga program som återger anpassat innehåll på ett specifikt sätt (till exempel genom att endast använda DOM-åtgärder eller endast JSON-objekt).

personalization: {
  schemas: [
    "https://ns.adobe.com/personalization/dom-action",
    "https://ns.adobe.com/personalization/html-content-item"
  ]
}

Följande schema-URI:er stöds:

personalization.sendDisplayEvent

Egenskapen sendDisplayEvent är en boolesk egenskap som avgör om en händelse för visningsmeddelanden automatiskt skickas till Edge Network omedelbart efter att anpassat innehåll har återgetts på sidan. Om det utelämnas är standardvärdet true. Ange den här variabeln till false om du inte vill ange att anpassat innehåll har återgetts för visningsspårning.

Det vanligaste användningsfallet när du anger den här variabeln till false är när du planerar att skicka ett annat kommando någon annanstans i implementeringen som flaggar en visningshändelse. Vissa implementeringar har både intrycks- och Analytics-händelser. Den här egenskapen ger dig full kontroll över vilka sendEvent-kommandon som ökar intrycket.

personalization: {
  sendDisplayEvent: true
}

personalization.includePendingDisplayNotifications

Egenskapen includePendingDisplayNotifications är en boolesk egenskap som kontrollerar om väntande visningsmeddelanden paketeras i det aktuella sendEvent-anropet. Väntande visningsmeddelanden är visningar för anpassat innehåll som har återgetts men ännu inte rapporterats till Edge Network som en displayhändelse. Den här egenskapen är användbar när du använder enkelsidiga program, eftersom återgivning av anpassat innehåll och sendEvent anrop kan vara asynkrona för varandra.

Standardvärdet för egenskapen är false. Ange den här egenskapen till true om du vill gruppera och tömma väntande visningsmeddelanden så att deras visningar spelas in korrekt. Synkron implementering, till exempel traditionella webbplatser, behöver vanligtvis inte ange den här egenskapen.

personalization: {
  includePendingDisplayNotifications: true
}

personalization.defaultPersonalizationEnabled

Egenskapen defaultPersonalizationEnabled är en boolesk egenskap som ger dig explicit kontroll över hur Web SDK begär standardområdet för sidomfattande anpassning (__view__) och ytan för det här sendEvent-kommandot. Som standard gäller att SDK på det första sendEvent-kommandot efter en sidinläsning erbjuder standardomfånget för sidövergripande anpassning och tillhörande ytor. Efterföljande sendEvent-kommandon begär inte standardanpassning. Du kan använda den här egenskapen för att åsidosätta det beteendet. Det är värdefullt i applikationsimplementationer på en sida där du kanske vill begära standardanpassning igen när användaren navigerar på webbplatsen. Du kan också använda den här egenskapen när du vill endast skicka en visningshändelse utan att duplicera hämtning av erbjudanden.

personalization: {
  defaultPersonalizationEnabled: false
}

Den här egenskapen använder följande logik beroende på hur den ställs in:

Personalization-komponenter med taggtillägget Web SDK

SDK-taggtillägget för webben för den här egenskapen är avsnittet Personalization när en Send event-åtgärd konfigureras.