How can we help?

Сопоставление с внутренними событиями Meta Ads

  • Обновлено

Краткий обзор. Отправляйте насыщенные внутренние события из AppsFlyer в Meta Ads.

Сопоставление с внутренними событиями Meta Ads

Рекламодатели могут сопоставить внутренние события своих приложений, события SDK и межсерверные события с предопределенными событиями Meta. Кроме того, рекламодатели могут отправлять в Meta постбэки о каждом запуске приложения или о каждом известном удалении приложения.

Это позволяет рекламодателям использовать дополнительные возможности оптимизации, предоставляемые Meta, а также выполнять пользовательскую сегментацию аудитории и выделять похожие аудитории.

Сопоставление предопределенных событий

Meta Ads предлагает широкий спектр событий, которые определены заранее и могут сопоставляться.

Здесь представлен список насыщенных внутренних событий, которые можно отправить в Meta с дополнительными параметрами, содержащими информацию о качестве событий.

Подробнее о сопоставлении событий в Meta

In-app_event_postbacks_en-us.png

Обратите внимание, что для отправки удалений в Meta Ads нет предопределенного события. Для отправки удалений используйте настраиваемое событие.

Ниже приведен список других предопределенных событий Meta, у которых нет дополнительных параметров:

Идентификатор события в Meta Описание Рекомендованное имя AppsFlyer SDK
Donate Перечисление средств для вашей организации или акции. af_donate
График Бронирование посещения одного из ваших местоположений. af_schedule
SubmitApplication Подача заявки на предлагаемые вами продукт, услугу или программу, например, на банковскую карту, образовательную программу или работу. af_submit_application
FindLocation Когда человек находит ваше местоположение через веб-сайт или приложение и намеревается вас посетить. Например, поиск продукта и его обнаружение в одном из ваших местных магазинов. af_find_location 
Contact Телефонный разговор, смс, электронное письмо, чат или иная форма контакта между клиентом и вашей компанией. af_contact
CustomizeProduct Персонализация продуктов с помощью конфигуратора или иного приложения, которым владеет ваша компания. af_customize_product
Adimpression — для Android
Fb_mobile_purchase — для iOS
Оптимизирует доход от рекламы на платформе Meta. См. подробности ниже. af_ad_revenue

Сопоставление данных о доходах от рекламы для оптимизации кампании

Meta может оптимизировать ваши кампании на основе данных о доходе от рекламы. Для этого событие af_ad_revenue сопоставляется со следующим событием рекламы Meta:

Название события в AppsFlyer Окно повторного вовлечения  Связано с партнёрским событием Оптимизация рекламы Meta на основе:

af_ad_revenue
Android; Adimpression Конкретный доход от рекламы
https://support.appsflyer.com/hc/article_attachments/360016192917 fb_mobile_purchase Покупок в приложении

Ограничения доступности

Сопоставление настраиваемых внутренних событий приложения

В AppsFlyer есть возможность сопоставить любое настраиваемое внутреннее событие приложения для отправки в Meta, используя идентификатор CUSTOM Meta Event Identifier.

Имена и значения событий (в том числе параметры событий), заданные в SDK, передаются в Meta в исходном виде и отображаются с исходным именем события из SDK AppsFlyer, а не как «custom».

Обратите внимание, что эти события можно использовать для оптимизации кампаний.

Автоматическое сопоставление параметров с событием CUSTOM

Благодаря глубокой интеграции AppsFlyer и Meta многие стандартные параметры событий SDK AppsFlyer автоматически сопоставляются с предопределенными параметрами Meta. Например, параметр af_revenue преобразуется в Meta в параметр _valueToSum, который позволяет отправлять доход по каждому событию, и который можно измерить и оптимизировать в Meta.

 Примечание

При автоматическом сопоставлении параметров для событий типа 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 в Meta автоматически сопоставляются с параметрами Meta.

Параметр AppsFlyer Параметр Meta
af_city fb_city
af_класс fb_travel_class
af_content fb_content
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_уровень 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_платежная_информация_доступна 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_метод_регистрации fb_метод_регистрации
af_дата_возвращения fb_returning_arrival_date
af_дата_отправления_обратного fb_returning_departure_date
af_выручка _valueToSum
строка_поиска_af fb_search_string
af_success fb_success
af_suggested_destinations fb_suggested_destinations
af_suggested_hotels fb_предлагаемые_отели
af_travel_end fb_travel_end
af_travel_start fb_travel_start
af_user_score fb_user_score

Автоматическое сопоставление предопределенных событий с параметром _valueToSum

Для предопределенных событий параметр Meta _valueToSum сопоставляется либо с параметром af_price, либо с параметром af_revenue.

