af_revenue 是报告收入的默认参数。已缴纳的收入af_revenue为 AppsFlyer 产品（仪表板、LTV、用户群、ROAS、ROI）提供所有收入指标，并包含在回传给合作伙伴的信息中。请务必根据您的业务逻辑，选择能实际产生收入的应用内事件来使用该参数。

如果您还想按照自己的逻辑报告收入，例如，扣除应用商店费用和税款后，您可以额外发送af_net_revenue。这是对……的补充af_revenue并非替代品。请参见下方的净收入。

• 通过SDK记录收入
• 通过Unity记录收入

您可以通过记录负收入来监测取消订单或发出退款等事件。只需在传递到af_revenueaf_revenueaf_revenue的收入值前面加上负号（-）即可记录负收入。

af_revenue也可以出现负值，用来记录取消交易或退款等事件。

收入值中仅可包含数字（必要时可以使用小数点）：

• 切勿在收入值中使用任何其他符号或格式，也就是说不能使用逗号、货币符号（如$）、特殊字符或文字。
• AppsFlyer 提供的收入值精确到小数点后 5 位。
• 该参数值的范围应介于-10,000到+10,000（美元或实际使用货币的等价金额）之间。在这个区间之外的值会出现在原始数据报告中，但汇总报告中不包含这类值。
• 示例：1234.56
• 以字符串的形式发送收入数据时，必须确保引号内的值是有效的。比如："1234.56"。

请注意：

• AppsFlyer后台会按原样展示SDK上报的收入数据，其中对VAT或应用商店抽成等不做任何计算。如需对SDK上报的收入作相应调整，SDK侧开发人员需要在上报收入前写入相关运算。如果您想申报扣除上述款项后的收入，请另行提交。af_net_revenue （参见净收入）。

af_currency 表示用于显示 af_revenue（或 af_price）的货币。如果事件参数缺少  af_currency，AppsFlyer 将以默认值“美元”发送。

您可使用 af_price 作为不计为收入的货币参数（例如“添加到购物车”事件）。 该参数意指单个商品价格。所有购买的总金额用 af_revenue 参数表示。

这af_net_revenue当您想要对收入金额应用自己的逻辑时，参数提供了一种可选的、额外的收入报告方式，例如，扣除应用商店费用、税收减免、毛利率或服务费后的收入。

af_net_revenue 不会取代 af_revenue。请继续发送af_revenue照常添加af_net_revenue当您需要净报告时，可以将其与它一起使用。

• 货币遵循af_currency（默认美元），类似于af_revenue。
• 由于没有预定义的 SDK 常量af_net_revenue您必须将其作为自定义参数发送，并带有密钥。af_net_revenue 。
• 净收入为“我的仪表盘”中的净指标（净收入、净投资回报率、净广告支出回报率、净每用户平均收入和净毛利润）提供支持。

AppsFlyer处理货币设置和货币换算的方式是非常重要的知识点，建议您了解相关内容。

AppsFlyer会通过货币换算来调和应用配置中的指定货币与应用内事件货币之间的差异。

上图说明了货币换算的大致流程，具体内容如下：

1. SDK发送应用内事件 — 每个事件的货币各不相同
2. AppsFlyer将所有货币统一换算到美元
3. AppsFlyer处理收入数据
4. 面板会按应用配置中的指定货币显示收入数据
5. AppsFlyer会在原始数据报告中同时用事件货币和应用配置中的指定货币来填充收入数据。

AppsFlyer使用Open Exchange Rates进行货币换算，其中的汇率每小时更新一次。AppsFlyer总是使用最近一小时内更新的汇率进行货币换算。

货币换算

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"EUR");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

货币显示

货币单位是在应用配置中设置的。您在应用配置中设置的货币单位就是面板数据的货币单位。无论您的应用内事件是以什么货币发送的，面板总是会按您在应用配置中设置的货币来显示收入数据。

确定了要衡量的应用内事件后，请使用应用内事件生成器按以下方式对事件和参数进行定义：

