Объявления из каталога Advantage+ для мобильных приложений

Для настройки объявлений из каталога Advantage+ в мобильных приложениях можно использовать Facebook SDK. Чтобы сделать работу с приложением максимально удобной, в него необходимо включить возможность перехода по глубоким ссылкам, в том числе отсроченного.

Шаг 1. Настройка Facebook Mobile SDK для iOS или Android

Интегрируйте Facebook SDK для iOS или Android.

Шаг 2. Настройка событий в мобильном приложении

Для отслеживания взаимодействия в браузере используются события пикселя Meta, например ViewContent. В мобильном приложении в тех же целях можно применять события в приложении.

Из приложения должны отправляться те же три обязательных события, что и из пикселя: ViewContent, AddToCart и Purchase. Эти события необходимы для правильной работы объявлений из каталога Advantage+.

Событие для 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` Строка	Необязательный параметр. Валюта, в которой оплачивается покупка.

Использование Mobile Measurement Partner

Если для отправки событий в Facebook вы используете одно из одобренных нами приложений Mobile Measurement Partner (MMP), то вы также можете настроить передачу обязательных событий. Этот процесс зависит от конкретного MMP, но в целом он выглядит так:

Настройте интеграцию так, чтобы в MMP передавались три обязательных события вместе с необходимыми параметрами.
Сопоставьте имена событий в MMP с именами событий Facebook.
Протестируйте события в приложении.

Обязательные события для MMP

Следующие события являются обязательными.

Имя	Описание
`fb_mobile_content_view`	Аккаунт из Центра аккаунтов просмотрел товар.
`fb_mobile_add_to_cart`	Добавление товара в корзину.
`fb_mobile_purchase`	Покупка одного или нескольких товаров.

Для правильной работы объявлений из каталога Advantage+ также необходимо передавать два дополнительных параметра:

ID просматриваемого, добавляемого в корзину или приобретаемого товара;
параметр, который определяет, является ли ID значением product или product_group.

Ниже перечислены доступные дополнительные параметры.

Имя	Описание
`fb_content_type` Строка	Либо `product`, либо `product_group`
`fb_content_id` Строка	Обязательный параметр. Строка, содержащая массив установленных ритейлером идентификаторов в формате JSON для товаров или наборов товаров.
`_valueToSum` Строка	Необязательный параметр. Стоимость купленного товара.
`fb_currency` Строка	Необязательный параметр. Валюта, в которой оплачивается покупка.

Примечание. Когда пользователь покупает товары, следует также передавать параметры _valueToSum и fb_currency.

Тестирование событий в приложении

Самым простым способом протестировать вашу интеграцию является использование Помощника по рекламе приложений, поскольку он позволяет просматривать события и параметры, передаваемые в Facebook, в режиме реального времени.

Выберите приложение.
Внизу страницы появятся два инструмента. Выберите Тестировать события в приложении.
Предлагаются два варианта: просмотреть события, передаваемые вами, или события определенного ID рекламодателя. В большинстве случаев достаточно выбрать параметр Свои. Убедитесь в том, что на вашем устройстве установлено приложение Facebook и вы вошли в него.
В процессе выполнения действий в приложении события и их параметры отображаются в инструменте.

В случае успешной интеграции вы должны увидеть следующие три события:

FB_MOBILE_CONTENT_VIEW;
FB_MOBILE_ADD_TO_CART;
FB_MOBILE_PURCHASE.

См. дополнительные сведения о событиях в приложении для iOS и Android.

Чтобы удостовериться в том, что функция "События в приложении" работает, вы можете проверить недавние события в этом инструменте:

Facebook Events Manager

Шаг 3. Настройка глубоких ссылок

По глубоким ссылкам в вашей ленте товаров любой пользователь, взаимодействующий с рекламой на Facebook, может перейти непосредственно в определенное место в вашем приложении. Например, когда пользователь нажимает на объявление в мобильном приложении Facebook, он переходит к информации о товаре в вашем мобильном приложении. Дополнительную информацию см. в статьях Глубокие ссылки и Проверка глубоких ссылок.

Переход на сайт или в магазин приложений

При использовании глубоких ссылок можно указать альтернативную реакцию на тот случай, если у пользователя ваше приложение не установлено. Если в вашей ленте товаров есть глубокие ссылки, то при отсутствии вашего приложения пользователи видят в рекламе URL страницы товара.

Скорее всего, вы стремитесь увеличить объем продаж, а значит, пользователей следует перенаправлять на страницы товаров, а не на страницу установки приложения. По этой причине мы по умолчанию используем URL этих страниц, хотя вы можете настроить и другое поведение. При создании своего объявления из каталога Advantage+ установите для поведения значение applink_treatment и воспользуйтесь одним из нижеперечисленных вариантов.

Имя	Описание
`web_only`	Пользователь всегда перенаправляется на указанный URL. Все глубокие ссылки в ленте переопределяются.
`deeplink_with_web_fallback`	Если приложение установлено и имеются соответствующие глубокие ссылки, пользователь перенаправляется в приложение. Если хотя бы одно из этих условий не выполняется, пользователь перенаправляется на URL сайта.
`deeplink_with_appstore_fallback`	Если приложение установлено и имеется соответствующая информация о глубоких ссылках, пользователь перенаправляется в приложение. Если приложение не установлено, пользователь перенаправляется на его страницу в магазине приложений.

Шаг 4. Настройка ленты товаров

Теперь необходимо указать действительные глубокие ссылки для объявлений из каталога Advantage+. Дополнительную информацию см. в статье "Каталог", описание глубоких ссылок.

Шаг 5. Параметры отслеживания

Чтобы можно было измерять используемые для объявлений из каталога Advantage+ события конверсии с сайта и из мобильных приложений, для них необходимо задать параметры отслеживания.

Событие	Параметры отслеживания
`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 сможет отслеживать любые события, связанные с объявлениями из каталога Advantage+, независимо от того, происходят ли они на сайте или в приложении. Чтобы задать параметры отслеживания, используйте следующий код:

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>