Tenjin SDKは、CloudXのインプレッションレベルの収益データを監視し、収益イベントをTenjinに送信できます。この連携により、CloudXから配信された各広告インプレッションに関連する収益が送信されます。連携の手順は以下のとおりです。
- 実装ガイドに従って、CloudX iOS SDKをインストールしてください。 https://docs.cloudx.io/en/ios/integration
Please ensure you have the latest Tenjin iOS SDK installed (>= 1.17.0), which adds CloudX support via the TenjinSDK+CloudXILRD category. - 以下のサンプルコードを使用して、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)")
}
}広告を読み込む前に、各広告オブジェクト(バナー、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 |