Tenjin SDK 可以监听 CloudX 展示层级收入数据(ILRD,impression level revenue data)并向 Tenjin 发送收入事件。此集成将针对来自 CloudX 的每次广告展示发送相关的收入数据。以下是集成的具体步骤:
- 按照集成指南安装 CloudX Android SDK。 https://docs.cloudx.io/en/android/integration
请确保您已安装最新版本的 Tenjin Android SDK(其中包含 cloudXImpressionFromJSON() 方法)。 - 使用以下示例代码,通过 CloudX 的 CloudXAdRevenueListener 回调将收入数据传递给 Tenjin。
Kotlin
Kotlin
import com.tenjin.android.TenjinSDK
import io.cloudx.sdk.CloudXAd
import io.cloudx.sdk.CloudXAdRevenueListener
import org.json.JSONObject
class MainActivity : AppCompatActivity(), CloudXAdRevenueListener {
// Attach this listener to each ad (banner / MREC / interstitial / rewarded)
// before loading the ad, e.g.:
// bannerAd.revenueListener = this
override fun onAdRevenuePaid(cloudXAd: CloudXAd) {
// Create JSON object for Tenjin
val impressionData = JSONObject().apply {
put("ad_format", cloudXAd.adFormat?.toString() ?: "")
put("ad_unit_id", cloudXAd.adUnitId ?: "")
put("network_name", cloudXAd.networkName ?: "")
put("network_placement", cloudXAd.networkPlacement ?: "")
put("placement", cloudXAd.placement ?: "")
put("revenue", cloudXAd.revenue)
put("currency", "USD")
}
val jsonString = impressionData.toString()
// Send to Tenjin
TenjinSDK.getInstance(this, "<YOUR-TENJIN-SDK-KEY>")
.eventAdImpressionCloudX(jsonString)
Log.d("Tenjin", "Sent CloudX impression to Tenjin: $jsonString")
}
}Java #
JavaScript
import com.tenjin.android.TenjinSDK;
import io.cloudx.sdk.CloudXAd;
import io.cloudx.sdk.CloudXAdRevenueListener;
import org.json.JSONObject;
public class MainActivity extends AppCompatActivity implements CloudXAdRevenueListener {
// Attach this listener to each ad (banner / MREC / interstitial / rewarded)
// before loading the ad, e.g.:
// bannerAd.setRevenueListener(this);
@Override
public void onAdRevenuePaid(CloudXAd cloudXAd) {
try {
JSONObject impressionData = new JSONObject();
impressionData.put("format",
cloudXAd.getAdFormat() != null ? cloudXAd.getAdFormat().toString() : "");
impressionData.put("ad_unit_id",
cloudXAd.getAdUnitId() != null ? cloudXAd.getAdUnitId() : "");
impressionData.put("network_name",
cloudXAd.getNetworkName() != null ? cloudXAd.getNetworkName() : "");
impressionData.put("network_placement",
cloudXAd.getNetworkPlacement() != null ? cloudXAd.getNetworkPlacement() : "");
impressionData.put("placement",
cloudXAd.getPlacement() != null ? cloudXAd.getPlacement() : "");
impressionData.put("revenue", cloudXAd.getRevenue());
impressionData.put("currency", "USD");
String jsonString = impressionData.toString();
// Send to Tenjin
TenjinSDK.getInstance(this, "<YOUR-TENJIN-SDK-KEY>")
.cloudXImpressionFromJSON(jsonString);
Log.d("Tenjin", "Sent CloudX impression to Tenjin: " + jsonString);
} catch (JSONException e) {
Log.e("Tenjin", "Error creating CloudX impression JSON", e);
}
}
}以下是来自 CloudX 的展示层级收入数据条目示例:
| 参数 | 必需? | 例子 |
| format | 否 | “banner”, “mrec”, “interstitial”, “rewarded” |
| ad_unit_id | 否 | abc-123-banner |
| network_name | 否 | meta |
| network_placement | 否 | 1234567890_9876543210 |
| placement | 否 | home_screen |
| revenue | 是 | 0.0123 |
| currency | 否 | USD |