O SDK da Tenjin pode recolher dados de receitas ao nível das impressões da CloudX e enviar eventos de receitas para a Tenjin. Esta integração irá enviar dados relacionados com as receitas para cada impressão publicitária veiculada pela CloudX. Aqui estão os passos para a integração:
- Instale o SDK do CloudX iOS seguindo o guia de integração: https://docs.cloudx.io/en/ios/integration
Certifique-se de que tem instalada a versão mais recente do SDK Tenjin iOS (>= 1.17.0), que adiciona suporte ao CloudX através da categoria TenjinSDK+CloudXILRD. - Envie os dados de receitas para o Tenjin a partir da função de retorno de chamada revenueListener (ou CloudXAdRevenueListener) do CloudX, utilizando o código de exemplo seguinte.
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)")
}
}Atribua o ouvinte a cada objeto de anúncio (banner, MREC, intersticial, com recompensa) antes de carregar o anúncio, por exemplo:
bannerAd.revenueListener = self
Eis um exemplo de introdução de dados relativos às receitas por nível de impressão a partir do CloudX:
| Parâmetro | É obrigatório? | Exemplo |
| formato | Não | “banner”, “mrec”, “intersticial”, “recompensado” |
| ad_unit_id | Não | abc-123-banner |
| nome_da_rede | Não | meta |
| posicionamento_na_rede | Não | 1234567890_9876543210 |
| colocação | Não | ecrã_inicial |
| receitas | Sim | 0.0123 |
| moeda | Não | USD |
referência: https://docs.cloudx.io/en/ios/integration