adjust-icon

发送广告收入信息

您可以使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入。

实例化 AdjustAdRevenue 对象

方法签名
void AdjustAdRevenue2dx::initAdRevenue(std::string source);

要使用 Adjust SDK 发送广告收入信息,请实例化一个 AdjustAdRevenue 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。

要实例化广告收入对象,请创建新的 AdjustAdRevenue 实例,并传送下列参数:

  • source ( 字符串 ):广告收入来源。请查看下表,了解来源。
参数来源
AdjustConfig2dx.AdjustAdRevenueSourceAppLovinMAXAppLovin MAX
AdjustConfig2dx.AdjustAdRevenueSourceMopubmopub
AdjustConfig2dx.AdjustAdRevenueSourceAdMobAdMob
AdjustConfig2dx.AdjustAdRevenueSourceIronSourceIronSource
AdjustConfig2dx.AdjustAdRevenueSourceAdMostSourceAdmost
AdjustConfig2dx.AdjustAdRevenueSourceUnityUnity
AdjustConfig2dx.AdjustAdRevenueSourceHeliumChartboostHelium Chartboost
AdjustConfig2dx.AdjustAdRevenueSourceAdxAd(X)
AdjustConfig2dx.AdjustAdRevenueSourcePublisher通用来源
AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);

发送广告收入

方法签名
static void trackAdRevenueNew(AdjustAdRevenue2dx adRevenue);

要向 Adjust 发送广告收入数据,请以广告收入实例作为参数,调用 trackAdRevenueNew 方法。

AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);

记录广告收入额

方法签名
void AdjustAdRevenue2dx::setRevenue(double amount, std::string currency);

要发送广告收入额,请调用 setRevenue 方法,并传送下列参数:

  • amount ( Double ):收入额
  • currency ( 字符串 ):您报告币种的 ISO 4217 代码,由 3 个字符组成
AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
adjustAdRevenue.setRevenue(0.01, "EUR");
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);

记录广告推广活动细节

AdjustAdRevenue 类包含多种属性,您可以通过这些属性来报告广告推广活动信息。

广告展示

方法签名
void AdjustAdRevenue2dx::setAdImpressionsCount(int adImpressionsCount);

要发送广告展示量记录,请调用 setAdImpressionsCount 方法,并传送下列参数:

  • adImpressionsCount ( 整数 ):广告展示数量。
AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
adjustAdRevenue.setAdImpressionsCount(10);
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);

广告收入渠道

方法签名
void AdjustAdRevenue2dx::setAdRevenueNetwork(std::string adRevenueNetwork);

要发送广告收入渠道,请调用 setAdRevenueNetwork 方法,并传送下列参数:

  • adRevenueNetwork ( 字符串 ):渠道名称。
AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
adjustAdRevenue.setAdImpressionsCount("network1");
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);

广告收入单位

方法签名
void AdjustAdRevenue2dx::setAdRevenueUnit(std::string adRevenueUnit);

要发送广告收入单位,请调用 setAdRevenueUnit 方法,并传送下列参数:

  • adRevenueUnit ( 字符串 ):广告单位
AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
adjustAdRevenue.setAdImpressionsCount("unit1");
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);

广告收入位置

方法签名
void AdjustAdRevenue2dx::setAdRevenuePlacement(std::string adRevenuePlacement);

要发送广告收入位置,请调用 setAdRevenuePlacement 方法,并传送下列参数:

  • adRevenuePlacement ( 字符串 ):广告投放。
AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
adjustAdRevenue.setAdRevenuePlacement("banner");
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);

添加回传参数

方法签名
void AdjustAdRevenue2dx::addCallbackParameter(std::string key, std::string value);

您在 Adjust 控制面板中注册回传 URL,SDK 监测到事件后,会向您的回传 URL 发送一个 GET 请求。

您可以为自己的服务器设置回传参数。配置好事件的参数后,SDK 会将参数附加至您的回传 URL。您可以利用该信息,通过自己的 BI 系统分析用户应用内行为。

使用 字符串 键值对 argument 调用addCallbackParameter方法,以此向事件添加回传参数。多次调用该方法可添加多个参数。

Adjust SDK 监测事件,并向附加回传参数的 URL 发送请求。例如,如果您注册了 URLhttps://www.mydomain.com/callback,则回传为:

https://www.mydomain.com/callback?key=value&foo=bar

如果您使用的是 CSV 上传,请务必在 CSV 定义中添加参数。

Adjust 支持许多占位符,这些占位符可用来将信息从 SDK 发送至您的 URL。例如,iOS 的{idfa}占位符和安卓的{gps_adid}占位符。{publisher_parameter}占位符可在单一字符串中呈现所有回传参数。

AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
adjustAdRevenue.addCallbackParameter("key", "value");
adjustAdRevenue.addCallbackParameter("foo", "bar");
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);

添加合作伙伴参数

方法签名
void AdjustAdRevenue2dx::addPartnerParameter(std::string key, std::string value);

您可以添加合作伙伴参数,向渠道合作伙伴发送额外的信息。

Adjust 可向您设置的外部合作伙伴发送合作伙伴参数。这些信息可用来进行更精细的数据分析,开展再营销活动。您设置好参数并为合作伙伴启用参数转发后,Adjust 服务器就会将这些参数转发给合作伙伴。

使用 字符串 键值对 argument 调用addPartnerParameter方法,以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。

AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
adjustAdRevenue.addPartnerParameter("key", "value");
adjustAdRevenue.addPartnerParameter("foo", "bar");
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);

示例

该示例展示了如何设置并记录一个广告收入对象,其属性如下:

  • AppLovin MAX 作为收入来源
  • 收入金额为 1 欧元
  • 10 次广告展示
  • "network1" 为广告收入渠道
  • "unit1" 为广告收入单位
  • "banner" 为广告收入位置
  • 回传参数: "key1" = "value1"
  • 合作伙伴参数: "key2" = "value2"
AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX);
adjustAdRevenue.setRevenue(1, "EUR");
adjustAdRevenue.setAdImpressionsCount(10);
adjustAdRevenue.setAdRevenueNetwork("network1");
adjustAdRevenue.setAdRevenueUnit("unit1");
adjustAdRevenue.setAdRevenuePlacement("banner");
adjustAdRevenue.addCallbackParameter("key1", "value1");
adjustAdRevenue.addPartnerParameter("key2", "value2");
Adjust2dx::trackAdRevenueNew(adjustAdRevenue);