Snapchat转化API扩展概述
Snap转换API扩展是一个安全的Edge Network API接口，允许您直接与Snapchat共享有关您网站上的用户操作的信息。 您可以使用 Adobe Experience Platform Edge Network 转换API扩展利用事件转发规则将数据从 Snapchat 发送到Snap。
Snapchat先决条件 prerequisites
要使用Snapchat转化API，请执行以下操作：
需要Snapchat Business Manager帐户才能使用转化API。 Business Manager帮助广告商将 Snapchat 的营销工作整合到其整个业务中并与外部合作伙伴集成。 请参阅有关创建Business Manager帐户的Snapchat 帮助中心文章（如果没有）。
必须在Snapchat广告管理器中设置[Snap Pixel]，并且您必须有权查看Pixel ID。 可以在Pixel ID部分找到[Events Manager]。
您需要一个静态、生命周期较长的API令牌。 请参阅Snapchat 转化API文档以获取此令牌。
安装和配置Snapchat Web事件API扩展 install
要安装扩展，请导航到Data Collection>Event Forwarding。 选择要安装扩展的资产。
选择所需的属性后，请执行以下步骤：
-
在左侧导航面板中，选择Extensions。
-
搜索 Snap Conversion API Extension 并选择Install。
-
在配置屏幕上，输入以下值：
- Pixel Id
- API Token
完成后，选择Save。
创建数据元素 create-data-elements
若要将数据发送到Snapchat转化API扩展，请为每个数据参数创建数据元素。 执行以下步骤：
-
在属性的 Authoring 屏幕中导航到Data Elements>Property Info，然后选择Add Data Element。
-
输入数据元素的名称。
-
选择 Core 作为扩展，选择 Path 作为数据元素类型。
-
从下拉菜单中，选择相应的项，并填写右侧面板中的Path字段以在架构中引用所需的数据。
例如，如果您创建的数据元素在下面显示的架构中引用snapClickId：
您必须配置数据元素，因为snapClickId位于XDM架构中的_snap.inc.exchange下。
有关创建数据元素的更多详细信息，请参阅事件转发属性文档。
创建规则以将转换事件发送到Snap create-snap-rules
规则用于在Experience Platform中触发扩展。 本节概述如何使用转化API扩展在事件转发属性中创建规则以将转化事件发送到快照。
创建新规则
-
导航到您的事件转发属性，然后从“创作”菜单中选择Rules。 然后，单击Create New Rule。
-
命名规则并配置触发快照事件的条件。 例如，要在事件包含订单编号时发送
PURCHASE事件，请设置条件以检查用户交互是否包含有效的采购订单编号。
-
保存条件后，添加操作以触发快照转换API。 在左侧面板中：
-
将Extension下拉菜单设置为Snap Conversions API Extension。
-
将Action Type下拉菜单设置为Report Web Conversions。
-
相应地命名规则。
-
-
在右侧面板的部分中为事件配置要发送的CAPI参数值Data Bindings。 扩展中的字段映射到CAPI参数，如下所示。 有关每个参数的详细信息，请参阅Snapchat转换API文档。
event_nameemphclient_user_agentclient_ip_addresssc_click_idso_cookie1fnlngephstzpcountryexternal_idpartner_idsubscription_idlead_idcontent_categorycontent_idscontent_namecontentsdescriptionevent_tagnum_itemsvaluecurrencyorder_id （也为event_id发送以代替client dedup idD）predicted_ltvsearch_stringsign_up_methodevent_iddata_processing_optionsevent_source_url必需和可选字段
每个事件都需要event_source，它始终设置为WEB.为了匹配，还需要以下字段或组合中的至少一个：
- 电子邮件
- 电话号码
- IP地址和用户代理
其他备注：
-
对于
Purchase事件，Currency和Price字段为必填字段。 -
启用 Test Mode 复选框会将事件作为测试事件发送，这些事件显示在测试事件工具中，而不是标准报表中。 有关更多详细信息，请参阅此商业帮助中心文章。
-
contents参数应为至少包含以下字段之一的JSON字符串：iditem_categorybranddelivery_categoryitem_pricequantity
示例：
{
"id": "id1",
"brand": "brand1",
"delivery_category": "c1",
"item_price": 2.00,
"quantity": 2
}
要使用自定义转化值和ROAS报告，请在contents字段中包含相关参数。 购买事件的示例配置可能如下所示： brand、item_price、id。
Purchase事件的配置示例：
可设置以下可选字段：
按如上所述设置规则的名称、条件和操作后，保存规则并确保其处于启用状态。
您现在可以将这些更改发布到资产。 有关详细信息，请参阅有关发布流的文档。
疑难解答 troubleshoot
要排除故障并优化设置，请查看事件质量得分建议，以确保您的事件获得尽可能高的匹配率和性能结果。
如果您遇到有关 事件质量分数 的问题，请在此处详细了解我们的改进建议。
后续步骤 next-steps
本指南介绍了如何使用 Snap 扩展将服务器端事件数据发送到Snap Conversions API。 有关Experience Platform中事件转发功能的更多信息，请参阅事件转发概述。