1. 基于您想要记录的场景，选择最合适的事件名称。
2. 考虑一下哪些参数能为该事件提供更多背景、使数据更丰富，请根据您的业务需求选择合适的参数，从而掌握更多的上下文信息并扩充相关数据。
3. 应用内事件生成器会根据您的设置生成相应代码并打包成压缩文件，请在生成器页面下载该文件并发送给您的开发人员。

下表所列的文章是我们针对各垂类推荐的常见应用内事件，其中包含实例和流程。

业务垂类	文章标题
	游戏类应用事件推荐
	电商类应用内事件推荐
	娱乐类应用事件推荐
	金融银行类应用内事件推荐
	P2P贷款类应用事件推荐
	在线教育类应用内事件推荐
	打车类应用事件推荐
	机票预订类应用内事件推荐
	酒店预订类应用事件推荐
	医疗保健类应用事件推荐
	电信类应用事件推荐
	电子钱包类应用的事件记录推荐
	体育博彩类应用内事件推荐

用户从某个媒体渠道安装应用后，该用户整个生命周期内发生的应用内事件都会归因到这个渠道。事件数据以用户生命周期价值或行为数据的形式呈现。 

您可在下列板块中查看应用内事件数据：

• 总览面板：实时显示LTV维度的UA效果数据。请注意：这些数据包括通过应用内事件上报的自然量和非自然量收入，以及经过双重归因的再营销收入。
• 事件面板：显示不同媒体渠道的LTV应用内事件效果。
• 活跃数据面板：显示选定时间段内的应用内用户行为数据。

• 原始数据应用内事件报告： 呈现用户行为数据及其含义，按时间顺序罗列所有用户完成的行为。该报告包含事件参数值，如：

  {
    "af_level":"10",
    "af_score":"3387",
    "arena":"7",
    "char_type":"paladin"
  }

  请注意，原始数据报告是高阶功能。

设置应用内事件名称和参数时请注意以下几点：

• 为确保原始数据报告中的数据一致性，我们建议在各平台上使用相同的应用内事件名称和结构，并对其做出相同的定义。
• 在对比不同渠道的用户质量时，建议您有针对性地选取事件，尽量缩减事件数量，以简化分析工作。
• 为了保护用户的隐私安全，请确保事件值中不包含能直接识别用户身份的信息，如电子邮箱、姓名、身份证件号码等，某些地区把邮编也作为身份识别信息。如需进一步了解受限数据，请参考服务隐私政策。
• 请注意，AppsFlyer会在用户互动期间收集设备的IP地址。在某些地区或使用场景中，IP地址也被视为个人身份识别信息（PII）。我们仅使用IP地址来获取粗粒度的地理位置信息（城市、行政区划层级），而非详细地址。如有需要，您可选择掩盖IP地址，不让这些信息出现在原始数据报告中。
• 应用内事件是AppsFlyer中收入数据的唯一来源。您可以将特定收入值附加到每个事件中, 并在应用的主面板上查看。详情请参考变现参数。

设置应用内事件名称和参数时请注意以下几点：

• 建议仅使用小写字母和数字（a-z 和0-9）来命名您的应用内事件。事件名称区分大小写，也就是说af_purchase和af_PURCHASE在原始数据中是两个不同的事件，但在汇总报表和面板中（例如“概览”或“事件”面板），事件名称仅支持小写字母，因此这些事件会被视为同一个事件并合并显示。
• 每天最多可用300个不同的事件。详情请见此处说明。
• 用户激活应用后完成的前100个事件有独立用户数指标，之后的事件不再统计该指标。
• 事件名称不能以下列字符开头：" = + - 
• 事件值中不能带有+号，但可在URL中以编码替换，或按ASCII进行编码。
• 事件名称中不能有空格，可以使用下划线代替。
• 事件值不能超过2000个字符，否则原始数据报告可能会缩短过长的事件值。对于SDK发出的事件，建议将事件值控制在1000个字符以下，这是为了确保通过HTTP请求发送这些数据时，有效信息（payload）不被截断。
• 如果事件值中包含链接，该链接必须经过URL编码。
• Meta ads对于事件名称和参数设有限制。点击此处查看限制详情。

