应用内事件 — 事件结构

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

速览

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

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

预定义事件名称

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

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

成就解锁(af_achievement_unlocked)

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_achievement_unlocked fb_mobile_achievement_unlocked unlock_achievement UnlockAchievement ACHIEVEMENT_UNLOCKED ACHIEVEMENT_UNLOCKED - achievement

常用参数:

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

广告点击(af_ad_click)

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

事件映射

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_ad_click AdClick - InAppADClick AD_CLICK - - -

常用参数:

请点击以下链接,查看各SRN的映射事件。

广告浏览(af_ad_view)

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_ad_view AdImpression - InAppADImpr AD_VIEW - - -

常用参数:

请点击以下链接,查看各SRN的映射事件。

添加付款信息(af_add_payment_info)

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

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

事件映射

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_add_payment_info fb_mobile_add_payment_info add_payment_info AddPaymentInfo ADD_BILLING ADDED_PAYMENT_INFO - ADD_BILLING

常用参数:

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

添加到购物车(af_add_to_cart)

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

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_add_to_cart fb_mobile_add_to_cart add_to_cart AddToCart ADD_CART ADD_TO_CART ADD_TO_SHOPPING_CART viewBasket

常用参数:

请点击以下链接,查看各SRN的映射事件。

添加到种草清单(af_add_to_wishlist)

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

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_add_to_wishlist fb_mobile_add_to_wishlist add_to_wishlist AddToWishlist ADD_TO_WISHLIST ADD_TO_WISHLIST - -

常用参数:

请点击以下链接,查看各SRN的映射事件。

完成注册(af_complete_registration)

说明: 用于记录用户的注册方式

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_complete_registration fb_mobile_complete_registration sign_up Registration SIGN_UP SIGN_UP SIGN_UP -

常用参数:

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

内容浏览(af_content_view)

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

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_content_view fb_mobile_content_view view_item ViewContent VIEW_CONTENT CONTENT_VIEW PAGE_VIEW viewProduct

常用参数:

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

发起结帐(af_initiated_checkout)

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

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_initiated_checkout fb_mobile_initiated_checkout begin_checkout Checkout START_CHECKOUT CHECKOUT_INITIATED CHECKOUT viewBasket

常用参数:

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

邀请(af_invite)

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

常见于以下垂类:游戏

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_invite - invite - INVITE INVITE - -

常用参数:

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

通关级别(af_level_achieved)

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

常见于以下垂类:游戏

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_level_achieved fb_mobile_level_achieved level_up AchieveLevel LEVEL_COMPLETE LEVEL_ACHIEVED - userLevel

常用参数:

请点击以下链接,查看各SRN的映射事件。

列表浏览(af_list_view)

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

常见于以下垂类: 电商

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_list_view - view_item_list - LIST_VIEW - - viewListing

常用参数:

请点击以下链接,查看各SRN的映射事件。

登录(af_login)

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

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_login - login Login LOGIN LOGIN - -

从推送消息打开应用(af_opened_from_push_notification)

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_opened_from_push_notification - notification_open - - - - -

购买(af_purchase)

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

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_purchase fb_mobile_purchase in_app_purchase Purchase PURCHASE PURCHASE OFF_AMAZON_PURCHASES transactionConfirmation

常用参数:

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

评分(af_rate)

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_rate fb_mobile_rate submit_rating Rate Rate RATED - -

常用参数:

请点击以下链接,查看各SRN的映射事件。

再互动(af_re_engage)

说明: 用于记录用户再互动事件

事件映射:

AppsFlyer Meta ads Google Ads Snap X Ads Amazon Ads Criteo
af_re_engage - custom_event - RE_ENGAGE - -

常用参数:

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

搜索(af_search)

说明: 用于记录搜索事件

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_search fb_mobile_search view_search_results Search SEARCH SEARCH SEARCH viewSearch

常用参数:

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

分享(af_share)

说明: 用于记录分享事件

常见于以下垂类:游戏

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_share - share - SHARE SHARE - -

常用参数:

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

积分消费(af_spent_credits)

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

常见于以下垂类:打车

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_spent_credits fb_mobile_spent_credits spend_virtual_currency SpendCredits SPENT_CREDITS SPENT_CREDITS - transactionConfirmation

常用参数:

请点击以下链接,查看各SRN的映射事件。

开始试用(af_start_trial)

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

常见于以下垂类:娱乐

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_start_trial StartTrial - StartTrial START_TRIAL - - -

常用参数:

请点击以下链接,查看各SRN的映射事件。

 注意

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

订阅(af_subscribe)

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

常见于以下垂类:娱乐

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_subscribe Subscribe - Subscribe SUBSCRIBE - SUBSCRIBE SUBSCRIBE

常用参数:

请点击以下链接,查看各SRN的映射事件。

行程预订(af_travel_booking)

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

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_travel_booking fb_mobile_purchase ecommerce_purchase Purchase RESERVE PURCHASE -  transactionConfirmation

常用参数:

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

完成新手教学(af_tutorial_completion)

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

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

事件映射:

AppsFlyer Meta ads Google Ads TikTok Snap X Ads Amazon Ads Criteo
af_tutorial_completion fb_mobile_tutorial_completion tutorial_complete CompleteTutorial COMPLETE_TUTORIAL TUTORIAL_COMPLETE - -

常用参数:

请点击以下链接,查看各SRN的映射事件。

更新(af_update)

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

事件映射:

