富应用内事件 — 事件结构

概要:本文列出了广告主可以选择的预定义事件名称和参数,用于记录激活后的富应用内事件(如登录、注册、应用内购等)。

 相关文章

如需全方位了解如何使用应用内事件,请参考以下文章:

概述

您的开发人员需要在应用中的相关位置添加代码后您才能发送对应的应用内事件。本文对各种预定义事件名称和及其对应参数做了详细说明。

如果您不确定需要记录哪些事件和参数,请参考我们按垂类梳理的推荐事件(含示例和流程)。

预定义事件名称

下表列出了用于Meta ads、Google Ads、Snap、Twitter和Criteo的预定义事件名称和事件映射。

每个事件名称都包含了与该事件有关的常用预定义事件参数。您可根据自己的业务需求,选择任何适用的事件参数。

成就解锁(af_achievement_unlocked)

说明: 用于记录成就解锁事件

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_achievement_unlocked

fb_mobile_achievement_unlocked

unlock_achievement

ACHIEVEMENT_UNLOCKED

ACHIEVEMENT_UNLOCKED

achievement

常用参数:

点击链接查看对SRN的映射。

广告点击(af_ad_click)

说明: 用于记录应用中的广告点击和广告展示

事件映射

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_ad_click

广告点击

-

AD_CLICK

-

-

常用参数:

点击链接查看对SRN的映射。

广告浏览(af_ad_view)

说明: 用于记录应用中展示广告的观看

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_ad_view

AdImpression

-

AD_VIEW

-

-

常用参数:

点击链接查看对SRN的映射。

添加付款信息(af_add_payment_info)

说明: 用于记录付款信息配置状态

常见于以下垂类:打车机票预订

事件映射

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_add_payment_info fb_mobile_add_payment_info add_payment_info ADD_BILLING ADDED_PAYMENT_INFO ADD_BILLING

常用参数:

点击链接查看对SRN的映射。

添加到购物车(af_add_to_cart)

说明:用于记录具体商品的加购事件。如需在单个事件中包含多件商品,请点击此处查看指南。

常见于以下垂类:电商医疗

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_add_to_cart fb_mobile_add_to_cart add_to_cart ADD_CART ADD_TO_CART viewBasket

常用参数:

点击链接查看对SRN的映射。

收藏到种草清单(af_add_to_wishlist)

说明:用于记录具体商品的种草清单收藏事件。如需在单个事件中包含多件商品,请点击此处查看指南。

常见于以下垂类:电商酒店预订

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_add_to_wishlist fb_mobile_add_to_wishlist add_to_wishlist ADD_TO_WISHLIST ADD_TO_WISHLIST -

常用参数:

点击链接查看对SRN的映射。

完成注册(af_complete_registration)

说明: 用于记录用户注册方法

常见于以下垂类:游戏电商娱乐金融与银行服务P2P贷款在线教育打车酒店预订医疗电信

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_complete_registration fb_mobile_complete_registration sign_up SIGN_UP SIGN_UP -

常用参数:

点击链接查看对SRN的映射。

内容视图(af_content_view)

说明:用于记录内容浏览事件如需在单个事件中包含多件商品,请点击此处查看指南。

常见于以下垂类:电商机票预订酒店预订

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_content_view

fb_mobile_content_view

view_item

VIEW_CONTENT

CONTENT_VIEW

viewProduct

常用参数:

点击与您的业务需求相关的参数,查看这些参数在各SRN中的对应字段。

发起结帐(af_initiated_checkout)

说明:用于记录结账事件如需在单个事件中包含多件商品,请点击此处查看指南。

常见于以下垂类:电商酒店预订

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_initiated_checkout fb_mobile_initiated_checkout begin_checkout START_CHECKOUT

CHECKOUT_INITIATED

viewBasket

常用参数:

点击与您的业务需求相关的参数,查看这些参数在各SRN中的对应字段

邀请(af_invite)

说明: 用于记录邀请 (社交) 事件

常见于以下垂类:游戏

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_invite

-

invite

INVITE

INVITE

-

常用参数:

点击链接查看对SRN的映射。

通关(af_level_achieved)

说明: 用于记录游戏等级事件

常见于以下垂类:游戏

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_level_achieved fb_mobile_level_achieved level_up LEVEL_COMPLETE LEVEL_ACHIEVED 用户层级

常用参数:

点击链接查看对SRN的映射。

列表视图(af_list_view)

说明: 用于记录浏览列表事件

常见于以下垂类: 电商

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_list_view

-

view_item_list

LIST_VIEW

-

viewListing

常用参数:

点击链接查看对SRN的映射。

登录(af_login)

说明: 用于记录用户登录事件

常见于以下垂类:游戏电商娱乐金融与银行服务在线教育酒店预订医疗电信

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_login

-

登录

-

登录

-

点击推送消息打开应用(af_opened_from_push_notification)

说明: 用于记录从推送通知打开应用的事件

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_opened_from_push_notification

-

notification_open

-

-

