personalization

Het personalization -object configureert welke verpersoonlijkingsbesluiten (aanbiedingen of voorstellen) worden aangevraagd en hoe deze in de aanvraag en het antwoord worden verwerkt. Deze functie is vooral handig bij Adobe Target- of Adobe Journey Optimizer-implementaties, omdat u hiermee de weergegeven inhoud per gebruiker kunt aanpassen.

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)
});

Het personalization -object bevat de volgende eigenschappen:

personalization.decisionScopes

De eigenschap decisionScopes is een array van tekenreeksen die de Web SDK opdraagt om aanpassingsbeslissingen op te halen en te retourneren. Elk item in de array identificeert een locatie, context of logische plaatsing waar gepersonaliseerde inhoud gewenst is.

Deze eigenschap is handig wanneer u expliciet gepersonaliseerde inhoud wilt ophalen voor specifieke gebieden of componenten van een pagina. Het is vooral waardevol in single-page toepassingen die verschillende reeksen aanbiedingen zouden kunnen vereisen aangezien de navigatie of de mening van de gebruiker verandert. U kunt deze eigenschap ook gebruiken om de prestaties te optimaliseren door alleen aanbiedingen voor de interface-elementen op te halen die relevant zijn voor de gebruiker.

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

In Adobe Target wordt elk beslissingsbereik toegewezen aan een box of activiteit. In Adobe Journey Optimizer wordt elk beslissingsbereik toegewezen aan op beslissingen gebaseerde webinhoud-plaatsingen of -campagnes. In Offer Decisioning wordt een overzicht gegeven van de besluitvormingsgebieden waarop de bezoeker voorstellen of voorstellen kan ontvangen.

personalization.surfaces

Het surfaces bezit is een serie van ​ oppervlakte URI ​ koorden die manueel het kanaal, het apparaat, of de context bepalen waarvan verpersoonlijking wordt gevraagd. Hiermee kunt u onderscheid maken tussen verschillende digitale ervaringen, zoals domeinen, apps of apparaatplatform binnen uw kanaalecosysteem. Standaard wordt het standaardoppervlak van de huidige pagina door de bibliotheek opgehaald. U kunt deze eigenschap gebruiken om het automatisch gegenereerde oppervlak voor de huidige pagina te overschrijven.

Dit bezit is waardevol wanneer u kanaalverpersoonlijking wilt gebruiken en moet onderscheiden hoe de verpersoonlijking tussen afzonderlijke kanalen werkt. Hiermee kunt u verschillende aanbiedingen maken voor verschillende sites onder dezelfde Adobe Experience Platform-organisatie.

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

Deze eigenschap wordt voornamelijk gebruikt bij Adobe Journey Optimizer omdat deze overeenkomt met oppervlakken die zijn ingesteld in Journey Optimizer-campagnes en oppervlakbeheer.

personalization.schemas

De eigenschap schemas is een array van schema-URI-tekenreeksen die de typen personalisatie-inhoud filteren die van de Edge Network worden gevraagd. Als u deze eigenschap instelt, wordt het antwoord dat u van Adobe ontvangt, beperkt tot alleen aanbiedingen die overeenkomen met de definities van het inhoudstype die u opgeeft. Als u deze optie weglaat, worden in de bibliotheek alle beschikbare schema's voor het overeenkomende bereik of de overeenkomende oppervlakken opgevraagd.

Met deze eigenschap kunt u de responsgrootte optimaliseren en ervoor zorgen dat uw website of toepassing alleen aanbiedingstypen ontvangt die deze kan verwerken. Het is ook handig als u toepassingen van één pagina gebruikt die gepersonaliseerde inhoud op een specifieke manier renderen (zoals alleen DOM-handelingen of alleen JSON-objecten).

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

De volgende schema-URI's worden ondersteund:

personalization.sendDisplayEvent

De eigenschap sendDisplayEvent is een Booleaanse waarde die bepaalt of een weergavemeldingsgebeurtenis automatisch naar de Edge Network wordt verzonden direct nadat persoonlijke inhoud op de pagina is gerenderd. Als deze waarde wordt weggelaten, is de standaardwaarde true . Stel deze variabele in op false als u niet wilt aangeven dat gepersonaliseerde inhoud is gerenderd voor het bijhouden van de indruk.

Het meest gebruikte geval voor het instellen van deze variabele op false is wanneer u een andere opdracht elders in de implementatie wilt verzenden die een weergavegebeurtenis markeert. Sommige implementaties hebben zowel indruk- als analytische gebeurtenissen. Deze eigenschap geeft u de volledige controle over welke sendEvent -opdrachten de increment impressies verhogen.

personalization: {
  sendDisplayEvent: true
}

personalization.includePendingDisplayNotifications

De eigenschap includePendingDisplayNotifications is een Booleaanse waarde die bepaalt of weergavemeldingen die in behandeling zijn, worden gebundeld in de huidige sendEvent -aanroep. In afwachting van weergavemeldingen zijn afbeeldingen van gepersonaliseerde inhoud die wel zijn gerenderd, maar nog niet als weergavegebeurtenis aan de Edge Network zijn gerapporteerd. Deze eigenschap is handig bij het gebruik van toepassingen van één pagina, omdat het renderen van gepersonaliseerde inhoud en sendEvent -aanroepen asynchroon met elkaar kunnen zijn.

De standaardwaarde voor deze eigenschap is false . Stel deze eigenschap in op true als u alle weergavemeldingen die in behandeling zijn, wilt batchgewijs en leegmaken, zodat de indrukkingen ervan op de juiste wijze worden opgenomen. Synchrone implementatie, zoals traditionele websites, hoeft deze eigenschap gewoonlijk niet in te stellen.

personalization: {
  includePendingDisplayNotifications: true
}

personalization.defaultPersonalizationEnabled

De eigenschap defaultPersonalizationEnabled is een Booleaanse waarde die u expliciete controle geeft over de manier waarop de Web SDK het standaardverpersoonlijkingsbereik (__view__) voor de hele pagina aanvraagt en het oppervlak voor deze sendEvent opdracht. Standaard biedt de Web SDK-aanvraag voor de eerste sendEvent -opdracht na het laden van een pagina het standaardverpersoonlijkingsbereik voor de hele pagina en de bijbehorende oppervlakken aan. Volgende sendEvent -opdrachten vragen niet om standaardaanpassing. U kunt deze eigenschap gebruiken om dat gedrag te overschrijven. Het is nuttig in toepassingsimplementaties van één pagina waar u standaardverpersoonlijking opnieuw zou kunnen willen vragen aangezien de gebruiker uw plaats navigeert. U kunt dit bezit ook gebruiken wanneer u slechts een vertoningsgebeurtenis wilt verzenden zonder aanbiedingsherwinning te dupliceren.

personalization: {
  defaultPersonalizationEnabled: false
}

Deze eigenschap gebruikt de volgende logica, afhankelijk van de manier waarop deze is ingesteld:

Personalization-componenten die de Web SDK-tagextensie gebruiken

Het equivalent van de de marktextensie van SDK van het Web van dit bezit is de Personalization sectie wanneer het vormen van een "Send event"actie.