Meta Conversions API扩展概述
Meta Conversions API允许您将服务器端营销数据连接到Meta技术,以优化广告定位、降低每次操作的成本和测量结果。 事件链接到Meta Pixel ID,并以类似于客户端事件的方式处理。
使用Meta Conversions API扩展,您可以利用事件转发规则中API的功能,将数据从Adobe Experience PlatformEdge Network发送到Meta。 本文档介绍如何安装扩展并在事件转发规则中使用其功能。
演示
以下视频旨在支持您了解Meta Conversions API。
先决条件
强烈建议分别使用Meta Pixel和Conversions API从客户端和服务器端共享和发送相同的事件,因为这有助于恢复Meta Pixel未提取的事件。 在安装Conversions API扩展之前,请参阅Meta Pixel 扩展上的指南,以了解如何在客户端标记实施中集成扩展的步骤。
要使用Conversions API扩展,您必须具有事件转发的访问权限,并且拥有有效的Meta帐户,该帐户具有对Ad Manager和Event Manager的访问权限。 具体而言,您必须复制现有Meta Pixel的ID(或改为创建新的 Pixel),以便可以为您的帐户配置该扩展。
安装扩展
要安装Meta Conversions API扩展,请导航到数据收集UI或Experience PlatformUI,然后从左侧导航中选择 事件转发。 在此处,选择要将扩展添加到的资产,或改为创建新资产。
选择或创建所需的属性后,在左侧导航中选择 扩展,然后选择 目录 选项卡。 搜索Meta Conversions API卡,然后选择 安装。
在显示的配置视图中,必须提供您之前复制的Pixel ID以将扩展关联到您的帐户。 您可以将ID直接粘贴到输入中,也可以改用数据元素。
您还需要提供访问令牌以专门使用Conversions API。 有关如何获取此值的步骤,请参阅有关生成访问令牌的Conversions API文档。
完成后,选择 保存
扩展已安装,您现在可以在事件转发规则中使用该扩展的功能。
与Facebook和Instagram扩展集成 facebook
使用Facebook和Instagram扩展进行的集成允许您快速对元业务帐户进行身份验证。 然后,这会自动填充您的像素ID和元转换API 访问令牌,从而更轻松地安装和配置元转换API。
安装Meta Conversions API扩展时,会出现在Facebook和Instagram中进行身份验证的对话框提示。
在Facebook和Instagram中进行身份验证的对话框提示也会显示在事件转发的快速启动工作流UI中。
与事件质量匹配分数(EMQ)集成 emq
与事件质量匹配分数(EMQ)集成允许您通过显示EMQ分数来轻松查看实施的有效性。 此集成最大限度地减少了上下文切换,并帮助您提高元转换API实施的成功。 这些事件分数显示在Meta Conversions API扩展配置屏幕中。
![Meta Conversions API扩展]配置页面突出显示查看EMQ得分。(https://experienceleague.adobe.com/images/extensions/server/meta/emq-score.png?lang=zh-Hans)
与LiveRamp(Alpha)集成 alpha
LiveRamp在其网站上部署了LiveRamp的经过身份验证的流量解决方案(ATS)的客户可以选择将RampID作为客户信息参数共享。 请与您的Meta帐户团队合作,加入此功能的Alpha计划。
配置事件转发规则 rule
本节介绍如何在通用事件转发规则中使用Conversions API扩展。 实际上,您应该配置多个规则,以便通过Meta Pixel和Conversions API发送所有已接受的标准事件。 有关移动应用数据,请在此处查看必填字段、应用数据字段、客户信息参数和自定义数据详细信息。
开始创建新的事件转发规则,并根据需要配置其条件。 为规则选择操作时,请为扩展选择 元转换API扩展,然后为操作类型选择 发送转换API事件。
显示的控件允许您配置将通过Conversions API发送到Meta的事件数据。 这些选项可以直接输入到提供的输入中,也可以选择现有数据元素来表示值。 配置选项分为四个主要部分,如下所述。
如果要发送购买事件,则必须使用此部分提供必需的特性
currency
和value
。完成后,选择 Keep Changes 以将该操作添加到规则配置中。
如果对规则满意,请选择 保存到库。 最后,发布新的事件转发生成以启用对库所做的更改。
事件去重 deduplication
如必备项部分中所述,建议您在冗余设置中同时使用Meta Pixel标记扩展和Conversions API事件转发扩展从客户端和服务器发送相同的事件。 这有助于恢复一个扩展或其他扩展未拾取的事件。
如果您从客户端和服务器发送不同的事件类型,且两者之间没有重叠,则无需进行重复数据删除。 但是,如果任何单个事件由Meta Pixel和Conversions API共享,则必须确保对这些冗余事件进行重复数据删除,以免对您的报告产生不利影响。
发送共享事件时,请确保包括事件ID和名称,以及您从客户端和服务器发送的每个事件。 收到具有相同ID和名称的多个事件时,Meta会自动使用多种策略来消除重复并保留最相关的数据。 有关此过程的详细信息,请参阅有关 Meta Pixel 和 Conversions API 事件的重复数据删除的Meta文档。
快速入门工作流:元转化API扩展(Beta) quick-start
- 已购买Real-Time CDP Prime和Ultimate包的客户可以使用快速入门功能。 请联系您的Adobe代表以获取更多信息。
- 此功能适用于全新实施,当前不支持在现有标记和事件转发属性上自动安装扩展和配置。
- 使用它作为全新实施的开始。
- 将其用作参考实施,您可以检查该实施,以了解其配置方式,然后将其复制到当前生产实施中。
快速入门功能可帮助您通过元转化API和元像素扩展轻松高效地完成设置。 此工具可自动执行在Adobe标签和事件转发中执行的多个步骤,从而显着缩短设置时间。
此功能会在新自动生成的标记上自动安装和配置元转化API和元像素扩展,并使用必要的规则和数据元素来配置事件转发属性。 此外,它还会自动安装和配置Experience PlatformWeb SDK和数据流。 最后,快速启动功能会将库自动发布到开发环境中的指定URL,从而支持通过事件转发和Experience PlatformEdge Network进行实时客户端数据收集和服务器端事件转发。
以下视频介绍了快速入门功能。
安装快速入门功能
此设置会自动安装元转化API和元像素扩展。 Meta建议使用此混合实施来收集和转发事件转换。
快速设置功能旨在帮助客户开始事件转发实施,而不是提供可适应所有用例的端到端、功能齐全的实施。
要安装该功能,请在Adobe Experience Platform数据收集 主页 页面上为 Send Conversions Data to Meta 选择 开始。
的数据
输入您的 域,然后选择 下一步。 此域将用作自动生成的标记和事件转发属性、规则、数据元素、数据流等的命名约定。
在 初始设置 对话框中,输入您的 元像素ID、元转换API访问令牌 和 数据层路径,然后选择 下一步。
请等待几分钟以完成初始设置过程,然后选择 下一步。
从 在您的网站上添加代码 对话框中,复制使用复制
函数提供的代码,并将其粘贴到源网站的<head>
中。 实施后,选择 开始验证
验证结果对话框显示元扩展实施结果。 选择 下一步。 您还可以通过选择 保证 链接来查看其他验证结果。
后续步骤 屏幕显示确认安装完成。 在此处,您可以选择通过添加新事件来优化实施,下一部分将显示这些事件。
如果不想添加其他事件,请选择 关闭。
添加其他事件
要添加新事件,请选择 编辑您的标记Web属性。
选择与要编辑的元事件对应的规则。 例如,MetaConversion_AddToCart。
要添加事件,请在事件标题下选择 添加。
选择事件类型。 在此示例中,我们已选择Click事件并将其配置为在选择 .add-to-cart-button 时触发。 选择 保留更改。
已保存新事件。 选择 选择工作库 并选择要生成到的库。
接下来,选择 保存到库 旁边的下拉列表,然后选择 保存到库并生成。 这会将更改发布到库中。
对要配置的任何其他元转化事件重复这些步骤。
数据层配置 configuration
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 Conversions API扩展将服务器端事件数据发送到Meta。 在此处,建议通过连接更多Pixels并共享更多事件(如果适用)来扩展您的集成。 执行以下任一操作均有助于进一步改善广告性能:
- 连接尚未连接到Conversions API集成的任何其他Pixels。
- 如果您专门通过客户端上的Meta Pixel发送某些事件,则也从服务器端将这些相同的事件发送到Conversions API。
有关如何有效实施集成的更多指导,请参阅有关 Conversions API🔗的最佳实践的Meta文档。 有关Adobe Experience Cloud中标记和事件转发的更多常规信息,请参阅标记概述。