Краткий обзор. Отправляйте насыщенные внутренние события из AppsFlyer в Facebook Ads.
Сопоставление с IAE Facebook
Рекламодатели могут сопоставить внутренние события своих приложений, события SDK и межсерверные события с предопределенными событиями Facebook. Кроме того, рекламодатели могут отправлять Facebook постбэки о каждом запуске приложения или о каждом известном удалении приложения.
Это позволяет рекламодателям использовать дополнительные возможности оптимизации, предоставляемые Facebook, а также выполнять пользовательскую сегментацию аудитории и выделять похожие аудитории.
Предопределенное сопоставление событий
Facebook предлагает широкий спектр событий, которые определены заранее и могут сопоставляться.
Здесь представлен список насыщенных внутренних событий, которые можно отправить на Facebook с дополнительными параметрами, содержащими информацию о качестве событий.
Обратите внимание, что для отправки удалений в Facebook Ads нет предопределенного события. Для отправки удалений используйте настраиваемое событие.
Ниже приведен список других предопределенных событий Facebook, у которых нет дополнительных параметров:
Идентификатор события Facebook |
Описание |
Рекомендованное имя AppsFlyer SDK |
---|---|---|
Donate |
Перечисление средств для вашей организации или акции. |
af_donate |
Schedule |
Бронирование посещения одного из ваших местоположений. |
af_schedule |
SubmitApplication |
Подача заявки на предлагаемые вами продукт, услугу или программу, например, на банковскую карту, образовательную программу или работу. |
af_submit_application |
FindLocation |
Когда человек находит ваше местоположение через веб-сайт или приложение и намеревается вас посетить. Например, поиск продукта и его обнаружение в одном из ваших местных магазинов. |
af_find_location |
Contact |
Телефонный разговор, смс, электронное письмо, чат или иная форма контакта между клиентом и вашей компанией. |
af_contact |
CustomizeProduct |
Персонализация продуктов с помощью конфигуратора или иного приложения, которым владеет ваша компания. |
af_customize_product |
Сопоставление настраиваемых внутренних событий приложения
В AppsFlyer есть возможность сопоставить любое настраиваемое внутреннее событие приложения для отправки в Facebook, используя идентификатор CUSTOM Facebook Event Identifier.
Имена и значения событий (в том числе параметры событий), заданные в SDK, передаются в Facebook в исходном виде и отображаются с исходным именем события из SDK AppsFlyer, а не как «custom».
Обратите внимание, что эти события можно использовать для оптимизации кампаний.
Автоматическое сопоставление параметров с событием CUSTOM
Благодаря глубокой интеграции AppsFlyer и Facebook многие стандартные параметры событий SDK AppsFlyer автоматически сопоставляются с предопределенными параметрами Facebook. Например, параметр af_revenue преобразуется в Facebook в параметр valueToSum, который позволяет отправлять доход по каждому событию, и который можно измерить и оптимизировать на Facebook.
Примечание
При автоматическом сопоставлении параметров для событий типа CUSTOM результаты могут отличаться от результатов сопоставления с предопределенными событиями.
В некоторых предопределенных событиях параметр af_price сопоставлен параметру _valueToSum (например, в событии fb_mobile_add_to_cart
). В других событиях параметру af_revenue сопоставлен параметр _valueToSum (например, в событии fb_mobile_purchase
).
При сопоставлении параметров событию типа CUSTOM параметр af_price всегда сопоставлен параметру fb_price, а параметр af_revenue — параметру _valueToSum.
В этой таблице приведены все параметры событий AppsFlyer, которые при сопоставлении с событием CUSTOM в Facebook автоматически сопоставляются с параметрами Facebook.
Параметр AppsFlyer | Параметр Facebook |
---|---|
af_city | fb_city |
af_class | fb_travel_class |
af_content_id | fb_content_id |
af_content_list | fb_content_id |
af_content_type | fb_content_type |
af_country | fb_country |
af_currency | fb_currency |
af_date_a | fb_checkin_date |
af_date_b | fb_checkout_date |
af_departing_arrival_date | fb_departing_arrival_date |
af_departing_departure_date | fb_departing_departure_date |
af_description | fb_description |
af_destination_a | fb_origin_airport |
af_destination_b | fb_destination_airport |
af_destination_list | fb_destination_ids |
af_hotel_score | fb_hotel_score |
af_level | fb_level |
af_max_rating_value | fb_max_rating_value |
af_num_adults | fb_num_adults |
af_num_children | fb_num_children |
af_num_infants | fb_num_infants |
af_order_id | fb_order_id |
af_payment_info_available | fb_payment_info_available |
af_preferred_neighborhoods | fb_preferred_neighborhoods |
af_preferred_num_stops | fb_preferred_num_stops |
af_preferred_price_range | fb_preferred_price_range |
af_preferred_star_ratings | fb_preferred_star_ratings |
af_price | fb_price |
af_quantity | fb_num_items |
af_region | fb_region |
af_registration_method | fb_registration_method |
af_returning_arrival_date | fb_returning_arrival_date |
af_returning_departure_date | fb_returning_departure_date |
af_revenue | _valueToSum |
af_search_string | fb_search_string |
af_success | fb_success |
af_suggested_destinations | fb_suggested_destinations |
af_suggested_hotels | fb_suggested_hotels |
af_travel_end | fb_travel_end |
af_travel_start | fb_travel_start |
af_user_score | fb_user_score |
Ограничения для событий и параметров
Действуют следующие лимиты по отправке событий в Facebook Ads:
-
Недопустимые символы:
- Двоеточие (:)
- Точка (.)
- Нелатинские (неанглийские) символы: по состоянию на 12 января 2020 Facebook не принимает китайские символы. AppsFlyer не проверял другие алфавиты, поэтому их стоит использовать только после верификации, поддерживает ли Facebook эти символы в постбэках.
- Названия событий чувствительны к регистру. Чтобы избежать расхождений, убедитесь, что вы используете правильный регистр в названиях событий для всех медиа-источников и версий приложений.
- Максимальное количество параметров: 25.
- Длина имен и параметров событий: 2–40 символов.
- Максимальная длина параметра: 100 символов.
- Разрешенные символы: буквы, цифры, символ подчеркивания, дефис, пробел. Используйте только латинские (английские) буквы. Использование нелатинских символов приводит к расхождениям в результатах.
Рекомендации по именованию внутренних событий приложения:
- Имена событий в AppsFlyer могут совпадать с именами событий Facebook (например, fb_price), однако такие события нельзя отправлять в Facebook как настраиваемые события (CUSTOM).
Для надежности не следует использовать имена событий, которые совпадают с именами событий Facebook. - Чтобы сопоставить внутренние события приложения с Facebook с помощью постбэков, получите данные о событиях от ВСЕХ источников, включая органические.
Важно!
За исключением перечисленных выше параметров, AppsFlyer отправляет в Facebook данные настраиваемых событий в исходном виде. Владелец приложения должен самостоятельно проверять данные событий на соответствие требованиям Facebook.
Если значение события содержит параметры, которые не были сопоставлены соответствующим параметрам Facebook (см. таблицу выше), эти параметры не будут отправлены в Facebook.