文档Experience Platform标记

Meta Conversions API扩展概述

Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员

Meta Conversions API允许您将服务器端营销数据连接到Meta技术，以优化广告定位、降低每次操作的成本和测量结果。 事件链接到Meta Pixel ID，并以类似于客户端事件的方式处理。

使用Meta Conversions API扩展，您可以利用事件转发规则中API的功能，将数据从Adobe Experience Platform Edge Network发送到Meta。 本文档介绍如何安装扩展并在事件转发规则中使用其功能。

演示

以下视频旨在支持您了解Meta Conversions API。

https://unlockmarketingdata.com/video-meta-conversions-api

先决条件

强烈建议分别使用Meta Pixel和Conversions API从客户端和服务器端共享和发送相同的事件，因为这有助于恢复Meta Pixel未提取的事件。 在安装Conversions API扩展之前，请参阅Meta Pixel 扩展上的指南，以了解如何在客户端标记实施中集成扩展的步骤。

NOTE
本文档后面关于事件去重的部分介绍了确保同一事件不使用两次的步骤，因为可以从浏览器和服务器接收该事件。

要使用Conversions API扩展，您必须具有事件转发的访问权限，并且拥有有效的Meta帐户，该帐户具有对Ad Manager和Event Manager的访问权限。 具体而言，您必须复制现有Meta Pixel的ID（或改为创建新的 Pixel），以便可以为您的帐户配置该扩展。

INFO
如果您计划将此扩展与移动应用程序数据一起使用，或者如果您还在Meta营销活动中处理离线事件数据，则需要通过现有应用程序创建数据集，并在出现提示时选择​从像素ID创建。 有关详细信息，请参阅文章确定适合您企业的数据集创建选项。 有关所有必需和可选的应用程序跟踪参数，请参阅应用程序事件转化API文档。

安装扩展

要安装Meta Conversions API扩展，请导航到数据收集UI或Experience Platform UI，然后从左侧导航中选择​Event Forwarding。 在此处，选择要将扩展添加到的资产，或改为创建新资产。

选择或创建所需的属性后，在左侧导航中选择​Extensions，然后选择​ Catalog ​选项卡。 搜索Meta Conversions API卡，然后选择​Install。

正在数据收集UI中为Install扩展选择Meta Conversions API选项。

在显示的配置视图中，必须提供您之前复制的Pixel ID以将扩展关联到您的帐户。 您可以将ID直接粘贴到输入中，也可以改用数据元素。

您还需要提供访问令牌以专门使用Conversions API。 有关如何获取此值的步骤，请参阅有关Conversions API生成访问令牌的文档。

完成后，选择​Save

在扩展配置视图中作为数据元素提供的Pixel ID。

扩展已安装，您现在可以在事件转发规则中使用该扩展的功能。

与Facebook和Instagram扩展集成 facebook

通过使用Facebook和Instagram扩展的集成，您可以快速对Meta商业帐户进行身份验证。 然后，这将自动填充您的Pixel ID和Meta Conversions API Access Token，以便更轻松地安装和配置Meta Conversions API。

安装Meta Conversions API扩展时，会出现在Facebook和Instagram中进行身份验证的对话框提示。

突出显示Meta Conversions API Extension的Connect to Meta安装页面。

在事件转发的快速启动工作流UI中，还会显示用于在Facebook和Instagram中进行身份验证的对话框提示。

快速启动工作流UI突出显示Connect to Meta。

与事件质量匹配分数(EMQ)集成 emq

与事件质量匹配分数(EMQ)集成允许您通过显示EMQ分数来轻松查看实施的有效性。 此集成最大限度地减少了上下文切换，并帮助您提高Meta Conversions API实施的成功。 这些事件分数显示在Meta Conversions API extension配置屏幕中。

突出显示Meta Conversions API Extension的View EMQ Score配置页面。

与LiveRamp (Alpha)集成 alpha

LiveRamp在其网站上部署了LiveRamp的经过身份验证的流量解决方案(ATS)的客户可以选择将RampID作为客户信息参数共享。 请与您的Meta帐户团队合作，加入此功能的Alpha计划。

Meta事件转发Rule配置页面突出显示Partner Name (alpha)和Partner ID (alpha)。

配置事件转发规则 rule

本节介绍如何在通用事件转发规则中使用Conversions API扩展。 实际上，您应该配置多个规则，以便通过和发送所有已接受的Meta Pixel标准事件Conversions API。 有关移动应用数据，请在此处查看必填字段、应用数据字段、客户信息参数和自定义数据详细信息。

NOTE
事件应为实时发送或尽可能接近实时发送，以便更好地优化广告促销活动。