AppsFlyer Meta ads Google Ads Snap X Ads Amazon Ads Criteo
af_update - app_update - UPDATE - -

常用参数:

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

 注意

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

预定义事件参数

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

 注意

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

af_adrev_ad_type

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

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_adrev_ad_type ad_type - - - - -

af_city

说明: 预订乘车的城市

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_city fb_city - - - flight_city -

af_class

说明: 预订的机票舱位

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_class fb_travel_class travel_class - - flight_class -

af_content

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

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_content fb_content - - - - -

af_content_id

说明: 相关商品的ID

请注意:对于预定义事件af_content_listaf_content_id,Snapchat侧只有一个对应的事件。同时记录到两个事件时,AppsFlyer仅向Snapchat发送af_content_list事件。

参数映射:

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

af_content_list

说明: 内容ID列表

请注意:对于预定义事件af_content_listaf_content_id,Snapchat侧只有一个对应的事件。同时记录到两个事件时,AppsFlyer仅向Snapchat发送af_content_list事件。

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_content_list - item_id item_ids - - -

af_content_type

说明: 产品类别

参数映射:

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

af_country

说明: 预订乘车的国家

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_country fb_country - - - flight_country -

af_currency

说明: 货币代码

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Amazon Ads Criteo
af_currency fb_currency currency_code currency price_currency currency currency currency

af_customer_user_id

说明: 客户用户ID(即CUID)

参数映射:

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

af_date_a

说明: 入住日期

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_date_a fb_checkin_date start_date - - checkin_date din

af_date_b

说明: 退房日期

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_date_b fb_checkout_date end_date - - checkout_date dout

af_departing_arrival_date

说明: 到达日期

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_departing_arrival_date fb_departing_arrival_date - - - - -

af_departing_departure_date

说明: 出发日期

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_departing_departure_date fb_departing_ departure_date - - - departing_date -

af_description

说明: 简要描述(字符串)

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_description fb_description description description description description ui_achievement

af_destination_a

说明: 第一个目的地

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_destination_a fb_origin_airport origin - - departing_airport -

af_destination_b

说明: 第二个目的地

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_destination_b fb_destination_
airport
destination - - destination_airport -

af_destination_list

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

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_destination_list fb_destination_ids - - - - -

af_hotel_score

说明: 用户评价中对酒店的评分

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_hotel_score fb_hotel_score - - - - -

af_level

说明: 用户达到的等级

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_level fb_level level_up level level - ui_level

af_max_rating_value

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

参数映射:

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

af_num_adults

说明: 成人旅客人数

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_num_adults fb_num_adults - - - num_people -

af_num_children

说明: 儿童旅客人数

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_num_children fb_num_children - - - num_children -

af_num_infants

说明: 婴儿旅客人数

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_num_infants fb_num_infants - - - - -

af_order_id

说明: 相关交易的ID

参数映射:

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

af_payment_info_available

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

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok 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 X Ads TikTok Criteo
af_preferred_neighborhoods fb_preferred_neighborhoods - - - - -

af_preferred_num_stops

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

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_preferred_num_stops fb_preferred_num_stops - - - - -

af_preferred_price_range

说明: 用户首选的酒店价位

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_preferred_price_range fb_preferred_price_range - - - - -

af_preferred_star_ratings

说明: 用户首选的酒店星级

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_preferred_star_ratings fb_preferred_star_ratings - - - - -

af_price

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

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_price fb_price price price price_micro price price

af_projected_revenue

在相关用户产生实际收入前,广告主根据其早前的互动或行为模式预计的收入金额。如需进一步了解预计收入的相关信息,请参考此文档。 

af_purchase_currency

说明: 购买时支付的货币

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_purchase_currency fb_purchase_currency - - - - -

af_quantity

说明: 商品数量

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_quantity fb_num_items quantity number_items number_items quantity quantity

af_rating_value

说明: 用户评分的分值

参数映射:

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

af_receipt_id

说明: 相关收据的ID

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_receipt_id - transaction_id - -  - transaction_id

af_region

说明: 预订乘车的地区

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_region fb_region - - - flight_region -

af_registration_method

说明: 注册方式的类型

参数映射:

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

af_returning_arrival_date

说明: 回程结束的日期和时间

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_returning_arrival_date fb_returning_arrival_ date - - - - -

af_returning_departure_date

说明:  回程开始的日期和时间

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_returning_departure_date fb_returning_departure_date - - - returning_date -

af_revenue

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

 重要提示!

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

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

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Amazon Ads Criteo
af_revenue _valueToSum value price price_micro value Event value ui_revenue

af_score

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

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_score - - - score - -

af_search_string

说明: 搜索词

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_search_string fb_search_string search_string search_string search_string - -

af_subscription_id

说明: 用户的订阅ID 

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_subscription_id subscription_id - - - - -

af_success

说明: 是否成功完成操作

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_success fb_success success success - - -

af_suggested_destinations

说明: 推荐的目的地列表

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_suggested_destinations fb_suggested_ destinations - - - - -

af_suggested_hotels

说明: 推荐的酒店列表

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_suggested_hotels fb_suggested_hotels - - - - -

af_travel_end

说明: 行程结束日期

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_travel_end fb_travel_end - - - - -

af_travel_start

说明: 行程开始日期

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_travel_start fb_travel_start - - - - -

af_user_score

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

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok Criteo
af_user_score fb_user_score - - - - -

af_validated

说明: 用于说明购买事件的验证结果

参数映射:

AppsFlyer Meta ads Google Ads Snap X Ads TikTok 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