В следующей таблице показано это сопоставление для всех предопределенных событий Meta с параметром _valueToSum:

Точка (.) _valueToSum сопоставляется с
fb_mobile_level_achieved none
fb_mobile_add_payment_info none
fb_mobile_add_to_cart af_price
fb_mobile_add_to_wishlist af_price
fb_mobile_complete_registration none
fb_mobile_tutorial_completion none
fb_mobile_initiated_checkout af_price
fb_mobile_purchase af_выручка
fb_mobile_rate af_rating_value
fb_mobile_search af_выручка
fb_mobile_spent_credits af_price
fb_mobile_achievement_unlocked none
fb_mobile_content_view af_price
StartTrial af_price
Подписаться af_выручка

Сопоставление с внутренними событиями Meta Ads

Чтобы отправлять в Meta сложные события в приложении, то есть события с несколькими товарами, используйте структурированный массив af_content. Каждый объект в массиве должен включать id и quantity, чтобы обеспечить корректную обработку постбэка.

af_content_list является необязательным. Если он отсутствует, Meta использует поле fb_content (сопоставленное из af_content) для определения идентификаторов ID продуктов. Пока JSON af_content содержит поле id в каждом объекте, Meta может распознавать и извлекать из него идентификаторы контента.

Если вы включаете af_content_list, не включайте af_content_id в то же событие. Оба параметра сопоставляются с fb_content_id, и во избежание конфликтов следует заполнять только один из них.

Примечание

fb_content_id важен для сценариев использования на уровне продукта, таких как сопоставление событий с элементами каталога для Advantage+ Catalog Ads и Dynamic Ads, отчетность по эффективности на уровне продукта и сигналы оптимизации на основе продукта. Для общей оптимизации конверсии на основе количества событий и значения кампании работают и без него.

Пример: единый формат, совместимый с Meta и TikTok

{
  "af_revenue": 4.99,
  "af_currency": "USD",
  "af_order_id": "12345",
  "af_content": "[{\"id\":\"ID1\",\"quantity\":\"1\"},{\"id\":\"ID2\",\"quantity\":\"1\"},{\"id\":\"ID3\",\"quantity\":\"2\"}]"
}

Этот формат работает и для Meta, и для TikTok. TikTok также считывает значения id из поля af_content, поэтому одного payload достаточно при отправке постбэков в обе сети.

Важно!

Если параметр af_content превышает 1,000 символов, AppsFlyer может отправить событие в Meta без параметра fb_content. Если в этом сценарии также отсутствует af_content_list, Meta не получает никаких данных для идентификации продукта. Держите af_content в пределах 1000 символов для событий, которые включают множество элементов.

Подробнее о структурировании сложных событий в приложении см. в статье События в приложении: обзор.

Ограничения для событий и параметров

Действуют следующие лимиты по отправке событий в Meta Ads:

  • Недопустимые символы:
    • Двоеточие (:)
    • Точка (.)
    • Нелатинские (неанглийские) символы: по состоянию на 12 января 2020 Meta не принимает китайские символы. AppsFlyer не проверял другие алфавиты, поэтому их стоит использовать только после верификации, поддерживает ли Meta эти символы в постбэках.
  • Названия событий чувствительны к регистру. Чтобы избежать расхождений, убедитесь, что вы используете правильный регистр в названиях событий для всех медиа-источников и версий приложений.
  • Максимальное количество параметров: 25.
  • Длина имен и параметров событий: 2–40 символов.
  • Максимальная длина параметра: 100 символов.
  • Максимальная длина параметра af_content: 1000 символов.
  • Разрешенные символы: буквы, цифры, символ подчеркивания, дефис, пробел. Используйте только латинские (английские) буквы. Использование нелатинских символов приводит к расхождениям в результатах.

Рекомендации по именованию внутренних событий приложения:

  • Имена событий в AppsFlyer могут совпадать с именами событий Meta (например, fb_price), однако такие события нельзя отправлять в Meta как настраиваемые события (CUSTOM).
    Для надежности не следует использовать имена событий, которые совпадают с именами событий Meta.
  • Чтобы сопоставить внутренние события приложения с Meta с помощью постбэков, получите данные о событиях от ВСЕХ источников, включая органические.

 Двоеточие (:)

За исключением перечисленных выше параметров, AppsFlyer отправляет в Meta данные настраиваемых событий в исходном виде. Владелец приложения несет ответственность за проверку соответствия данных о событиях требованиям Meta, используя действительные параметры Meta (см. таблицу выше). В противном случае эти параметры не будут отправлены в Meta

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: