Vorm bovenkant en bodem van paginagebeurtenissen in Web SDK

Laatst bijgewerkt: 16 juli 2024
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Wanneer u uw klanten persoonlijke ervaringen wilt bieden, is de laadtijd van een webpagina van essentieel belang.

Om de ladingstijden te optimaliseren en verpersoonlijking zo snel mogelijk te leveren, steunt SDK van het Web de configuratie van bovenkant en bodem van paginagebeurtenissen.

Boven en onder aan paginagebeurtenissen wordt een methode beschreven voor het asynchroon laden van verschillende elementen op de pagina, terwijl de laadtijd van de pagina tot een minimum wordt beperkt.

Deze configuratie minimaliseert de hoeveelheid tijd een gebruiker moet wachten tot de gepersonaliseerde inhoud wordt geladen.

Wat de meetnauwkeurigheid betreft, kan Adobe Analytics gebeurtenissen boven aan de pagina negeren. Dit leidt tot nauwkeurigere meetgegevens, aangezien slechts één paginakit wordt opgenomen (de onderkant van de paginagebeurtenis).

Gebruiksscenario’s

Een detailhandelaar in sportkleding wil hun klanten persoonlijke ervaringen bieden, terwijl de wrijving van de gebruiker bij het bezoeken van hun website tot een minimum wordt beperkt, terwijl hij tegelijkertijd de meetgegevens van de bezoeker nauwkeurig kan verzamelen.

Door bovenkant en bodem van paginagebeurtenissen in Web SDK te gebruiken, kan het marketing team hun verpersoonlijkingslevering op de meest optimale manier vormen:

  • Web SDK verzendt een verpersoonlijkingsverzoek dat wordt geladen zodra de pagina begint te laden. Dit is een top van page-gebeurtenis.
  • Wanneer de pagina klaar is met laden, wordt een gebeurtenis in de paginaweergave opgenomen. Dit gebeurt later tijdens het laden van de pagina. Dit is een onderkant van een paginagebeurtenis.

Boven aan pagina, gebeurtenisvoorbeeld

De codesteekproef hieronder illustreert een bovenkant van de configuratie van de paginagebeurtenis die om verpersoonlijking verzoekt maar niet vertoningsgebeurtenissenvoor automatisch teruggegeven voorstellingen verzendt. De vertoningsgebeurtenissenzullen als deel van de bodem-van-pagina gebeurtenis worden verzonden.

alloy("sendEvent", {
  type: "decisioning.propositionFetch",
  renderDecisions: true,
  personalization: {
    sendDisplayEvent: false
  }
});
ParamterVereist/optioneelBeschrijving
typeVereistStel deze parameter in op decisioning.propositionFetch . Dit speciale gebeurtenistype instrueert Adobe Analytics deze gebeurtenis te laten vallen. Wanneer u Customer Journey Analytics gebruikt, kunt u ook een filter instellen om deze gebeurtenissen neer te zetten.
renderDecisionsVereistStel deze parameter in op true . Deze parameter vertelt Web SDK om besluiten terug te geven die door de Edge Network zijn teruggekeerd.
personalization.sendDisplayEventVereistStel deze parameter in op false . Hiermee voorkomt u dat weergavegebeurtenissen worden verzonden.

Voorbeelden van gebeurtenissen onder aan pagina

De codesteekproef hieronder illustreert een bodem van de configuratie van de paginagebeurtenis die vertoningsgebeurtenissen voor voorstellingen verzendt die automatisch op de pagina werden teruggegeven maar waarvoor de vertoningsgebeurtenissen in bovenkant van paginagebeurtenis werden onderdrukt.

NOTE
In dit scenario, moet u de bodem van paginagebeurtenis na de bovenkant van pagina één roepen. De onderzijde van de gebeurtenis page hoeft echter niet te wachten tot de bovenzijde van pagina één is voltooid.
alloy("sendEvent", {
  personalization: {
    includeRenderedPropositions: true
  },
  xdm: { ... }
});
ParameterVereist/optioneelBeschrijving
personalization.includeRenderedPropositionsVereistStel deze parameter in op true . Hierdoor kunnen weergavegebeurtenissen worden verzonden die boven aan de paginagebeurtenis zijn onderdrukt.
xdmOptioneelGebruik deze sectie om alle gegevens op te nemen die u onder aan de paginagebeurtenis nodig hebt.

