跟踪应用内事件
应用内事件通过跟踪用户行为（如游戏应用中的登录、注册、教程完成或等级提升），帮助您衡量营销活动的绩效和关键绩效指标（KPI）。Singular 收集这些事件，以便深入了解用户行为，优化营销工作。
标准事件与自定义事件
Singular 支持两种类型的事件：
- 标准事件：由 Singular 识别的预定义事件（如sngLogin,sngContentView ），通常由广告网络支持，用于报告和优化。使用标准事件可简化设置，因为 Singular 会自动将其添加到 "事件 "列表中，无需手动定义。建议为了兼容性和易用性，尽可能使用标准事件。有关标准事件名称和推荐属性，请参阅 "标准事件和属性列表"。
-
自定义事件：与 Singular 标准事件不匹配的应用程序特有事件（如Signup,AchievementUnlocked ）。
自定义事件限制：
- 我们强烈建议以英文传递事件名称和属性，以保证与第三方合作伙伴和分析解决方案（如果您计划使用它们）的兼容性。
- 事件名称限制为 32 个 ASCII 字符。转换为 UTF-8 后，非 ASCII 字符的字符串必须小于 32 字节。
- 属性和值限制为 500 个 ASCII 字符。
请与您的用户体验、营销或业务团队合作，根据您应用程序的营销关键绩效指标编制事件和属性列表。请参阅《如何跟踪应用程序内事件：Singular Attribution 客户指南》，了解如何选择事件。
发送事件
- 使用事件方法通过 Singular 的 SDK 跟踪简单的自定义事件。
- 使用eventWithArgs方法，使用 Singular 的 SDK 跟踪带有附加属性的自定义事件。
最佳实践
- 使用标准事件：首选标准事件，以便与广告网络兼容，并在 Singular 的事件列表中自动识别。
- 验证属性：检查属性是否符合预期格式。
- 调试事件：在开发过程中启用 SDK 日志，以验证事件发送是否正确，并在应用程序生命周期的适当时刻触发（例如，用户登录后）。
注意：与您的用户体验/营销团队协调，确保跟踪的事件与您应用程序的 KPI 一致。在部署到生产环境之前，先在开发环境中测试事件，以验证 Singular Dashboard 中数据的准确性。
跟踪收入
通过 Singular 的 React Native SDK，您可以跟踪应用程序内的收入事件，以分析营销活动的绩效和投资回报率。收入数据可在 Singular 的报告、日志导出和回传中获得，从而为您的应用货币化提供可操作的见解。
为什么要跟踪收入事件？
- 丰富的分析功能：捕捉详细的交易数据，增强 Singular 报告。
- 预防欺诈：包括交易收据（如来自 Google Play 或 Apple App Store 的收据），以验证购买并打击应用内欺诈。
- 营销活动优化：通过将收入与营销工作挂钩来衡量投资回报率。
最佳实践：传递完整的购买对象
我们强烈建议传递从安卓（谷歌播放计费）或iOS（StoreKit）应用内购买（IAP）流程返回的购买对象。这样可以确保Singular收到全面的交易详细信息，包括
- 产品 ID
- 价格
- 货币
- 交易 ID
- 收据数据（用于验证）
通过传递完整的购买对象，您可以获得更丰富的报告，并利用 Singular 的欺诈检测功能，尤其是针对 Google Play 交易。
捕获 IAP 购买对象
使用Flutter IAP 包管理应用程序中的交易并检索购买对象。
发送 IAP 收入
- 使用inAppPurchase方法跟踪带有购买详细信息的应用内购买事件。
- 使用inAppPurchaseWithAttributes方法跟踪带有购买详情和附加自定义属性的应用内购买事件。
不使用购买对象发送收入
虽然我们强烈建议使用 inAppPurchase 方法报告收入事件以进行收入验证，但您也可以通过传递货币和交易金额向 Singular 发送收入事件。
重要：在没有有效购买对象的情况下发送收入事件时，Singular 不会验证交易。
要求
注意：传递货币为三个字母的 ISO 4217 货币代码，例如"USD," "EUR", "INR" 。
- 使用customRevenue方法跟踪具有指定事件名称、货币和金额的自定义收入事件。
- 使用customRevenueWithAllAttributes方法跟踪带有指定事件名称、货币、金额和其他自定义属性的自定义收入事件。
- 使用customRevenueWithAttributes方法以地图对象的形式跟踪具有指定事件名称、货币、金额和其他自定义属性的自定义收入事件。
发送订阅收入
Singular 提供了如何使用 Singular SDK 实现订阅事件的综合指南。它涵盖了跨各种平台的应用内订阅事件跟踪。
- 如果您想跟踪订阅收入，请阅读我们的《订阅事件技术实施指南》。
发送广告收入
广告收入归因可帮助您将广告收入与将用户引入应用程序的特定广告活动联系起来。通过在一个地方显示广告活动成本、应用内收入和广告收入，您可以清楚地了解广告效果如何。这项功能还能让您将广告收入数据发送回广告网络，以提高广告效果。
混合事件跟踪
Singular 建议通过集成到应用程序中的 Singular SDK 发送所有事件和收入。但是，Singular 也可以从其他来源收集事件和收入。
任何非通过Singular SDK发送的事件都必须符合Singular的服务器到服务器事件文档要求，并提供匹配的设备标识符以正确归属事件。
重要：
如果服务器到服务器事件请求中使用的设备标识符在 Singular 中没有匹配的设备标识符，就会出现差异。请注意以下可能性：
- 如果事件请求是在 Singular SDK 从应用程序会话记录设备标识符之前收到的，那么该事件请求将被视为未知设备的 "第一次会话"，Singular 将把该设备作为有机归属。
- 如果 Singular SDK 确实记录了设备标识符，但 Singular SDK 标识符与服务器到服务器事件请求中指定的设备标识符不同，那么事件将被错误归属。
混合事件跟踪指南
Singular可以收集来自服务器的收入数据，以帮助分析营销活动的性能和投资回报率。
要求：
- 从应用内注册或登录事件中捕获并传递设备标识符，并将此数据与服务器上的用户 ID 一起存储。由于用户的设备标识符可能会发生变化，因此请确保在用户生成应用程序会话时更新标识符。这将确保服务器端事件归属于正确的设备。
- 服务器端事件是平台特定的，只能使用与设备平台相匹配的设备标识符发送（如 iOS 设备的 IDFA 或 IDFV）。
- 您可以使用 Singular 内部 BI 回传机制将事件实时推送到内部端点，以便更新服务器端的数据集。请参阅内部 BI 回传常见问题。
- 查看服务器到服务器集成指南中的 "跟踪收入"部分，了解详情。
请点击以下链接了解如何启用这些合作伙伴。