设置 ironSource
ironSource 是一家已与 Adjust 集成的广告渠道。我们的集成允许 ironSource 通过自动回传接收归因和应用内事件数据。
在本文中了解如何为您的应用设置 ironSource 监测,这包括激活集成、创建推广活动链接、以及选择 Adjust 可以与 ironSource 分享的数据。
操作前须知
要求
- Adjust 中的管理员、编辑员或自定义编辑员权限。
- Adjust SDK v4.0.0 或更新版本,以便将 SDK 参数映射至 ironSource 参数。按照以下指南使用此功能。
iOS | 安卓 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
凭证
ADVERTISER ID 和 PASSWORD
- 如需帮助查找凭证,请联系您的 ironSource 代表。
在 Campaign Lab 中选择 ironSource 和应用
- 找到 Campaign Lab ,选择 合作伙伴 。
- 选择 新合作伙伴 > ironSource 。选择 下一步 进入下一界面。
- 在 应用选择 界面选择要创建链接的应用,启用集成来与 ironSource 分享数据。
- 选择 下一步 。
启用数据分享
启用数据分享以激活与 ironSource 的集成。要启用数据分享:
- 输入您的 ADVERTISER ID 和 PASSWORD。
启用与 ironSource 的数据分享后,Adjust 会默认自动向 ironSource 发送以下数据:
- 安装
- 会话
- 事件
- 被拒安装
- 广告收入
设置数据分享
如果您的多平台应用启用了多个平台的数据分享,那么可以:
- 通过选择 使用平台特定设置 来在平台层级区分数据共享设置。
- 通过选择 使用全局设置 来为多个平台应用相同的数据共享设置。
在 哪些数据会默认分享? 部分, 查看 Adjust 默认与 ironSource 分享的活动。
- 安装
- 会话
- 事件
- 被拒安装
- 广告收入
发送额外数据
选择您想通过回传与 ironSource 分享的数据量和数据类型。ironSource 可能会使用此信息来优化表现。
- 在 您想分享哪些数据来源? 部分,选择与 ironSource 分享数据的归因来源:
- 来自所有归因渠道的数据
- 仅限归因至 ironSource 的数据
广告收入 (来自广告查看)
通过广告收入分享,ironSource 能够接收用户广告收入数据。而 ironSource 可以使用广告收入数据来优化您的用户定向和推广活动。
Adjust 的广告收入套餐可为您提供此功能。如需购买我们的广告收入套餐,请联系您的销售代表。
要与 ironSource 分享广告收入,请选择一个或多个 广告收入来源 。
- 若此处留白,我们则会发送所有已集成的广告收入来源。
会话
由于会话数量过大,Adjust 不会自动发送会话回传。启用会话分享后,ironSource 将接收应用的会话活动数据。
应用内收入 (来自应用内购买)
通过应用内收入分享,ironSource 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件,才能分享该数据。
映射事件
将您想分享的事件映射到 ironSource 可以接收的值。未映射事件的数据不会被发送至 ironSource。
映射单个事件
如果您的应用为多平台应用,则可以选择按平台与 ironSource 分享不同事件。这有助于您:
- 通过设定单个事件来管理不同平台的推广活动策略。
- 按平台自定义数据分享。
在 映射事件 中,按照以下步骤选择要直接发送至 ironSource 的应用内事件。
选择 映射事件 。
在 Adjust 事件 列表中,选择要与 ironSource 分享的 Adjust 事件。
在 合作伙伴事件 下,您需要选择与 Adjust 事件对应的 ironSource 事件。
对于单平台应用和仅针对一个平台启用了数据共享的多平台应用,您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用,您可以:
- 选择 使用平台特定映射 来在平台层级映射单独事件或不针对某些平台映射事件。
- 选择 使用全局映射 来为所有平台映射相同的事件。
打开 合作伙伴 列表,选择要映射到 Adjust 事件的渠道事件,或输入自定义事件名称。
选择 确认 。
现在 ironSource 将接收每个关联事件的应用内事件数据。
映射全部事件
如果 ironSource 支持自动映射所有事件,则在 映射事件 下选择 映射全部事件 ,这能够省去映射单个事件的时间。
现在 ironSource 将接收所有关联事件的应用内事件数据。
映射参数
要与 ironSource分享自定义数据,您通常需要映射参数。
合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点,并将其发送至 ironSource。借此,ironSource 可以接收每个已关联事件的自定义事件详情。
在向 Adjust SDK 添加新的合作伙伴参数之前,请确保现有的合作伙伴参数均不符合您的要求。
如需与 ironSource 分享合作伙伴参数,请遵循以下步骤。
在 Adjust SDK 中设置合作伙伴参数。
- 在操作前须知部分查看所有 SDK 开发平台链接。
在 设置数据分享 下,选择 参数 。
打开 映射参数 ,选择如何向渠道发送 SDK 中指定的合作伙伴参数。
- 选择 映射参数 。
- 在 SDK 参数 字段中输入要与渠道分享的 SDK 参数名称。
- 在 合作伙伴参数 字段中输入 SDK 参数对应的渠道参数。
如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享,那么 Adjust 会按照 Adjust SDK 中的名称发送参数。
配置链接和设置
您可以进行以下设置:
创建链接并与 ironSource 分享
在 设置概览 界面,您可以检查自己的选择,也可以返回并更改以下内容:
- 所选应用
- 数据分享选项
- 链接结构参数
- 用户目的位置
- 归因设置
选择 创建链接 来创建点击 URL、展示 URL、二维码和链接识别码。创建链接还会启用数据共享及与 ironSource 的集成。
创建链接后,请与 ironSource 分享链接,以便在推广活动中放置。
转发给 ironSource 的所有参数列表
ironSource 要求 Adjust 在回传中发送以下参数 (数据点):
占位符 | 信息 |
{city} | 设备所在城市 |
{click_attribution_window} | 设备匹配的归因窗口设置(小时数) |
{country} | 两字符设备国家/地区代码 |
{currency} | 从 Adjust SDK 发送的原始 ISO 4217 货币代码 |
{device_name} | 设备型号 |
{device_type} | 设备类型 |
{idfa||gps_adid} | IDFA 或 GPS ADID(如果 IDFA 为空) |
{idfv} | 供应商的大写 iOS ID |
{impression_attribution_window} | 展示匹配的归因窗口设置(小时数) |
{inactive_user_definition} | 符合再归因资格的非活跃时长(以小时数计) |
{ip_address} | 设备 IP 地址 |
{isp} | 设备互联网服务供应商 |
{language} | 设备两字符语言代码 |
{lifetime_session_count} | 用户整个生命周期中记录的会话数量 |
{match_type} | 归因方法 |
{os_name} | 设备操作系统 |
{os_version} | 操作系统版本号 |
{partner_parameters} | Adjust SDK 或 S2S 请求收集并且通过回调传输给第三方提供商的自定义合作伙伴参数 |
{reattribution_attribution_window} | 再归因的归因窗口设置(小时数) |
{revenue_float} | 从 Adjust SDK 发送的收入(以货币整数计) |
{timezone} | 设备时区 |
{tracking_limited} | 若跟踪受限,则为 1;若跟踪未受限,则为 0 |
{user_agent} | 传入的原始用户代理 |
{app_id} | 商店的应用 ID 或 Google Play 商店 |
{created_at} | 活动时间戳 |
{creative_name} | 素材名称,取自跟踪链接 |
{engagement_time} | 交互时间戳 |
{impression_based} | 如基于展示,则参数为 1,否则为 0 |
{install_begin_time} | 应用下载开始的时间戳(仅限安卓和 Google Play 商店) |
{install_finish_time} | 应用下载完成的时间戳 |
{installed_at} | 安装(即,首次打开应用)时间戳 |
{rejection_reason} | 归因被拒的原因 |
{ad_impressions_count} | 为最终用户提供的广告展示数量 |
{ad_revenue_network} | 展示该广告的渠道 |
{ad_revenue_unit} | 产生广告收入的广告单元 |
{ad_mediation_platform} | 广告聚合平台名称 |
{ad_revenue_payload} | 展示级别的收入数据 (ILRD) 作为 JSON |