마케팅 API

모바일 앱용 어드밴티지+ 카탈로그 광고

Facebook SDK를 사용하여 모바일에서 어드밴티지+ 카탈로그 광고를 설정할 수 있습니다. 딥 링크와 지연된 딥 링크를 앱에 통합하여 앱 사용자에게 가능한 한 최상의 경험을 제공해야 합니다.

1단계: iOS 또는 Android용 Facebook 모바일 SDK 설정

iOS용 또는 Android용 Facebook 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);

또한 하나의 이벤트가 여러 제품에 대해 발생하는 경우 제품 ID 값으로 구성된 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);

복수의 콘텐츠 ID

콘텐츠 ID가 여러 개인 경우 이스케이프된 JSON 배열을 제공합니다. 예를 들면 다음과 같습니다.

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

선택적 매개변수

앱 이벤트별로 추가 매개변수를 전송할 수 있습니다. 사용자가 구매할 때 이러한 매개변수를 전송해야 합니다.

이름설명

_valueToSum

문자열

선택 사항.
제품 또는 구매 금액의 가치

fb_currency

문자열

선택 사항.
제품 또는 구매 금액의 통화

모바일 측정 파트너(MMP) 사용

승인된 모바일 측정 파트너(MMP)를 사용하여 Facebook에 이벤트를 보고할 경우, 필수 이벤트도 전송하도록 구현을 조정할 수 있습니다. 이 과정은 MMP별로 다르지만 일반적으로는 다음과 같은 형태를 취합니다.

  1. 통합을 조정하여 필수 매개변수와 함께 3가지 필수 이벤트를 MMP에 보고합니다.
  2. MMP를 사용하여 이벤트 이름을 Facebook 이벤트 이름에 매핑합니다.
  3. 앱 이벤트를 테스트합니다.

MMP의 필수 이벤트

다음 이벤트는 필수입니다.

이름설명

fb_mobile_content_view

계정 센터 계정이 제품을 보았을 때

fb_mobile_add_to_cart

품목이 장바구니에 담겼을 때

fb_mobile_purchase

하나 또는 여러 개의 품목을 구매했을 때

또한 어드밴티지+ 카탈로그 광고가 작동하려면 다음 두 개의 매개변수를 추가로 전송해야 합니다.

  • 조회하거나 장바구니에 담겼거나 구매한 품목의 ID
  • ID가 product 또는 product_group인지 여부

사용 가능한 추가 매개변수는 다음과 같습니다.

이름설명

fb_content_type

문자열

product 또는 product_group

fb_content_id

문자열

필수 사항.
판매점의 제품이나 제품 그룹 ID로 구성된 JSON 인코딩 배열을 포함하는 문자열

_valueToSum

문자열

선택 사항.
구매한 제품의 가치

fb_currency

문자열

선택 사항.
제품 또는 구매 금액의 통화

참고: 사용자가 품목을 구매하면 _valueToSum 및 fb_currency 매개변수도 전송해야 합니다.

앱 이벤트 테스트

통합이 작동하는지 테스트하는 가장 쉬운 방법은 앱 광고 지원 도구에서 Facebook에 실시간으로 보고되는 이벤트와 매개변수를 확인하는 것입니다.

  1. 앱을 선택합니다.
  2. 페이지 하단에 2개의 도구가 나타납니다. 앱 이벤트 테스트를 선택합니다.
  3. 자신이 보고하는 이벤트 또는 특정 광고 ID로 보고하는 이벤트를 확인하는 두 가지 옵션이 있습니다. 대부분의 경우 나를 선택하면 됩니다. 기기에 Facebook이 설치되어 있고 로그인한 상태인지 확인합니다.
  4. 앱에서 동작을 수행하는 동안 도구에서 각 매개변수와 함께 이벤트가 나타납니다.

통합에 성공하면 다음과 같이 3개의 이벤트 이름이 나타납니다.

  • FB_MOBILE_CONTENT_VIEW
  • FB_MOBILE_ADD_TO_CART
  • FB_MOBILE_PURCHASE

iOS 및 Android 앱 이벤트에 대해 자세히 알아보세요.

앱 이벤트가 작동하는지 확인하려면

Facebook 이벤트 관리자

에서 최근 이벤트를 확인할 수 있습니다.

.

3단계: 딥 링크 설정

제품 피드에 딥 링크를 제공하면 Facebook에서 광고와 소통하는 사용자가 앱의 특정 위치로 바로 이동할 수 있습니다. 예를 들어 사용자가 모바일을 통해 Facebook에서 광고를 클릭하면 모바일 앱에서 제품을 볼 수 있습니다. 자세한 내용은 딥 링크와 딥 링크 인증을 참조하세요.

웹 vs. App Store로의 폴백

딥 링크를 사용하면 사용자가 앱을 설치하지 않았을 때의 폴백 동작을 지정할 수 있습니다. 제품 피드에 딥 링크를 제공하면 앱을 설치하지 않은 사용자에게 광고 내 제품에 대한 웹 URL이 표시됩니다.

여러분의 목적은 카탈로그 판매를 늘리는 것일 가능성이 크기 때문에 사용자가 앱을 설치하기보다는 제품 페이지를 보는 것을 바랄 수 있습니다. 그래서 Facebook에서는 웹 URL을 기본값으로 지정합니다. 하지만 제어 권한을 강화하기 위해 다른 동작을 지정하셔도 됩니다. 어드밴티지+ 카탈로그 광고를 만들 때 폴백 동작을 applink_treatment로 설정하고 다음 중 한 가지 옵션을 사용합니다.

이름설명

web_only

항상 사용자를 특정 웹 URL로 이동시킵니다. 이 옵션은 피드의 모든 딥 링크를 재정의합니다.

deeplink_with_web_fallback

앱이 설치되어 있고 해당 딥 링크가 있다면 사용자를 앱으로 이동시킵니다. 위의 조건 중 하나라도 충족하지 않으면 사용자를 웹사이트 URL로 이동시킵니다.

deeplink_with_appstore_fallback

앱이 설치되어 있고 해당 딥 링크 정보가 있다면 사용자를 앱으로 이동시킵니다. 앱이 설치되어 있지 않은 경우 사용자를 앱이 판매되는 App Store로 이동시킵니다.

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>