El SDK de Tenjin puede recopilar datos de ingresos a nivel de impresiones de CloudX y enviar eventos de ingresos a Tenjin. Esta integración enviará datos relacionados con los ingresos de cada impresión publicitaria servida desde CloudX. Estos son los pasos para realizar la integración:
- Instala el SDK de CloudX iOS siguiendo la guía de integración: https://docs.cloudx.io/en/ios/integration
Asegúrate de tener instalado el SDK más reciente de Tenjin iOS (>= 1.17.0), que incorpora la compatibilidad con CloudX a través de la categoría «TenjinSDK+CloudXILRD». - Envía los datos de ingresos a Tenjin desde la función de devolución de llamada revenueListener (o CloudXAdRevenueListener) de CloudX, utilizando el siguiente código de ejemplo.
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 #
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)")
}
}Asigna el listener a cada objeto publicitario (banner, MREC, intersticial, con recompensa) antes de cargar el anuncio, por ejemplo:
bannerAd.revenueListener = self
A continuación se muestra un ejemplo de registro de datos de ingresos por nivel de impresiones procedente de CloudX:
| Parámetro | ¿Es obligatorio? | Ejemplo |
| formato | No | “banner”, “mrec”, “intersticial”, “recompensado” |
| ad_unit_id | No | abc-123-banner |
| nombre_de_la_red | No | meta |
| ubicación_en_la_red | No | 1234567890_9876543210 |
| colocación | No | pantalla de inicio |
| ingresos | Sí | 0.0123 |
| moneda | No | USD |
referencia: https://docs.cloudx.io/en/ios/integration