我们能为您提供什么帮助?

Meta ads应用内事件映射

  • 更新

概要:本文解释了如何将相关应用内事件从AppsFlyer发送到Meta ads。

Meta应用内事件映射

广告主需要将SDK或S2S应用内事件映射到Meta侧的预定义事件。广告主还可以向Meta发送每个应用打开或应用卸载的回传。

广告主可以通过事件回传充分利用Meta的高级优化功能,并搭建自定义人群包和相似受众人群包。

预定义事件的映射

Meta ads提供多种预定义事件,可直接用于映射。

详情请参考此文档,其中列出了可用的Meta回传事件,您可以在这些事件中添加其他参数,传递更多信息,用于说明事件质量。

如需进一步了解Meta事件映射的具体操作,请参考此文档。 

In-app_event_postbacks_en-us.png

请注意:Meta ads没有预定义的卸载事件。如需发送卸载事件,请使用自定义事件进行配置。

除了上文超链接中列出的事件之外,Meta还提供不带额外参数的其他预定义事件,详见下表。

Meta事件标识符 说明 推荐的AppsFlyer SDK事件名称
Donate 为您的组织或公益事业提供的捐款 af_donate
Schedule 网点来访预约 af_schedule
SubmitApplication 针对您提供的某项产品、服务或项目(如信用卡、课程、职位等)提交申请 af_submit_application
FindLocation 用户通过网页或应用发现您的业务网点并计划来访,比如用户搜索某个产品后发现该产品在您的线下商店有售 af_find_location 
Contact 用户通过SMS、邮件、聊天框或其他方式与贵司联系 af_contact
CustomizeProduct 通过配置工具或贵司的其他应用对产品进行自定义配置。 af_customize_product
Adimpression安卓应用Adimpression:
Fb_mobile_purchaseiOS应用:Fb_mobile_purchase
af_ad_revenue

platform 渠道映射事件

af_ad_revenue
安卓 AdImpression
iOS fb_mobile_purchase 应用内购买

  • 通过Adimpression事件优化投放的功能目前仅支持:
    • 安卓应用。iOS应用可继续使用fb_mobile_purchase事件来发送广告收入数据。
    • 符合Meta要求的部分Meta ads账号。如果该功能显示为灰色(不可用),可能是因为该账号不符合相关要求。
  • af_ad_revenue事件仅对购买了ROI360高级套餐的账号开放。 
    • 没有ROI360套餐的账号可以使用其他事件名称发送广告收入数据。

自定义应用内事件的映射

在AppsFlyer平台中,您可以使用“CUSTOM”选项(自定义的Meta事件标识符)将自定义应用内事件映射到Meta。

AppsFlyer会将SDK中配置的事件名称和事件值(包括事件参数)按原样转发到Meta,并以其原始的AppsFlyer SDK事件名称呈现,不会显示为“custom”。

您可以利用这些事件来优化您的广告投放。

自定义事件的自动参数映射

基于AppsFlyer与Meta的深度对接,AppsFlyer的众多标准SDK事件参数可自动映射到Meta侧的预定义参数。比如af_revenue参数会转换为Meta中的_valueToSum参数,这样您就可以发送每个事件的收入,用于数据衡量和Meta中的投放优化。

 注意

CUSTOM(自定义)和预定义事件的自动参数映射有所不同。

若使用预定义事件,_valueToSum对应的参数有时是af_price(例如fb_mobile_add_to_cart ),有时是af_revenue(例如fb_mobile_purchase)。

对于映射到CUSTOM的事件, af_price 总是映射到fb_price ,af_revenue总是映射到_valueToSum。

下表详细罗列了所有AppsFlyer事件的参数,这些参数通过CUSTOM事件映射到Meta时,会自动关联Meta侧对应的参数。

AppsFlyer参数 Meta侧参数
af_city fb_city
af_class 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_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

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_revenue
fb_mobile_rate af_rating_value
fb_mobile_search af_revenue
fb_mobile_spent_credits af_price
fb_mobile_achievement_unlocked none
fb_mobile_content_view af_price
StartTrial af_price
Subscribe af_revenue

事件和参数限制

您发送到Meta ads的事件受到以下规则的限制:

  • 不允许使用以下字符:
    • 冒号(:)
    • 期间(。)
    • 非拉丁(英文)字母的字符集:自2020年1月12日起,Meta不再支持中文字符。AppsFlyer尚未测试其他字符集,因此您在使用其他字符集之前,请先确认Meta是否支持回传中出现这些字符。 
  • 事件名称区分大小写。为避免差异,请确保在所有媒体源和应用程序版本的事件名称中使用正确的大小写。
  • 参数数量上限:25个。
  • 事件和参数名称的长度限制:2–40个字符。
  • 参数值长度上限:100个字符。
  • af_content参数值的长度上限:1000个字符。
  • 允许使用的字符:字母、数字、下划线、连字符和空格。请勿使用非拉丁(英文)字符。使用非拉丁字符会导致数据不一致。

为应用内事件命名时需要注意以下几点:

  • 您可以使用Meta侧的事件名称来命名AppsFlyer中的事件(如fb_price),但这类事件不能作为CUSTOM事件发送给Meta。
    为了避免回传映射问题,建议您不要使用Meta侧的事件名称来命名AppsFlyer事件。
  • 如需将应用内事件回传映射到Meta,请向其发送所有渠道的事件数据,包括自然量。

 重要提示!

除上述参数外,AppsFlyer会将其他所有CUSTOM事件数据按原样发送到Meta。广告主须负责确保其事件数据符合Meta的要求,且使用Meta认可的有效参数(见上文表格),否则Meta不会接收事件数据。