移动应用进阶赋能型目录广告

您可以使用 Facebook SDK 在移动端设置进阶赋能型目录广告。您应该将深度链接和延迟深度链接纳入自己的应用中，以便尽可能为应用用户提供最佳体验。

第 1 步：设置 iOS 或 Android 版 Facebook 移动 SDK

集成 iOS 版或 Android 版 Facebook SDK。

第 2 步：设置移动应用事件

在网页端，我们使用 ViewContent 等 Meta Pixel 像素代码事件追踪事件互动。在移动设备端，可以使用应用事件追踪相同的事件。

您必须从应用发送 ViewContent、AddToCart 和 Purchase 这三个必要事件，操作方式与从 Pixel 像素代码发送时相同，进阶赋能型目录广告需要这些事件才能正常运作。

iOS 事件	Android 事件	网页端事件
`FBSDKAppEventNameViewedContent`	`AppEventsConstants:: EVENT_NAME_VIEWED_CONTENT`	`ViewContent`
`FBSDKAppEventNameAddedToCart`	`AppEventsConstants:: EVENT_NAME_ADDED_TO_CART`	`AddToCart`
`[[FBSDKAppEvents shared] logPurchase:(double) currency:(NSString ) parameters:(NSDictionary )];`	`AppEventsConstants:: EVENT_NAME_PURCHASED`	`Purchase`

例如，有人在应用中查看某件商品时，就会触发 ViewContent 事件：

