文档Experience Platform数据收集

在Web SDK中管理显示事件

Last update: Fri Feb 13 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 开发人员

显示事件可告知个性化服务或Analytics服务，已向用户显示了特定的个性化内容。 发送显示事件有助于下游系统区分​ 请求的内容 ​和​实际显示的内容，从而提高报表准确性。

自动发送显示事件

自动显示事件通常是最简单的选项。 它们在Web SDK从sendEvent响应中完成合格内容的渲染后立即发送，这可以提高报表准确性。

要自动发送显示事件，请使用将sendEvent设置为renderDecisions并将true设置为personalization.sendDisplayEvent的true调用（或省略，因为true是默认值）：

alloy("sendEvent", {
  renderDecisions: true,
  personalization: { }, // sendDisplayEvent defaults to true
  xdm: {
    web: {
      webPageDetails: {
        name: "home"
      }
    }
  }
});
NOTE
自动显示事件取决于SDK管理的渲染。 如果您手动渲染内容（包括使用applyPropositions），则必须使用sendEvent显式发送显示事件。

在后续sendEvent调用中发送显示事件

当您想要附加在请求个性化时不可用的其他页面加载数据时，在稍后的sendEvent调用中包含显示事件会很有用。 常用于实现顶页面事件和底页面事件。 以这种方式正确实施显示事件有助于避免Adobe Analytics中的跳出率出现问题。

  1. 在初始sendEvent调用（通常在页面顶部）中，请求并渲染内容，但通过将renderDecisions设置为true并将personalization.sendDisplayEvent设置为false来禁止自动显示事件：

    code language-js 
    alloy("sendEvent", {
  renderDecisions: true,
  personalization: { sendDisplayEvent: false },
  xdm: {
    web: {
      webPageDetails: {
         name: "home"
      }
    }
  }
});

  2. 稍后（通常在页面底部），使用XDM有效负载调用sendEvent，该XDM有效负载包含自上次请求以来通过将personalization.includeRenderedPropositions设置为true而呈现的建议的显示事件：

    code language-js 
    alloy("sendEvent", {
  personalization: { includeRenderedPropositions: true },
  xdm: {
    // Add any additional page load telemetry you want to send here
    web: {
      webPageDetails: {
        name: "home"
      }
    }
  }
});
NOTE
使用includeRenderedPropositions时，只包括已隐藏显示的自动渲染建议。

发送手动呈现的建议的显示事件

如果您自己渲染内容（完全手动渲染或使用applyPropositions），则必须使用sendEvent命令显式发送显示事件。 使用包含以下属性的XDM有效负载调用sendEvent：

  • _experience.decisioning.propositions包含渲染的建议“id”、scope和scopeDetails
  • _experience.decisioning.propositionEventType.display设置为1

以下两个示例使用此帮助程序函数来构建显示事件XDM有效负载：

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

以下示例对显示事件使用手动渲染：

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

以下示例使用带有显示事件的applyPropositions命令。 它将sendEvent、applyPropositions以及另一个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) });
});

要避免的常见错误

  • 在渲染完成之前发送显示事件：在自动渲染完成之后、applyPropositions解析之后或手动渲染逻辑完成之后发送显示事件。
  • 发送您未呈现的建议显示事件：仅包括实际显示给用户的建议。
  • 正在删除scopeDetails：发送显示事件时从建议对象中包含scopeDetails。
recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1