行動應用程式的高效速成+ 目錄廣告

您可以使用 Facebook SDK 來設定行動版高效速成+ 目錄廣告。您應將深層連結和延遲深層連結納入您的應用程式，為用戶提供最佳的應用程式使用體驗。

步驟 1：設定行動版 Facebook iOS／Android SDK

整合 Facebook iOS 或 Android SDK。

步驟 2：設定行動應用程式事件

在網頁上，請使用 Meta 像素事件（如 ViewContent）來追蹤事件互動。在行動裝置上，您可以使用應用程式事件來追蹤相同的事件。

您必須從應用程式傳送如同從像素傳送一樣的三個必要事件：ViewContent、AddToCart 和 Purchase。高效速成+ 目錄廣告需要有這些事件，才能正常運作。

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）

若您使用批准的 Mobile Measurement Partner（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>