开始创建新的事件转发规则，并根据需要配置其条件。 为规则选择操作时，请为扩展选择​Meta Conversions API Extension，然后选择操作类型的​Send Conversions API Event。

为数据收集UI中的规则选择的Send Page View操作类型。

显示的控件允许您配置将通过Meta发送到Conversions API的事件数据。 这些选项可以直接输入到提供的输入中，也可以选择现有数据元素来表示值。 配置选项分为四个主要部分，如下所述。

配置区域
描述
Server Event Parameters
有关事件的常规信息，包括发生时间和触发该事件的源操作。 有关Meta接受的标准事件参数的更多信息，请参阅Conversions API开发人员文档。

如果您同时使用Meta Pixel和Conversions API来发送事件，请确保每个事件都包含​Event Name (event_name)和​Event ID (event_id)，因为这些值用于事件去重。

您还可以选择​ Enable Limited Data Use ​以帮助遵守客户选择退出的要求。 有关此功能的详细信息，请参阅有关Conversions API数据处理选项的文档。
Customer Information Parameters
用于将事件归因于客户的用户身份数据。 在将某些值发送到API之前，必须对它们进行哈希处理。

为确保良好的通用API连接和高事件匹配质量(EMQ)，建议您随服务器事件一起发送所有接受的客户信息参数。 这些参数也应根据它们对EMQ的重要性和影响进行优先级排序。
Custom Data
用于广告投放优化的附加数据，以JSON对象的形式提供。 请参阅Conversions API 文档，了解有关此对象所接受属性的更多信息。

如果要发送购买事件，则必须使用此部分提供必需的特性currency和value。
Test Event
此选项用于验证您的配置是否导致Meta按预期接收服务器事件。 要使用此功能，请选中​ Send as Test Event ​复选框，然后在下面的输入中提供您选择的测试事件代码。 部署事件转发规则后，如果您正确配置了扩展和操作，则应该会在​ Test Events ​中看到Meta Events Manager视图内出现活动。

完成后，选择​ Keep Changes ​以将该操作添加到规则配置。

正在为操作配置选择 Keep Changes。

如果对规则满意，请选择​Save to Library。 最后，发布新的事件转发生成以启用对库所做的更改。

事件去重 deduplication

如必备项部分中所述，建议您在冗余设置中同时使用Meta Pixel标记扩展和Conversions API事件转发扩展从客户端和服务器发送相同的事件。 这有助于恢复一个扩展或其他扩展未拾取的事件。

如果您从客户端和服务器发送不同的事件类型，且两者之间没有重叠，则无需进行重复数据删除。 但是，如果任何单个事件由Meta Pixel和Conversions API共享，则必须确保对这些冗余事件进行重复数据删除，以免对您的报告产生不利影响。

发送共享事件时，请确保包括事件ID和名称，以及您从客户端和服务器发送的每个事件。 收到具有相同ID和名称的多个事件时，Meta会自动使用多种策略来消除重复并保留最相关的数据。 有关此过程的详细信息，请参阅有关Meta和事件的 Meta Pixel 重复数据删除 Conversions API 的文档。

快速入门工作流： Meta Conversions API扩展(Beta) quick-start

IMPORTANT
  • 已购买Real-Time CDP Prime和Ultimate软件包的客户可以使用快速入门功能。 有关更多信息，请联系您的Adobe代表。
  • 此功能适用于全新实施，当前不支持在现有标记和事件转发属性上自动安装扩展和配置。
NOTE
任何现有客户端都可以使用快速入门工作流创建可用于以下项目的参考实施：
  • 使用它作为全新实施的开始。
  • 将其用作参考实施，您可以检查该实施，以了解其配置方式，然后将其复制到当前生产实施中。

快速入门功能可帮助您轻松高效地设置Meta Conversions API和Meta Pixel扩展。 此工具可自动执行在Adobe标记和事件转发中执行的多个步骤，从而显着缩短设置时间。

此功能会在新自动生成的标记上自动安装和配置Meta转化API和Meta像素扩展，并使用必要的规则和数据元素来配置事件转发属性。 此外，它还会自动安装和配置Experience Platform Web SDK和数据流。 最后，快速入门功能会自动将库发布到开发环境中的指定URL，从而可以通过事件转发和Experience Platform Edge Network实时实现客户端数据收集和服务器端事件转发。

以下视频介绍了快速入门功能。

https://video.tv.adobe.com/v/3416939?quality=12&learn=on

安装快速入门功能

NOTE
此功能旨在帮助您开始实施事件转发。 它不会提供可容纳所有用例的端到端、完全正常的实施。