[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameViewedContent
  valueToSum:54.23
  parameters:@{
    FBSDKAppEventParameterNameCurrency    : @"USD",
    FBSDKAppEventParameterNameContentType : @"product",
    FBSDKAppEventParameterNameContentID   : @"123456789"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "1234");

logger.logEvent(AppEventsConstants.EVENT_NAME_VIEWED_CONTENT,
                120.00,
                parameters);

多件商品发生一个事件时，您还可以为商品编号提供一组由值组成的 JSON 数组。例如，您可以发送多个发生 Purchase 事件的商品。

[[FBSDKAppEvents shared] logPurchase:54.23 currency : @"USD" parameters:@{
  FBSDKAppEventParameterNameContentID   : @"['1234','5678']",
  FBSDKAppEventParameterNameContentType : @"product"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "['1234', '5678']");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASED,
                180.00,
                parameters);

多个内容编号

如果您有多个内容编号，可以提供转义 JSON 数组，例如：

"[\"1234\",\"5678\"]"

可选参数

对于每个应用事件，您可以发送附加参数，这些参数应该在有人执行购买操作时发送：

名称	描述
`_valueToSum` 字符串	可选。商品的价值或购买金额
`fb_currency` 字符串	可选。商品或购买金额所用的币种

使用移动应用成效衡量合作伙伴 (MMP)

如果您使用经批准的移动应用成效衡量合作伙伴 (MMP) 向 Facebook 报告事件，则还可以调整您的实现方式来发送必要事件。虽然此过程因 MMP 而异，但通常如下：

调整您的集成，以向 MMP 报告三个必要事件以及必要参数。
通过您的 MMP，将事件名称映射到 Facebook 事件名称。
测试应用事件。

MMP 的必要事件

以下事件为必要项：

名称	描述
`fb_mobile_content_view`	当帐户管理中心帐户查看了商品时
`fb_mobile_add_to_cart`	有人将商品加入购物车时
`fb_mobile_purchase`	有人购买一件或多件商品时

您还必须同时发送两个附加参数，进阶赋能型目录广告才能运作：

所查看、加入购物车或所购买的商品的编号
该编号是 product 还是 product_group

可用的附加参数包括：

名称	描述
`fb_content_type` 字符串	`product` 或 `product_group`
`fb_content_id` 字符串	必要。一个字符串，包含以 JSON 编码的零售商商品或商品组编号的数组
`_valueToSum` 字符串	非必要。购买商品的总价值
`fb_currency` 字符串	非必要。商品或购买金额所用的币种

注意：当有人购买商品时，您还应该发送 _valueToSum 和 fb_currency 参数。

测试应用事件

测试集成是否有效时，最简单的方法是借助应用广告帮手，此工具可实时查看向 Facebook 报告的事件和参数。

选择一款应用。
您将在页面底部看到两个工具。选择测试应用事件。
共有两个选项：查看您将报告的事件或者将按特定广告编号报告的事件。在大多数情况下，选择我足以满足要求。确保您的设备上已安装 Facebook 并且您已登录。
您在应用中执行操作时，事件及其参数将一起显示在工具中。

如果集成成功，您将看到以下三个事件名称：

FB_MOBILE_CONTENT_VIEW
FB_MOBILE_ADD_TO_CART
FB_MOBILE_PURCHASE

详细了解 iOS 和 Android 应用事件的相关信息。

如要验证您的应用事件功能，您可以在

Facebook 事件管理工具

中检查最近事件。

第 3 步：设置深度链接

在商品信息库中提供深度链接后，在 Facebook 上与您的广告互动的任何人都可以直接转到应用的特定位置。例如，当用户在移动设备上点击 Facebook 中的广告时，就会在您的移动应用中看到相应商品。请参阅深度链接和验证深度链接，获取更多信息。

回退到网页与应用商店

借助深度链接，您可以指定用户未安装应用时的回退行为。在商品信息库中提供深度链接后，用户无需应用即可看到广告中商品的网址。

由于您的目标可能是提高目录商品销量，因此您可能希望用户查看商品页面，而不是安装应用。为此，我们默认为链接到网址，但您也可以指定不同的行为以实现更多控制。在创建进阶赋能型目录广告时，将回退行为设置为 applink_treatment，并使用以下选项之一：

名称	描述
`web_only`	始终将用户转到指定的网址。这将覆盖信息库中的任何深度链接。
`deeplink_with_web_fallback`	如果用户已安装应用并且我们有您提供的相应深度链接，则将用户转到您的应用中。如果上述条件有一项不满足，则将用户转到网站网址。
`deeplink_with_appstore_fallback`	如果用户已安装应用并且我们有相应的深度链接信息，则将用户转到应用中。如果用户未安装应用，则将用户转到应用商店以获取应用。

第 4 步：设置商品信息库

现在，您需要为进阶赋能型目录广告提供实际的深度链接。请参阅商品目录 > 深度链接，获取更多信息。

第 5 步：追踪参数

如要衡量来自您的网站和移动应用的转化事件，请确保所有进阶赋能型目录广告均已为下列事件设置正确的追踪参数：

事件	追踪参数
`offsite_conversion`	`{ 'action.type': 'offsite_conversion', 'fb_pixel': FB_PIXEL_ID }`
`app_custom_event`	`{'action.type':'app_custom_event','application':APP_ID}`
`mobile_app_install`	`{'action.type':'mobile_app_install','application':APP_ID}`

设置完成后，Facebook 即可追踪从进阶赋能型目录广告中发生的任何事件，无论用户是在访问您的网站还是应用。如需设置这些追踪参数，请使用以下代码：

use FacebookAds\Object\Ad;
use FacebookAds\Object\Fields\AdFields;

$ad = new Ad(<AD_ID>);

$ad->{'tracking_spec'} = array(
  array(
    'action.type' => array('app_custom_event'),
    'application' => array($app_id),
  ),
  array(
    'action.type' => array('offsite_conversion'),
    'offsite_pixel' => array(<PIXEL_ID>),
  ),
  array(
    'action.type' => array('mobile_app_install'),
    'application' => array($app_id),
  ),

);
$ad->update();

curl \
  -F 'tracking_spec=[ 
    {"action.type":["app_custom_event"],"application":["101"]}, 
    {"action.type":["offsite_conversion"],"offsite_pixel":["<PIXEL_ID>"]}, 
    {"action.type":["mobile_app_install"],"application":["101"]} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<AD_ID>