Relatório de receita

Implementação

Desde a versão 1.7.0, os apps podem receber uma estimativa da receita que provavelmente foi gerada por um anúncio.

Para isso, basta implementar o listener correspondente para cada formato de anúncio, como mostrado no exemplo abaixo:

Kotlin

val bannerAd: BannerAd

bannerAd.listener = object : BannerAd.Listener() {
    override fun onBannerRevenuePaid(ad: BannerAd, data: Revenuedata) {
        // Invocado quando o anúncio gerou receita
    }
}

Java

BannerAd mBannerAd;

mBannerAd.setListener(new BannerAd.Listener() {
    @Override
    public void onBannerRevenuePaid(@NonNull BannerAd ad,
                                    @NonNull Revenuedata data) {
        // Invocado quando o anúncio gerou receita
    }
});

O listener recebe um objeto do tipo RevenueData que contém os seguintes campos:

Campo	Tipo	Descrição
revenue	AdValue	A receita gerada pelo anúncio
source	String	A origem da receita

Além disso, a classe AdValue contém os seguintes campos que representam a receita:

Campo	Tipo	Descrição
currency	String	A moeda correspondente à receita
precision	AdValue.Precision	A precisão da informação. Pode ser ESTIMATED, PRECISE ou PUBLISHER_DEFINED
value	Double	O valor da receita

Integração com o Firebase

Abaixo, é mostrado um exemplo básico de como reportar as informações de receita ao 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);
}