您可以使用任何参数名称和事件发送收入值。但如果要在AppsFlyer的原始和聚合数据中记录收入（包括负收入），必须使用af_revenue参数。请务必根据您的业务逻辑，选择能实际产生收入的应用内事件来使用该参数。

af_currency代表af_revenue（或af_price）中所呈现金额的货币单位。如果事件中没有配置af_currency参数，AppsFlyer会以默认值“USD”（美元）为单位发送数据。关于af_revenue参数的详细信息，请参见收入归因指南。

如果您还想应用自己的逻辑来报告收入（例如，扣除费用和税款后），请发送af_net_revenue作为自定义参数af_revenue。af_net_revenue不取代af_revenue。有关更多信息，请参阅净收入。

AppsFlyer会将应用内事件归因到最初带来应用激活的那个媒体渠道。

用户激活应用（即首次打开应用）时，AppsFlyer会通过各种归因方式判断这次激活的归因结果。同时，AppsFlyer的SDK会生成一个全新的AppsFlyer ID，并关联到归因信息。

之后用户在同一个设备上完成的每一个应用内事件都会带有这个ID。这样，AppsFlyer就可以通过该ID将这些事件归因到最初带来用户的渠道，而广告主则可以使用该ID来追溯用户在其应用中的完整链路。

由新近再营销广告促成的事件可能会受到双重归因。

出现以下情况时，AppsFlyer会将用户在非自然激活后完成的事件计为自然量：

• 媒体渠道规定必须删除用户层级数据。
• 用户删除了应用在其设备上存储的数据，迫使SDK生成新的AppsFlyer ID。

如果用户在网络连接不可用时启动事件，Appsflyer仍然可以记录该事件。它是这样工作的：

1. SDK向AppsFlyer服务器发送事件后，会等待服务器回复一个发送成功的信息。
2. 如果SDK没有接收到这个信息，那么事件就会被保存到缓存中。
3. 而一旦收到了发送成功的回复，缓存中的事件就会被再次发送到服务器。
4. 如果缓存中有多个事件，这些事件会依次被发送到服务器。

复杂的应用内事件允许您在单个API调用中发送多个项目。当您想要将几个密切相关的用户操作组合在一起时，它们非常有用，例如在一次会话中将多个产品添加到购物车。

要构建复杂的应用内事件，请将 af_content 用作JSON数组。数组中的每个对象都必须包含 id 和 quantity。af_content_list 是可选的，可以省略。

{
  "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发送复杂应用内事件的完整详细信息，请参阅 Send complex in-app events to Meta ads。

请注意：在 AppsFlyer Audiences 中，事件属性内不支持数组，仅支持数字或字符串。

您可以在单笔交易中添加多个商品。您可以用多件商品的数组来描述一笔交易，商品之间用逗号区隔开，不需要针对每件商品分开填写参数值。格式是JSON字符串。

"{"af_content_id": ["123","988","399"], "af_quantity": ["2","1","1"], "af_price": ["25","50","10"], "af_revenue": "110", "af_currency": "USD"}"

我们会通过应用内事件去重机制它会检查所有应用内事件，以查看同一个 appsflyer_id 是否10秒内有同一个应用内事件。如果找到此类事件, 该机制将删除重复项。

如果两个事件中的以下字段相同, 系统将视其为同一个事件:

• Event name
• Event value
• 应用ID
• AppsFlyer ID

AppsFlyer会根据对接类型和合作渠道的要求保留原始的用户级数据。汇总数据最长可保留5年。

数据保留期限可能因媒体渠道和数据传输方式（例如Data Locker或Pull API）而异，并可能因法律、合同或合作渠道义务而发生变化。

数据一经删除，与被删除的用户有关的事件就会显示为自然流量事件，但之前的汇总数据保持不变。请参阅数据保留与删除义务了解详情。

• 安卓SDK和iOS SDK会自动添加OS（操作系统）参数。
• 对于S2S API，自2021年7月1日起，iOS应用必须发送OS（操作系统）参数。如果您不发送这个参数，那么系统就会默认数据来自iOS 14.5的用户，这会影响原始数据的呈现方式。