-

购买(af_purchase)

说明:用于记录购买事件(并将收入关联到这些事件)请点击此处查看AppsFlyer支持的货币符号列表。如需在单个事件中包含多件商品,请点击此处查看指南。

常见于以下垂类游戏电商在线教育医疗电信

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_purchase

fb_mobile_purchase

in_app_purchase

PURCHASE

PURCHASE

transactionConfirmation

常用参数:

点击与您的业务需求相关的参数,查看这些参数在各SRN中的对应字段

评分(af_rate)

说明:用于记录应用/商品的评价事件。如需在单个事件中包含多件商品,请点击此处查看指南。

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_rate

fb_mobile_rate

submit_rating

Rate

RATED

-

常用参数:

点击链接查看对SRN的映射。

促活(af_re_engage)

说明: 用于记录用户重参与事件

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_re_engage

-

custom_event

-

RE_ENGAGE

-

常用参数:

点击链接查看对SRN的映射。

分享(af_share)

说明: 用于记录分享事件

常见于以下垂类:游戏

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_share

-

份额

分享

分享

-

常用参数:

点击链接查看对SRN的映射。

积分消费(af_spent_credits)

说明:用于记录虚拟币支出事件如需在单个事件中包含多件商品,请点击此处查看指南。

常见于以下垂类:打车

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_spent_credits

fb_mobile_spent_credits

spend_virtual_currency

SPENT_CREDITS

SPENT_CREDITS

transactionConfirmation

常用参数:

点击链接查看对SRN的映射。

开始试用(af_start_trial)

说明: 用于记录产品的免费试用的开始时间

常见于以下垂类:娱乐

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_start_trial

开始试用

-

START_TRIAL

-

-

常用参数:

点击链接查看对SRN的映射。

 注意

如果您要让这个事件对应到Meta ads的StartTrial(开始试用)事件,并关联收入,请把参数设为af_price,而不是af_revenue。

订阅(af_subscribe)

说明: 用于记录付费订阅购买

常见于以下垂类:娱乐

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_subscribe

Subscribe

-

-

-

SUBSCRIBE

常用参数:

点击链接查看对SRN的映射。

旅行预订(af_travel_booking)

说明:用于记录行程预定事件(并将收入关联到这些事件)。如需在单个事件中包含多件商品,请点击此处查看指南。

常见于下列垂类:机票预订酒店预订

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_travel_booking

fb_mobile_purchase

ecommerce_purchase

RESERVE

PURCHASE

 transactionConfirmation

常用参数:

点击与您的业务需求相关的参数,查看这些参数在各SRN中的对应字段

完成教程(af_tutorial_completion)

说明:用于记录完成教程事件。如需在单个事件中包含多件商品,请点击此处查看指南。

常见于以下垂类:游戏在线教育

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_tutorial_completion fb_mobile_tutorial_completion tutorial_complete COMPLETE_TUTORIAL TUTORIAL_COMPLETE -

常用参数:

点击链接查看对SRN的映射。

更新(af_update)

说明:用于记录更新事件。如需在单个事件中包含多件商品,请点击此处查看指南。

事件映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_update

-

app_update

-

更新

-

常用参数:

点击链接查看对SRN的映射。

 注意

除了本章中提到的预定义事件名称以外,Meta ads还提供额外的预定义事件选项 ,这些事件是不能设置参数的。

预定义事件参数

本章为您列举了预定义事件参数,并针对每个事件参数都列出了Meta ads、Google Ads、Snap、Twitter和Criteo的相应字段,用于事件映射。您可以在一个事件中添加任意事件参数。

 注意

您可以在原始数据报告(高阶功能)的“事件值”一列查看事件参数

af_adrev_ad_type

说明:广告类型(如横幅或插屏广告)

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_adrev_ad_type

ad_type

-

-

-

-

af_city

说明:网约车所在城市

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_city

fb_city

- - - -

af_class

说明:预订的机票舱位

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_class

fb_travel_class

travel_class - - -

af_content

说明:内容标题(如歌曲名称或电视剧集标题)

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_content fb_content - - - -

af_content_id

说明:商品ID

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_content_id fb_content_id item_id item_ids content_id id

af_content_list

说明:内容 ID列表

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_content_list - item_id - - -

af_content_type

说明:产品品类

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_content_type fb_content_type item_category item_category content_type -

af_country

说明:网约车所在国家

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_country

fb_country

- - - -

af_currency

说明:货币代码

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_currency

fb_currency

currency_code

currency

price_currency

currency

af_customer_user_id

说明:客户ID

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_customer_user_id - customer_user_
id
- - cid

af_date_a

说明:入住日期

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_date_a

fb_checkin_date

start_date - - din

af_date_b

说明:退房日期

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_date_b

fb_checkout_date

end_date - - dout

af_departing_arrival_date

说明:到达日期

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_departing_arrival_date

fb_departing_arrival_date

- - - -

af_departing_departure_date

说明:出发日期

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_departing_departure_date

