您可以使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入。
要监测收入,您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 support@adjust.com 来开始设置。
实例化 AdjustAdRevenue 对象
AdjustAdRevenue(this._source) { _callbackParameters = new Map<String, String>(); _partnerParameters = new Map<String, String>();}
要使用 Adjust SDK 发送广告收入信息,请实例化一个 AdjustAdRevenue
对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。
要实例化广告收入对象,请创建新的 AdjustAdRevenue
实例,并传送下列参数:
source
(String
):广告收入来源。请查看下表,了解来源。
参数 | 来源 |
---|---|
AdjustConfig.AdRevenueSourceAppLovinMAX | AppLovin MAX |
AdjustConfig.AdRevenueSourceMopub | mopub |
AdjustConfig.AdRevenueSourceAdMob | AdMob |
AdjustConfig.AdRevenueSourceIronSource | IronSource |
AdjustConfig.AdRevenueSourceAdmost | Admost |
AdjustConfig.AdRevenueSourceUnity | Unity |
AdjustConfig.AdRevenueSourceHeliumChartboost | Helium Chartboost |
AdjustConfig.AdRevenueSourceTradPlus | TradPlus |
AdjustConfig.AdRevenueSourceTopOn | TopOn |
AdjustConfig.AdRevenueSourcePublisher | 通用来源 |
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...Adjust.trackAdRevenue(adjustAdRevenue);
发送广告收入
static void trackAdRevenue(String source, String payload) { _channel .invokeMethod('trackAdRevenue', {'source': source, 'payload': payload});}
要向 Adjust 发送广告收入数据,请以广告收入实例作为参数,调用 trackAdRevenue
方法。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...Adjust.trackAdRevenue(adjustAdRevenue);
记录广告收入额
void setRevenue(num revenue, String currency) { _revenue = revenue; _currency = currency;}
要发送广告收入额,请调用 setRevenue
方法,并传送下列参数:
revenue
(num
):收入额currency
(String
):您报告币种的 ISO 4217 代码,由 3 个字符组成
欢迎查看记录不同币种的购买一文,了解更多信息。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.setRevenue(1.00, "EUR");//...Adjust.trackAdRevenue(adjustAdRevenue);
记录广告推广活动细节
AdjustAdRevenue
类包含多种属性,您可以通过这些属性来报告广告推广活动信息。
广告展示
num? adImpressionsCount;
要发送广告展示数量记录,请为广告收入实例 adImpressionsCount
属性指定 num
值。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.adImpressionsCount = 10;//...Adjust.trackAdRevenue(adjustAdRevenue);
广告收入渠道
String? adRevenueNetwork;
要发送广告收入渠道,请在广告收入实例 adRevenueNetwork
属性上将渠道名称指定 String
值。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.adRevenueNetwork = "network1";//...Adjust.trackAdRevenue(adjustAdRevenue);
广告收入单位
String? adRevenueUnit;
要发送广告收入单位,请在广告收入实例 adRevenueUnit
属性上将单位指定为 String
值。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.adRevenueUnit = "unit1";//...Adjust.trackAdRevenue(adjustAdRevenue);
广告收入位置
String? adRevenuePlacement;
要发送广告收入位置,请在广告收入实例 adRevenuePlacement
属性上将位置指定为 String
值。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.adRevenuePlacement = "banner";//...Adjust.trackAdRevenue(adjustAdRevenue);
添加回传参数
void addCallbackParameter(String key, String value) { _callbackParameters![key] = value;}
您在 Adjust 控制面板中注册回传 URL,SDK 监测到事件后,会向您的回传 URL 发送一个 GET 请求。
您可以为自己的服务器设置回传参数。配置好事件的参数后,SDK 会将参数附加至您的回传 URL。您可以利用该信息,通过自己的 BI 系统分析用户应用内行为。
使用 String
键值对 argument 调用addCallbackParameter
方法,以此向事件添加回传参数。多次调用该方法可添加多个参数。
Adjust SDK 监测事件,并向附加回传参数的 URL 发送请求。例如,如果您注册了 URLhttps://www.mydomain.com/callback
,则回传为:
https://www.mydomain.com/callback?key=value&foo=bar
Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。
如果您使用的是 CSV 上传,请务必在 CSV 定义中添加参数。
Adjust 支持许多占位符,这些占位符可用来将信息从 SDK 发送至您的 URL。例如,iOS 的{idfa}
占位符和安卓的{gps_adid}
占位符。{publisher_parameter}
占位符可在单一字符串中呈现所有回传参数。
若想进一步了解 URL 回传,查看可用参数的完整列表,请参阅回传指南。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.addCallbackParameter("key", "value")//...Adjust.trackAdRevenue(adjustAdRevenue);
添加合作伙伴参数
void addPartnerParameter(String key, String value) { _partnerParameters![key] = value;}
您可以添加合作伙伴参数,向渠道合作伙伴发送额外的信息。
Adjust 可向您设置的外部合作伙伴发送合作伙伴参数。这些信息可用来进行更精细的数据分析,开展再营销活动。您设置好参数并为合作伙伴启用参数转发后,Adjust 服务器就会将这些参数转发给合作伙伴。
合作伙伴参数不会默认出现在原始数据中。您可以添加{partner_parameters}
占位符,在同一个字符串中接收参数。
使用 String
键值对 argument 调用addPartnerParameter
方法,以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.addPartnerParameter("key", "value");//...Adjust.trackAdRevenue(adjustAdRevenue);
示例
该示例展示了如何设置并记录一个广告收入对象,其属性如下:
- AppLovin MAX 作为收入来源
- 收入金额为 1 欧元
- 10 次广告展示
"network1"
为广告收入渠道"unit1"
为广告收入单位"banner"
为广告收入位置- 回传参数:
"key1" = "value1"
- 合作伙伴参数:
"key2" = "value2"
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdRevenueSourceAppLovinMAX);adjustAdRevenue.setRevenue(1.00, "EUR");adjustAdRevenue.adImpressionsCount = 10;adjustAdRevenue.adRevenueNetwork = "network1";adjustAdRevenue.adRevenueUnit = "unit1";adjustAdRevenue.adRevenuePlacement = "banner";adjustAdRevenue.addCallbackParameter("key1", "value1");adjustAdRevenue.addPartnerParameter("key2", "value2");Adjust.trackAdRevenue(adjustAdRevenue);