Reporte de ingresos

Implementación

Desde la versión 1.7.0, las apps pueden recibir un reporte estimado del ingreso que previsiblemente ha sido generado por un anuncio.

Para ello, simplemente hay que implementar el listener correspondiente para cada formato de anuncio, como se muestra en el ejemplo a continuación:

Kotlin

val bannerAd: BannerAd

bannerAd.listener = object : BannerAd.Listener() {
    override fun onBannerRevenuePaid(ad: BannerAd, data: Revenuedata) {
        // Invocado cuando el anuncio ha generado un ingreso
    }
}

Java

BannerAd mBannerAd;

mBannerAd.setListener(new BannerAd.Listener() {
    @Override
    public void onBannerRevenuePaid(@NonNull BannerAd ad,
                                    @NonNull Revenuedata data) {
        // Invocado cuando el anuncio ha generado un ingreso
    }
});

El listener recibe un objeto de tipo RevenueData que contiene los siguientes campos:

Campo	Tipo	Descripción
revenue	AdValue	El ingreso generado por el anuncio
source	String	La fuente del ingreso

Además, la clase AdValue contiene los siguientes campos que representan al ingreso:

Campo	Tipo	Descripción
currency	String	La divisa correspondiente al ingreso
precision	AdValue.Precision	La precisión de la información. Puede ser ESTIMATED, PRECISE o PUBLISHER_DEFINED
value	Double	El valor del ingreso

Integración con Firebase

A continuación, se muestra un ejemplo básico para reportar la información de los ingresos a Firebase:

Kotlin

override func onBannerRevenuePaid(ad: BannerAd, data: RevenueData) {
    val bundle = Bundle().apply {
        putString("currency",   data.revenue.currency)
        putString("precision",  data.revenue.precision?.name)
        putString("source",     data.source)
        putDouble("value",      data.revenue.value)
    }

    Firebase.analytics.logEvent("ad_revenue", bundle)
}

Java

@Override
public void onBannerRevenuePaid(@NonNull BannerAd ad,
                                @NonNull RevenueData data) {
    Bundle bundle = new Bundle();

    bundle.putString("source", data.getSource());
    
    AdValue revenue = data.getRevenue();

    bundle.putString("currency",  revenue.getCurrency());
    bundle.putDouble("value",     revenue.getValue());
    
    AdValue.Precision precision = revenue.getPrecision();
    
    if (precision != null) {
        bundle.putString("precision", precision.name());
    }

    FirebaseAnalytics.getInstance(context).logEvent("ad_revenue", bundle);
}