Weergavegebeurtenissen beheren in de Web SDK

De gebeurtenissen van de vertoning vertellen verpersoonlijking of analysediensten dat een specifiek stuk van gepersonaliseerde inhoud aan de gebruiker werd getoond. Het verzenden van vertoningsgebeurtenissen verbetert rapporteringsnauwkeurigheid door stroomafwaartse systemen te helpen tussen inhoud onderscheiden die ​ en inhoud werd gevraagd die ​ eigenlijk werd getoond.

Weergavegebeurtenissen automatisch verzenden

Automatische weergavegebeurtenissen zijn doorgaans de eenvoudigste optie. Ze worden direct verzonden nadat Web SDK klaar is met het renderen van in aanmerking komende inhoud uit het sendEvent -antwoord, waardoor de rapportnauwkeurigheid kan worden verbeterd.

Als u weergavegebeurtenissen automatisch wilt verzenden, gebruikt u een sendEvent -aanroep die renderDecisions op true instelt en personalization.sendDisplayEvent op true instelt (of weglaat, aangezien true de standaardwaarde is):

alloy("sendEvent", {
  renderDecisions: true,
  personalization: { }, // sendDisplayEvent defaults to true
  xdm: {
    web: {
      webPageDetails: {
        name: "home"
      }
    }
  }
});

Weergavegebeurtenissen verzenden in volgende sendEvent oproepen

Het opnemen van weergavegebeurtenissen in een latere aanroep van sendEvent is handig als u extra laadgegevens voor de pagina wilt toevoegen die niet beschikbaar zijn wanneer u om personalisatie vraagt. Het wordt algemeen gebruikt wanneer het uitvoeren van ​ Hoogste en bodempaginagebeurtenissen ​. Correct het uitvoeren van vertoningsgebeurtenissen op deze manier helpt kwesties met ​ Stuiteren tarief ​ in Adobe Analytics vermijden.

Weergavegebeurtenissen verzenden voor handmatig gerenderde profielen

Als u inhoud zelf rendert (volledig handmatig renderen of met applyPropositions ), moet u weergavegebeurtenissen expliciet verzenden met de opdracht sendEvent . Roep sendEvent aan met een XDM-lading die de volgende eigenschappen bevat:

In de volgende twee voorbeelden wordt deze hulpfunctie gebruikt om de weergavegebeurtenis XDM payload te bouwen:

function buildDisplayEventXdm(renderedPropositions) {
  return {
    eventType: "decisioning.propositionDisplay",
    _experience: {
      decisioning: {
        propositions: renderedPropositions.map(({ id, scope, scopeDetails }) => ({
          id,
          scope,
          scopeDetails
        })),
        propositionEventType: { display: 1 }
      }
    }
  };
}

In het volgende voorbeeld wordt handmatig renderen met weergavegebeurtenissen gebruikt:

function renderExample(propositions) {
  // Your custom logic here. Return ONLY the propositions that were actually rendered.
  // For example: return [propositions[0]];
  return [];
}

alloy("sendEvent", {
  personalization: { decisionScopes: ["discount"] },
  xdm: { }
}).then(({ propositions = [] }) => {
  const renderedPropositions = renderExample(propositions);
  if (!renderedPropositions.length) { return; }
  return alloy("sendEvent", { xdm: buildDisplayEventXdm(renderedPropositions) });
});

In het volgende voorbeeld wordt de opdracht applyPropositions gebruikt met weergavegebeurtenissen. sendEvent, applyPropositions en een ander sendEvent worden samen geketend:

alloy("sendEvent", {
  personalization: { decisionScopes: ["discount", "salutation"] },
  xdm: { }
}).then(({ propositions = [] }) => {
  return alloy("applyPropositions", {
    propositions,
    metadata: {
      salutation: { selector: "#salutation", actionType: "setHtml" },
      discount: { selector: "#daily-special", actionType: "replaceHtml" }
    }
  });
}).then(({ propositions: renderedPropositions = [] }) => {
  if (!renderedPropositions.length) { return; }
  return alloy("sendEvent", { xdm: buildDisplayEventXdm(renderedPropositions) });
});

Gemeenschappelijke fouten om te vermijden