Tenjin SDK 可以监听 CloudX 展示层级收入数据（ILRD，impression level revenue data）并向 Tenjin 发送收入事件。此集成将针对来自 CloudX 的每次广告展示发送相关的收入数据。以下是集成的具体步骤：
- 按照集成指南安装 CloudX iOS SDK： https://docs.cloudx.io/en/ios/integration
请确保您已安装最新版本的 Tenjin iOS SDK（>= 1.17.0），该版本通过 TenjinSDK+CloudXILRD 类别（category）增加了对 CloudX 的支持。 - 使用以下示例代码，通过 CloudX 的 revenueListener（或 CloudXAdRevenueListener）回调将收入数据传递给 Tenjin。
Objective-C #
Objective-C
#import <TenjinSDK/TenjinSDK.h>
#import <TenjinSDK/TenjinSDK+CloudXILRD.h>
/**
Invoked when CloudX records an impression and reports revenue for the ad
*/
- (void)didPayRevenueForAd:(CloudXAd *)cloudXAd {
NSLog(@"%s", __PRETTY_FUNCTION__);
// Create JSON object for Tenjin
NSDictionary *impressionDict = @{
@"format": cloudXAd.adFormat ?: @"",
@"ad_unit_id": cloudXAd.adUnitId ?: @"",
@"network_name": cloudXAd.networkName ?: @"",
@"network_placement": cloudXAd.networkPlacement ?: @"",
@"placement": cloudXAd.placement ?: @"",
@"revenue": @(cloudXAd.revenue),
@"currency": @"USD"
};
// Convert to JSON string
NSError *error;
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:impressionDict
options:0
error:&error];
if (jsonData && !error) {
NSString *jsonString = [[NSString alloc] initWithData:jsonData
encoding:NSUTF8StringEncoding];
// Send to Tenjin
[TenjinSDK cloudXImpressionFromJSON:jsonString];
NSLog(@"Sent CloudX impression to Tenjin: %@", jsonString);
} else {
NSLog(@"Error creating JSON: %@", error.localizedDescription);
}
}Swift #
Swift
import TenjinSDK
// Conform to CloudX's revenue listener protocol on your ad delegate
extension MyAdDelegate: CloudXAdRevenueListener {
func onAdRevenuePaid(_ cloudXAd: CloudXAd) {
let impressionDict: [String: Any] = [
"ad_format": cloudXAd.adFormat ?? "",
"ad_unit_id": cloudXAd.adUnitId ?? "",
"network_name": cloudXAd.networkName ?? "",
"network_placement": cloudXAd.networkPlacement ?? "",
"placement": cloudXAd.placement ?? "",
"revenue": cloudXAd.revenue,
"currency": "USD"
]
guard
let jsonData = try? JSONSerialization.data(withJSONObject: impressionDict, options: []),
let jsonString = String(data: jsonData, encoding: .utf8)
else {
print("Error creating CloudX impression JSON")
return
}
// Send to Tenjin
TenjinSDK.cloudXImpression(fromJSON: jsonString)
print("Sent CloudX impression to Tenjin: \(jsonString)")
}
}在加载广告之前，将该监听器绑定到每个广告对象（如 banner、MREC、插屏广告、激励广告），例如：
bannerAd.revenueListener = self以下是来自 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 |