Verwalten von Anzeigeereignissen in der Web-SDK

Anzeigeereignisse teilen Personalisierungs- oder Analytics-Services mit, dass dem Benutzer ein bestimmter Teil des personalisierten Inhalts angezeigt wurde. Das Senden von Anzeigeereignissen verbessert die Genauigkeit des Reportings, indem nachgelagerte Systeme dabei helfen, zwischen (angeforderten und tatsächlich Inhalten unterscheiden.

Anzeigeereignisse automatisch senden

Automatische Anzeigeereignisse sind in der Regel die einfachste Option. Sie werden sofort gesendet, nachdem Web SDK das Rendern der zulässigen Inhalte aus der sendEvent abgeschlossen hat, was die Berichtsgenauigkeit verbessern kann.

Um Anzeigeereignisse automatisch zu senden, verwenden Sie einen sendEvent-Aufruf, der renderDecisions auf true setzt und personalization.sendDisplayEvent auf true setzt (oder auslässt, da true der Standard ist):

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

Senden von Anzeigeereignissen in nachfolgenden sendEvent

Die Einbeziehung von Anzeigeereignissen in einen späteren sendEvent ist nützlich, wenn Sie zusätzliche Seitenladedaten anhängen möchten, die bei der Anforderung von Personalisierung nicht verfügbar sind. Er wird häufig bei der Implementierung von Top- und Bottom-Page-Ereignissen verwendet. Wenn Sie Anzeigeereignisse auf diese Weise korrekt implementieren, vermeiden Sie Probleme mit Absprungrate in Adobe Analytics.

Senden von Anzeigeereignissen für manuell gerenderte Vorschläge

Wenn Sie Inhalte selbst rendern (entweder vollständig manuelles Rendern oder applyPropositions), müssen Sie Anzeigeereignisse explizit mit dem Befehl sendEvent senden. Rufen Sie sendEvent mit einer XDM-Payload auf, die die folgenden Eigenschaften enthält:

Die folgenden beiden Beispiele verwenden diese Hilfsfunktion zum Erstellen der XDM-Payload für das Anzeigeereignis:

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

Im folgenden Beispiel wird das manuelle Rendering mit Anzeigeereignissen verwendet:

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

Im folgenden Beispiel wird der Befehl applyPropositions mit Anzeigeereignissen verwendet. Er verkettet sendEvent, applyPropositions und dann eine weitere sendEvent:

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

Häufige zu vermeidende Fehler