验证Facebook像素和转化API是否正常工作
随着 Apple的应用跟踪透明度(ATT) 框架 更新，Facebook推出了聚合事件测量（Aggregated Event Measurement）功能，帮卖家克服Apple的限制。
ShopBase完全支持此协议。卖家现在可以设置转化API并从浏览器和服务器触发事件。收到的所有事件都将显示在Facebook Events Manager中。
本文将说明如何确保Facebook像素和转化API从ShopBase商店正确触发事件。
A. 验证Facebook像素是否正常工作
B. 验证转化API是否正常工作
C. Facebook事件的匹配质量
D. 常见问题解答：修复来自Facebook的常见警告和警报
附录 1. ShopBase触发Facebook的事件
附录 2. 发送到Facebook的事件参数
要确保Facebook Pixel从您的浏览器正确地触发事件，请：
登录 Facebook Events Manager并查找您要触发事件的像素。
转到位于像素下方的 Test Events选项卡。在这里您可以看到2个选项： Test Browser Events 和 Test Server Events。
在 Test Browser Events中，输入网址：
输入有当前像素的商店的网址。
点击 Open Website。
您的在线商店将在新选项卡中打开，您可以在此处进行操作。
Test Events中收取的操作：
当您在商店进行操作时，新事件将开始显示在您的 Test Events中。
例如，当您在商店查看产品页面时， Test Events将开始显示流量和View Content（查看内容）事件。
当您进行加入购物车并结账时，相应的事件将显示。购买后， Test Events将显示Purchase（购买）事件。
如果您在 Facebook Test Events中看到这些事件正常显示，则表示您的Facebook像素正常工作。
要确保Facebook像素从您的服务器正确触发事件，请：
登录 Facebook Events Manager并查找您要触发事件的像素。
转到位于像素下方的 Test Events选项卡。在这里您可以看到2个选项： Test Browser Events和 Test Server Events。
在 Test Server Events中，复制测试代码：
登录您的ShopBase后台，转到 Online store > Preferences。
在 Facebook Pixel & Conversions API部分中，将测试代码粘贴到 Access token：
此时，您应该已经 在您的商店中准备好Facebook像素和Access token了。您可以在 Access token字段的末尾输入以下格式： -testcode-。
接下来，粘贴您在第3步已复制的测试代码。
此 Access token字段的最终正确格式是： Access_token-testcode-Your_test_code_here。
例如，您的Access token是 demo ，您的测试代码是 TEST42552 ，则您应该在 Access token字段中输入 demo-testcode-TEST42552 。
Test Events中收取的操作：
将测试代码添加到商店后，您可以开始在您的商店进行操作并从这里发送服务器事件。
当您在商店进行操作时，新事件将开始显示在您的 Test Events中。
例如，当您在商店查看产品页面时， Test Events将开始显示流量和View Content（查看内容）事件。
当您进行加入购物车并结账时，相应的事件将显示。购买后， Test Events将显示Purchase（购买）事件。
Server事件：从服务器触发的事件。
Browser - Server事件：从浏览器和服务器触发的事件。
当浏览器和服务器同时触发一个事件时，Facebook仅记录这两个来源之一的事件，另一个事件将被删除以避免事件重复。
如果您在Facebook Test Events中看到这些事件正常显示，则表示转化API正常工作。
请参阅 此文章以了解关于Facebook的重复事件删除功能（Facebook Events Deduplication）的更多信息。
当您使用转化API共享服务器事件时，您可以在Facebook Events Manager中查看每个事件的匹配质量 (EMQ)。
事件的EMQ指数（满分为10）表示从您的服务器发送的客户信息与Facebook账户的匹配质量。
PageView或ViewContent等常见事件的指数预计非常低，因为几乎所有访客都会触发这些事件。在这一步，很难以发送客户的有用信息，例如名称、邮箱或地址。这是多个平台常见的情况。
Facebook的此指数仍在开发中。
下面是您可能在Facebook Events Manager中收到的一些常见警告和警报，以及您在遇到这些问题时可以采取的措施。
事件的匹配质量低（Low Event matching quality）：
这些警告通显示在Search和ViewContent等事件中。
上述事件的匹配质量指数预计较低，因为在这些步骤中客户信息（例如邮箱、电话号码等）的数据非常有限（除非您的客户已登录）。
事件匹配质量的指数可能渐渐提高，因为Facebook通常需要长达48小时来汇总数据。请在此延迟时间内等待，直到Facebook可以充分汇总您的数据。
如果InitiateCheckout或Purchase事件的匹配质量指数很低（低于 3），则被视为异常。在这种情况下，请与我们的客服团队联系以获得帮助。
许多事件实例收到相同的event_id（Same event_id received for many event instances）或事件缺少某些去重复参数（Missing deduplication parameters）：
当您的商店添加了其他脚本，这些脚本向Facebook发送冗余数据时，通常会显示此警报。
在这种情况下，您应该在 Online store > Preferences > Additional scripts中查看可能影响您数据的任何第三方脚本。
如果您在商店中没有看到任何第三方脚本，但仍收到来自Facebook的此警报，请与我们的客服团队联系以获得帮助。
请注意，Facebook像素和转化API集成在ShopBase中（ Online store > Preferences > Facebook Pixel & Conversion API），因此您无需在 Additional scripts部分中添加来自Facebook的任何其他脚本。
Facebook中的订单数量与ShopBase后台的不同（ The number of orders in Facebook is different from ShopBase admin site）：
您可能会看到Facebook Events Manager收到的购买事件数量与ShopBase后台中的订单数量不同。
这是因为Facebook已停止支持实时报告，现在报告事件是在SKAdNetwork API收到事件时，而不是在发生这些事件时。
您在Facebook上看到的购买事件可能会记录前几天的订单。因此，ShopBase后台中的订单数量与Facebook购买事件不同是正常的。
服务器外部编号与Pixel像素代码外部编号不相符（Server External ID not matching to Pixel External ID）：
ShopBase已经将所有参数的匹配价值发送到像素和服务器。但是，Facebook需要时间来更新数据，您最初会收到此警报。如果警报不断显示，您可以通过两种方式进行检查：
确保您没有从Facebook添加任何多余的脚本（例如，触发附加事件的脚本）。您仅需在ShopBase后台上，选择 Online store > Preferences > Facebook Pixel & Conversion API， 然后添加必要的Facebook像素和/或转化API。
确保您没有使用Facebook的 事件设置工具 。如果在 Test event选项卡中有些标记为 事件设置工具 的事件，如下图所示，则必须删除它，以避免事件被重复触发，导致数据不正确。请参阅 此文章以了解关于Facebook的事件设置工具的更多信息。
完成上述步骤后，在Facebook警告中，请点击 How to fix the issue > Mark As Resolved。当有新数据时，Facebook将自动更新。
Search：当搜索时。 一个人访问搜索结果页面（包括无结果的页面）*
事件名称： Search
参数： search_string
Visit Product Detail Page：当查看产品页面等关键页面时。 一个人访问产品详情页。*
事件名称： ViewContent
参数： content_ids 、 content_name 、 content_type 、 content_category 、 currency 、 value
Check Out from Cart：当买家点击购物车抽屉或购物车页面上的“Checkout”按钮时
事件名称： CheckoutButtonClicked
参数： content_ids 、 content_type 、 currency 、 value 、 num_items
Buy Now：当买家点击产品详情页上的“Buy Now”按钮时
事件名称： BuyNowButtonClicked
参数： content_ids 、 content_type 、 currency 、 value 、 num_items
Add to Cart：当将产品加入购物车时。 一个人单击“ Add to cart”按钮。*
事件名称： AddToCart
参数： content_ids 、 content_type 、 content_category 、 currency 、 value
Start Checkout：当一个人开始结帐流程时。 一个人点击“Checkout”、“Buy Now”或加速结账按钮时（例如，Checkout with Paypal）*
事件名称： InitiateCheckout
参数： content_category 、 contents 、 content_brand 、 currency 、 value 、 num_items
Use Coupon Code：当用户成功应用优惠代码时
事件名称： UseCouponCode
参数： coupon
Purchase：当完成购买或结帐流程时。 一个人已完成购买或结帐流程并看到感谢页面。*
事件名称： Purchase
参数： content_category 、 contents 、 content_brand 、 currency 、 value 、 num_items
为了确保事件被正确地触发到Facebook，ShopBase正在密切遵循 Facebook关于所需事件数据参数的指南。
必需参数（从服务器发送）： event_name 、 event_time 、 user_data 、 custom_data 、 event_source_url 、 event_id 、 action_source
客户信息参数（从浏览器和服务器发送）： em （邮箱）、 ph （电话号码）、 ge （性别）、 db （出生日期）、 ln （姓氏） 、 fn （名字）、 ct （城市）、 st （州）、 zp （邮政编码）、 country （国家）、 external_id （外部ID）、 client_ip_address （客户端IP地址）、 client_user_agent （客户端用户代理）、 fbc （点击ID）、 fbp （浏览器ID）、 subscription_id （订阅ID）、 fb_login_id （Facebook登录ID）、 lead_id （潜在客户ID）
根据Facebook的推荐，一些参数是在编程形式下的。
设置Facebook像素和转化API
ShopBase完全支持此协议。卖家现在可以设置转化API并从浏览器和服务器触发事件。收到的所有事件都将显示在Facebook Events Manager中。
本文将说明如何确保Facebook像素和转化API从ShopBase商店正确触发事件。
主要内容
A. 验证Facebook像素是否正常工作
B. 验证转化API是否正常工作
C. Facebook事件的匹配质量
D. 常见问题解答：修复来自Facebook的常见警告和警报
附录 1. ShopBase触发Facebook的事件
附录 2. 发送到Facebook的事件参数
A. 验证Facebook像素是否正常工作
要确保Facebook Pixel从您的浏览器正确地触发事件，请：
登录 Facebook Events Manager并查找您要触发事件的像素。
转到位于像素下方的 Test Events选项卡。在这里您可以看到2个选项： Test Browser Events 和 Test Server Events。
在 Test Browser Events中，输入网址：
输入有当前像素的商店的网址。
点击 Open Website。
您的在线商店将在新选项卡中打开，您可以在此处进行操作。
Test Events中收取的操作：
当您在商店进行操作时，新事件将开始显示在您的 Test Events中。
例如，当您在商店查看产品页面时， Test Events将开始显示流量和View Content（查看内容）事件。
当您进行加入购物车并结账时，相应的事件将显示。购买后， Test Events将显示Purchase（购买）事件。
如果您在 Facebook Test Events中看到这些事件正常显示，则表示您的Facebook像素正常工作。
B. 验证转化API是否正常工作
要确保Facebook像素从您的服务器正确触发事件，请：
登录 Facebook Events Manager并查找您要触发事件的像素。
转到位于像素下方的 Test Events选项卡。在这里您可以看到2个选项： Test Browser Events和 Test Server Events。
在 Test Server Events中，复制测试代码：
登录您的ShopBase后台，转到 Online store > Preferences。
在 Facebook Pixel & Conversions API部分中，将测试代码粘贴到 Access token：
此时，您应该已经 在您的商店中准备好Facebook像素和Access token了。您可以在 Access token字段的末尾输入以下格式： -testcode-。
接下来，粘贴您在第3步已复制的测试代码。
此 Access token字段的最终正确格式是： Access_token-testcode-Your_test_code_here。
例如，您的Access token是 demo ，您的测试代码是 TEST42552 ，则您应该在 Access token字段中输入 demo-testcode-TEST42552 。
Test Events中收取的操作：
将测试代码添加到商店后，您可以开始在您的商店进行操作并从这里发送服务器事件。
当您在商店进行操作时，新事件将开始显示在您的 Test Events中。
例如，当您在商店查看产品页面时， Test Events将开始显示流量和View Content（查看内容）事件。
当您进行加入购物车并结账时，相应的事件将显示。购买后， Test Events将显示Purchase（购买）事件。
Server事件：从服务器触发的事件。
Browser - Server事件：从浏览器和服务器触发的事件。
当浏览器和服务器同时触发一个事件时，Facebook仅记录这两个来源之一的事件，另一个事件将被删除以避免事件重复。
如果您在Facebook Test Events中看到这些事件正常显示，则表示转化API正常工作。
请参阅 此文章以了解关于Facebook的重复事件删除功能（Facebook Events Deduplication）的更多信息。
C. Facebook事件的匹配质量
当您使用转化API共享服务器事件时，您可以在Facebook Events Manager中查看每个事件的匹配质量 (EMQ)。
事件的EMQ指数（满分为10）表示从您的服务器发送的客户信息与Facebook账户的匹配质量。
PageView或ViewContent等常见事件的指数预计非常低，因为几乎所有访客都会触发这些事件。在这一步，很难以发送客户的有用信息，例如名称、邮箱或地址。这是多个平台常见的情况。
Facebook的此指数仍在开发中。
D. 常见问题解答：修复来自Facebook的常见警告和警报
下面是您可能在Facebook Events Manager中收到的一些常见警告和警报，以及您在遇到这些问题时可以采取的措施。
事件的匹配质量低（Low Event matching quality）：
这些警告通显示在Search和ViewContent等事件中。
上述事件的匹配质量指数预计较低，因为在这些步骤中客户信息（例如邮箱、电话号码等）的数据非常有限（除非您的客户已登录）。
事件匹配质量的指数可能渐渐提高，因为Facebook通常需要长达48小时来汇总数据。请在此延迟时间内等待，直到Facebook可以充分汇总您的数据。
如果InitiateCheckout或Purchase事件的匹配质量指数很低（低于 3），则被视为异常。在这种情况下，请与我们的客服团队联系以获得帮助。
许多事件实例收到相同的event_id（Same event_id received for many event instances）或事件缺少某些去重复参数（Missing deduplication parameters）：
当您的商店添加了其他脚本，这些脚本向Facebook发送冗余数据时，通常会显示此警报。
在这种情况下，您应该在 Online store > Preferences > Additional scripts中查看可能影响您数据的任何第三方脚本。
如果您在商店中没有看到任何第三方脚本，但仍收到来自Facebook的此警报，请与我们的客服团队联系以获得帮助。
请注意，Facebook像素和转化API集成在ShopBase中（ Online store > Preferences > Facebook Pixel & Conversion API），因此您无需在 Additional scripts部分中添加来自Facebook的任何其他脚本。
Facebook中的订单数量与ShopBase后台的不同（ The number of orders in Facebook is different from ShopBase admin site）：
您可能会看到Facebook Events Manager收到的购买事件数量与ShopBase后台中的订单数量不同。
这是因为Facebook已停止支持实时报告，现在报告事件是在SKAdNetwork API收到事件时，而不是在发生这些事件时。
您在Facebook上看到的购买事件可能会记录前几天的订单。因此，ShopBase后台中的订单数量与Facebook购买事件不同是正常的。
服务器外部编号与Pixel像素代码外部编号不相符（Server External ID not matching to Pixel External ID）：
ShopBase已经将所有参数的匹配价值发送到像素和服务器。但是，Facebook需要时间来更新数据，您最初会收到此警报。如果警报不断显示，您可以通过两种方式进行检查：
确保您没有从Facebook添加任何多余的脚本（例如，触发附加事件的脚本）。您仅需在ShopBase后台上，选择 Online store > Preferences > Facebook Pixel & Conversion API， 然后添加必要的Facebook像素和/或转化API。
确保您没有使用Facebook的 事件设置工具 。如果在 Test event选项卡中有些标记为 事件设置工具 的事件，如下图所示，则必须删除它，以避免事件被重复触发，导致数据不正确。请参阅 此文章以了解关于Facebook的事件设置工具的更多信息。
完成上述步骤后，在Facebook警告中，请点击 How to fix the issue > Mark As Resolved。当有新数据时，Facebook将自动更新。
附录 1. ShopBase触发Facebook的事件
Search：当搜索时。 一个人访问搜索结果页面（包括无结果的页面）*
事件名称： Search
参数： search_string
Visit Product Detail Page：当查看产品页面等关键页面时。 一个人访问产品详情页。*
事件名称： ViewContent
参数： content_ids 、 content_name 、 content_type 、 content_category 、 currency 、 value
Check Out from Cart：当买家点击购物车抽屉或购物车页面上的“Checkout”按钮时
事件名称： CheckoutButtonClicked
参数： content_ids 、 content_type 、 currency 、 value 、 num_items
Buy Now：当买家点击产品详情页上的“Buy Now”按钮时
事件名称： BuyNowButtonClicked
参数： content_ids 、 content_type 、 currency 、 value 、 num_items
Add to Cart：当将产品加入购物车时。 一个人单击“ Add to cart”按钮。*
事件名称： AddToCart
参数： content_ids 、 content_type 、 content_category 、 currency 、 value
Start Checkout：当一个人开始结帐流程时。 一个人点击“Checkout”、“Buy Now”或加速结账按钮时（例如，Checkout with Paypal）*
事件名称： InitiateCheckout
参数： content_category 、 contents 、 content_brand 、 currency 、 value 、 num_items
Use Coupon Code：当用户成功应用优惠代码时
事件名称： UseCouponCode
参数： coupon
Purchase：当完成购买或结帐流程时。 一个人已完成购买或结帐流程并看到感谢页面。*
事件名称： Purchase
参数： content_category 、 contents 、 content_brand 、 currency 、 value 、 num_items
附录2. 发送到Facebook的事件参数
为了确保事件被正确地触发到Facebook，ShopBase正在密切遵循 Facebook关于所需事件数据参数的指南。
必需参数（从服务器发送）： event_name 、 event_time 、 user_data 、 custom_data 、 event_source_url 、 event_id 、 action_source
客户信息参数（从浏览器和服务器发送）： em （邮箱）、 ph （电话号码）、 ge （性别）、 db （出生日期）、 ln （姓氏） 、 fn （名字）、 ct （城市）、 st （州）、 zp （邮政编码）、 country （国家）、 external_id （外部ID）、 client_ip_address （客户端IP地址）、 client_user_agent （客户端用户代理）、 fbc （点击ID）、 fbp （浏览器ID）、 subscription_id （订阅ID）、 fb_login_id （Facebook登录ID）、 lead_id （潜在客户ID）
根据Facebook的推荐，一些参数是在编程形式下的。
关联页面
设置Facebook像素和转化API
更新于： 06/03/2025
谢谢！