fb_departing_
departure_date

- - - -

af_description

说明:简短说明(字符串)

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_description

fb_description

description

description

description

ui_achievement

af_destination_a

说明:第一个目的地

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_destination_a

fb_origin_airport

origin - - -

af_destination_b

说明:第二个目的地

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_destination_b

fb_destination_
airport

destination - - -

af_destination_list

说明:包含在目的地类别中的目的地列表(如酒店附近的博物馆或餐厅列表)

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_destination_list

fb_destination_ids

- - - -

af_hotel_score

说明:来自酒店评价的评分

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_hotel_score

fb_hotel_score

- - - -

af_level

说明:用户成功通过的关卡

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_level

fb_level

level_up level level ui_level

af_max_rating_value

说明:评分较高(如5星好评)

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_max_rating_value fb_max_rating_value max_rating - max_rated_value -

af_num_adults

说明:成人旅客人数

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_num_adults fb_num_adults - - - -

af_num_children

说明:儿童旅客人数

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_num_children fb_num_children - - - -

af_num_infants

说明:婴儿旅客人数

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_num_infants

fb_num_infants

- - - -

af_order_id

说明:交易ID

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_order_id fb_order_id order_id transaction_id - transaction_id

af_payment_info_available

说明:用户的付款信息是否可用

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_payment_info_available fb_payment_info_ available payment_info_
available
payment_info_available user_payment_
info
-

af_preferred_neighborhoods

说明:酒店所在区域

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_preferred_neighborhoods fb_preferred_neighborhoods - - - -

af_preferred_num_stops

说明:理想的经停站点数量(如直飞航班)

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_preferred_num_stops fb_preferred_num_stops - - - -

af_preferred_price_range

说明:理想的酒店价位

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_preferred_price_range fb_preferred_price_range - - - -

af_preferred_star_ratings

说明:理想的酒店星级

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_preferred_star_ratings fb_preferred_star_ratings - - - -

af_price

说明:产品价格。您可以使用af_price作为货币参数,将其与加购等计入收入的事件区分开。该参数表示商品单价,而af_revenue参数则显示所有订单金额的总和。

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_price fb_price price price price_micro price

af_purchase_currency

说明:支付货币

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_purchase_currency fb_purchase_currency - - - -

af_quantity

说明:商品数量

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_quantity - quantity number_items number_items quantity

af_rating_value

说明:打分分值

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_rating_value _valueToSum value - price_micro -

af_receipt_id

说明:收据ID

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_receipt_id - transaction_id - - transaction_id

af_region

说明:网约车所在区域

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_region

fb_region

- - - -

af_registration_method

说明:注册方式分类

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_registration_method fb_registration_method registration_method sign_up_method registration_method -

af_returning_arrival_date

说明回程结束日期和时间

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_returning_arrival_date

fb_returning_arrival_ date

- - - -

af_returning_departure_date

说明回程开始日期和时间

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_returning_departure_date

fb_returning_departure_date

- - - -

af_revenue

说明:订单总额。在AppsFlyer平台中,af_revenue是记录收入的参数。该参数也能统计取消订单或退款等事件造成的负收入

 注意事项!

收入值中不能包含逗号分隔符、货币、特殊字符或文字。比如1234.56就是一个有效的收入值。AppsFlyer能支持精确到小数点后五位的收入值。

请点击这里查看收入参数的使用方法。

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo

af_revenue

_valueToSum

value price price_micro ui_revenue

af_score

说明:与用户成就相关的分数

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_score - - - score -

af_search_string

说明:搜索词条

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_search_string fb_search_string search_string search_string search_string -

af_subscription_id

说明:用户的订阅ID

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_subscription_id subscription_id - - - -

af_success

说明:是否成功完成操作

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_success fb_success success success - -

af_suggested_destinations

说明推荐目的地列表

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_suggested_destinations fb_suggested_ destinations - - - -

af_suggested_hotels

说明:推荐酒店列表

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_suggested_hotels fb_suggested_hotels - - - -

af_travel_end

说明:行程结束日期

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_travel_end

fb_travel_end

- - - -

af_travel_start

说明:行程开始日期

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_travel_start

fb_travel_start

- - - -

af_user_score

说明用户对广告主的相对重要性

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_user_score

fb_user_score

- - - -

af_validated

说明:验证购买

参数映射:

AppsFlyer Meta ads Google Ads Snap Twitter Criteo
af_validated

-

validated success - -

下列预定义参数不包含SRN映射:

  • af_achievement_id
  • af_coupon_code
  • af_customer_segment 
  • af_deep_link
  • af_event_end
  • af_event_start
  • af_lat
  • af_long
  • af_new_version
  • af_old_version
  • af_param_1
  • af_param_2
  • af_param_3
  • af_param_4
  • af_param_5
  • af_param_6
  • af_param_7
  • af_param_8
  • af_param_9
  • af_param_10
  • af_review_text
  • af_tutorial_id
  • af_virtual_currency_name
  • af_duration_seconds