In het onderstaande codevoorbeeld ziet u een onderkant van de configuratie van een paginagebeurtenis die weergavegebeurtenissen verzendt voor voorstellen die handmatig op de pagina zijn weergegeven (bijvoorbeeld voor aangepaste beslissingsbereiken of oppervlakken).

NOTE
In dit scenario moet de onderkant van de paginagebeurtenis wachten tot de gebeurtenis boven aan de pagina is voltooid. Zo kunt u de voorstellen renderen en de onderkant van de paginagebeurtenis opnemen.
alloy("sendEvent", {
  xdm: {
    ... // Optional bottom of page event data
    _experience: {
      decisioning: {
        propositions: propositions.map(function(p) {
          return {
            id: p.id,
            scope: p.scope,
            scopeDetails: p.scopeDetails
          };
        }),
        propositionEventType: {
          display: 1
        }
      }
    }
  }
});
ParamterVereist/optioneelBeschrijving
xdm._experience.decisioning.propositionsVereistDeze sectie bepaalt manueel teruggegeven voorstellingen. U moet de voorstelling ID , scope en scopeDetails opnemen. Zie de documentatie op hoe te verpersoonlijkingvoor meer informatie manueel teruggeven over hoe te om vertoningsgebeurtenissen voor manueel teruggegeven inhoud te registreren. Handmatig gerenderde verpersoonlijkingsinhoud moet onder aan de paginaklok worden opgenomen.
xdm._experience.decisioning.propositionEventTypeVereistStel deze parameter in op display: 1 .
xdmOptioneelGebruik deze sectie om alle gegevens op te nemen die u onder aan de paginagebeurtenis nodig hebt.

Toepassing van één pagina met bovenkant en onderste paginakijken

In het onderstaande voorbeeld wordt de parameter xdm.web.webPageDetails.viewName toegevoegd. Dit is wat het tot één-paginatoepassing maakt. De viewName in dit voorbeeld is de weergave die wordt geladen op de pagina die wordt geladen.

// Top of page, render decisions for the "home" view.
alloy("sendEvent", {
    type: "decisioning.propositionFetch",
    renderDecisions: true,
    personalization: {
        sendDisplayEvent: false
    },
    xdm: {
        web: {
            webPageDetails: {
                viewName: "home"
            }
        }
    }
});

// Bottom of page, send display events for the items that were rendered.
// Note: You need to include the viewName in both top and bottom of page so that the
// correct view is rendered at the top of the page, and the correct view is recorded
// at the bottom of the page.

alloy("sendEvent", {
    personalization: {
        includeRenderedPropositions: true
    },
    xdm: {
        ...,
        web: {
            webPageDetails: {
                viewName: "home"
            }
        }
    }
});

In dit voorbeeld is het niet nodig om boven/onder pagina te splitsen, omdat de personalisatie voor de pagina al is opgehaald.

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    ...,
    web: {
      webPageDetails: {
        viewName: "cart"
      }
    }
  }
});

Als u nog steeds de onderkant van een paginaklok moet vertragen, kunt u applyPropositions gebruiken voor de bovenkant van een paginaklok. Aangezien geen verpersoonlijking moet worden opgehaald en geen Analytische gegevens moeten worden geregistreerd, is het niet nodig om een verzoek aan de Edge Network te richten.

// top of page, render the decisions already fetched for the "cart" view.
alloy("applyPropositions", {
    viewName: "cart"
});

// bottom of page, send display events for the items that were rendered.
// Note: You need to include the viewName in both top and bottom of page so that the
// correct view is rendered at the top of the page, and the correct view is recorded
// at the bottom of the page.
alloy("sendEvent", {
    personalization: {
        includeRenderedPropositions: true
    },
    xdm: {
        ...,
        web: {
            webPageDetails: {
                viewName: "cart"
            }
        }
    }
});