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 Android seguindo o guia de integração: https://docs.cloudx.io/en/android/integration
Certifique-se de que tem instalado o SDK mais recente do Tenjin Android (que inclui o método cloudXImpressionFromJSON()). - Transmita os dados de receitas ao Tenjin a partir do callback CloudXAdRevenueListener do CloudX, utilizando o código de exemplo seguinte.
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);
}
}
}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/android/integration