此设置会自动安装Meta Conversions API和Meta Pixel扩展。 Meta建议使用此混合实施来收集和转发事件转换。
快速设置功能旨在帮助客户开始事件转发实施，而不是提供可适应所有用例的端到端、功能齐全的实施。

要安装该功能，请在Adobe Experience Platform数据收集​ Get Started ​页面上为​ Send Conversions Data to Meta ​选择​Home。

数据收集主页，显示转换到meta 的数据

输入您的​Domain，然后选择​Next。 此域将用作自动生成的标记和事件转发属性、规则、数据元素、数据流等的命名约定。

请求域名的欢迎屏幕

在​ Initial Setup ​对话框中，输入您的​Meta Pixel ID、Meta Conversion API Access Token​和​Data Layer Path，然后选择​Next。

初始设置对话框

请等待几分钟以完成初始设置过程，然后选择​Next。

初始设置完成确认屏幕

从​ Add Code on Your Site ​对话框中，复制使用复制 复制 函数提供的代码，并将其粘贴到源网站的<head>中。 实施后，选择​Start Validation

在您的网站对话框中添加代码

Validation Results对话框显示Meta扩展实施结果。 选择 Next。您还可以通过选择​ Assurance ​链接来查看其他验证结果。

显示实施结果的测试结果对话框

Next Steps​屏幕显示确认安装完成。 在此处，您可以选择通过添加新事件来优化实施，下一部分将显示这些事件。

如果不想添加其他事件，请选择​Close。

后续步骤对话框

添加其他事件

要添加新事件，请选择​Edit Your Tags Web Property。

显示编辑标记Web属性的后续步骤对话框

选择与要编辑的元事件对应的规则。 例如，MetaConversion_AddToCart。

NOTE
如果没有事件，则此规则将不会运行。 所有规则均如此，其中​ MetaConversion_PageView ​规则为异常。

要添加事件，请选择​ Add ​标题下的Events。

标记属性页面未显示任何事件

选择 Event Type。在此示例中，我们已选择Click事件并将其配置为在选择​ .add-to-cart-button ​时触发。 选择 Keep Changes。

显示点击事件的事件配置屏幕

已保存新事件。 选择​ Select a working library ​并选择要生成到的库。

选择工作库下拉列表

接下来，选择​ Save to Library ​旁边的下拉菜单并选择​Save to Library and Build。 这会将更改发布到库中。

选择保存到库并生成

对要配置的任何其他元转化事件重复这些步骤。

数据层配置 configuration

IMPORTANT
更新此全局数据层的方式取决于您的网站架构。 单页应用程序将与服务器端渲染应用程序不同。 另外，您可能将完全负责在Tags产品中创建和更新此数据。 在所有实例中，在运行MetaConversion_* rules的每个实例之间都需要更新数据层。 如果不更新规则之间的数据，您还可能会遇到发送当前MetaConversion_* rule中最后MetaConversion_* rule个过时的数据的情况。

在配置过程中，系统会询问您数据层的存放位置。 默认情况下，该值为window.dataLayer.meta，而在meta对象中，您的数据应如下所示。

数据层元数据

这一点务必要理解，因为每个MetaConversion_*规则都使用此数据结构将相关数据段传递到Meta Pixel扩展和Meta Conversions API。 请参阅有关标准事件的文档，了解有关不同元事件需要哪些数据的更多信息。

例如，如果要使用MetaConversion_Subscribe规则，则需要根据window.dataLayer.meta.currency标准事件window.dataLayer.meta.predicted_ltv的文档中所述的对象属性更新window.dataLayer.meta.value、和。

以下是在执行规则之前需要在网站上运行以更新数据层的示例。

更新数据层元数据

默认情况下，<datalayerpath>.conversionData.eventId将通过“生成新事件ID”操作在任意MetaConversion_* rules上随机生成。

要获取数据层外观的本地引用，您可以在属性上的MetaConversion_DataLayer数据元素上打开自定义代码编辑器。

后续步骤

本指南介绍了如何使用Meta扩展将服务器端事件数据发送到Meta Conversions API。 在此处，建议通过连接更多Pixels并共享更多事件（如果适用）来扩展您的集成。 执行以下任一操作均有助于进一步改善广告性能：

  • 连接尚未连接到Pixels集成的任何其他Conversions API。
  • 如果您专门通过客户端上的Meta Pixel发送某些事件，则也从服务器端将这些相同的事件发送到Conversions API。

有关如何有效实施集成的更多指导，请参阅有关Meta的 Conversions API最佳实践的文档。 有关Adobe Experience Cloud中标记和事件转发的更多常规信息，请参阅标记概述。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743