Controlo de receitas de anúncios – Centro de ajuda

Documento

Compreender a atribuição de receitas de anúncios

A Atribuição de receitas de anúncios ajuda-o a associar as suas receitas de anúncios às campanhas específicas que trouxeram utilizadores à sua aplicação. Isto dá-lhe uma imagem clara do desempenho dos seus anúncios, mostrando o custo da campanha, as receitas in-app e as receitas de anúncios, tudo num único local. Esta funcionalidade também lhe permite enviar dados sobre as receitas de anúncios para as suas redes de anúncios, de modo a melhorar o desempenho dos mesmos.

Pontos principais:

O que faz: a atribuição de receitas de anúncios associa as receitas de anúncios de aplicações móveis às campanhas de marketing que geraram utilizadores para a sua aplicação. Desta forma, pode ver quanto ganhou com cada campanha e como isso afecta o ROI geral dos anúncios.
Fonte de dados: Estes dados provêm normalmente da sua plataforma de mediação e podem estar ao nível do utilizador ou ao nível da impressão. O Singular oferece suporte a diferentes maneiras de obter esses dados de atribuição.
Saiba mais: Para obter mais detalhes, consulte o artigo Perguntas frequentes e solução de problemas sobre Atribuição de receita de anúncios Singular.

Notas importantes:

Códigos de moeda: Use códigos de moeda ISO 4217 de três letras (por exemplo, "USD" para dólares americanos, "EUR" para euros, "INR" para rúpias indianas). Muitas plataformas de mediação utilizam "USD", por isso certifique-se de que o seu código corresponde a este código, se o estiver a utilizar. Se utilizar uma moeda diferente, actualize o código de validação em conformidade.
Exatidão dos dados: Sempre verifique se seus dados de receita e moeda estão corretos antes de enviá-los para a Singular. Os dados incorrectos não podem ser corrigidos mais tarde, pelo que é crucial garantir a sua exatidão.

Implementação da atribuição de receita de anúncios

Atualizar o SDK: Certifique-se de ter a versão mais recente do Singular SDK.
Adicionar snippets de código: Dependendo da sua plataforma de mediação, adicione os trechos de código corretos à configuração do SDK do Singular.

Seguir estas etapas ajudará você a configurar a Atribuição de receita de anúncios corretamente e a aproveitar ao máximo seus dados de anúncios.

AdMob

Notas do parceiro

Esta funcionalidade tem de ser activada na sua conta AdMob.
Consulte Suporte da AdMob.
Quando carregar um formato de anúncio (como "App Open", "Banner", "Interstitial", "Native" ou "Rewarded"), configure um paidEventHandler como uma função de retorno de chamada que é acionada sempre que um anúncio gera receitas. O SDK do Google Mobile Ads monitoriza os eventos de impressão e chama este manipulador com a receita gerada pelo anúncio.

Para o fazer, modifique a função"load" do formato do anúncio para incluir o paidEventHandler. Dentro dessa chamada de retorno, você gerencia os dados de receita do anúncio, valida-os e envia-os para o Singular usando a função Singular.adRevenue.

Por exemplo, quando um "anúncio recompensado" é carregado com êxito, o paidEventHandler receberá as informações de receita do anúncio (adValue). Nesta função, trate os dados de receita e envie-os para o Singular.

Para obter mais detalhes, consulte a documentação da AdMob.

IMPORTANTE: o SDK da AdMob informa a receita de forma diferente, dependendo da plataforma. Por exemplo, a receita de anúncios de US$ 0,005 será retornada como 5000 nas plataformas Unity e Android, mas como 0,005 no iOS. Para iOS, envie 0,005 diretamente para o SDK Singular. Em outras plataformas, converta adValue de micros para dólares antes de enviá-lo para a Singular.

Selecione a base de código para a implementação do seu SDK:

Como funciona:

Implemente o SDK do Google AdMob Mobile Ads (Android): Consulte o Guia de Introdução.
Integração com a AdMob: Carregue o anúncio da AdMob e defina um setOnPaidEventListener para lidar com eventos de receita de anúncios.
Validação de receita: Adicione uma verificação para garantir que a receita seja maior que 0. Isso evita o envio de valores de receita zero ou negativos.
Validação de moeda: Certifique-se de que a moeda não seja nula ou vazia antes de enviar dados para a Singular.
Registo de dados inválidos: Se os dados falharem na validação, imprima uma mensagem de log para depuração e não envie os dados para a Singular.

import com.singular.sdk.Singular
import com.singular.sdk.SingularAdData

private const val AD_UNIT_ID = "AD_UNIT_ID"

class AdManager(private val context: Context) {

    private var rewardedAd: RewardedAd? = null

    fun loadRewardedAd() {
        val adRequest = AdRequest.Builder().build()
        RewardedAd.load(context, AD_UNIT_ID, adRequest, object : RewardedAdLoadCallback() {
            override fun onAdLoaded(ad: RewardedAd) {
                rewardedAd = ad
                rewardedAd?.fullScreenContentCallback = object : FullScreenContentCallback() {
                    override fun onAdShowedFullScreenContent() {
                        Log.d("AdManager", "Rewarded ad displayed.")
                    }

                    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
                        Log.d("AdManager", "Rewarded ad failed to show with error: ${adError.message}")
                    }

                    override fun onAdDismissedFullScreenContent() {
                        Log.d("AdManager", "Rewarded ad dismissed.")
                    }
                }
                rewardedAd?.setOnPaidEventListener { adValue: AdValue ->
                    // Ensure valid revenue data

                    val revenue = adValue.valueMicros / 1_000_000.0
                    val currency = adValue.currencyCode

                    if (revenue > 0 && !currency.isNullOrEmpty()) {
                        val data = SingularAdData(
                            "Admob",
                            currency,
                            revenue
                        )
                        
                        // Send Ad Revenue data to Singular

                        Singular.adRevenue(data)
                        
                        // Log the data for debugging

                        Log.d("AdManager", "Ad Revenue reported to Singular: $data")
                    } else {
                        Log.d("AdManager", "Invalid ad revenue data: revenue = $revenue, currency = $currency")
                    }
                }
            }

            override fun onAdFailedToLoad(loadAdError: LoadAdError) {
                Log.d("AdManager", "Rewarded ad failed to load with error: ${loadAdError.message}")
            }
        })
    }
}

Como funciona:

Implemente o SDK do Google AdMob Mobile Ads (Android): Consulte o Guia de Introdução.
Integração com o AdMob: Carregue o anúncio do AdMob e defina um setOnPaidEventListener para lidar com eventos de receita de anúncios.
Validação de receita: Adicione uma verificação para garantir que a receita seja maior que 0. Isso evita o envio de valores de receita zero ou negativos.
Validação de moeda: Certifique-se de que a moeda não seja nula ou vazia antes de enviar dados para a Singular.
Registo de dados inválidos: Se os dados falharem na validação, imprima uma mensagem de log para depuração e não envie os dados para o Singular.

import com.singular.sdk.Singular;
import com.singular.sdk.SingularAdData;

// Define constants for better maintainability

private static final String AD_UNIT_ID = "AD_UNIT_ID";

public class AdManager {

    private RewardedAd rewardedAd;
    private Context context;

    public AdManager(Context context) {
        this.context = context;
    }

    public void loadRewardedAd() {
        AdRequest adRequest = new AdRequest.Builder().build();

        RewardedAd.load(context, AD_UNIT_ID, adRequest, new RewardedAdLoadCallback() {
            @Override
            public void onAdLoaded(RewardedAd ad) {
                rewardedAd = ad;

                rewardedAd.setFullScreenContentCallback(new FullScreenContentCallback() {
                    @Override
                    public void onAdShowedFullScreenContent() {
                        Log.d("AdManager", "Rewarded ad displayed.");
                    }

                    @Override
                    public void onAdFailedToShowFullScreenContent(AdError adError) {
                        Log.d("AdManager", "Rewarded ad failed to show with error: " + adError.getMessage());
                    }

                    @Override
                    public void onAdDismissedFullScreenContent() {
                        Log.d("AdManager", "Rewarded ad dismissed.");
                    }
                });

                rewardedAd.setOnPaidEventListener(new OnPaidEventListener() {
                    @Override
                    public void onPaidEvent(AdValue adValue) {
                        double revenue = adValue.getValueMicros() / 1_000_000.0;
                        String currency = adValue.getCurrencyCode();

                        // Validate the revenue value

                        if (revenue <= 0 || currency == null || currency.isEmpty()) {
                            Log.d("AdManager", "Invalid ad revenue data: revenue = " + revenue + ", currency = " + currency);
                            return;
                        }

                        SingularAdData data = new SingularAdData(
                            "Admob",
                            currency,
                            revenue
                        );

                        // Send Ad Revenue data to Singular

                        Singular.adRevenue(data);

                        // Log the data for debugging

                        Log.d("AdManager", "Ad Revenue reported to Singular: " + data);
                    }
                });
            }

            @Override
            public void onAdFailedToLoad(LoadAdError loadAdError) {
                Log.d("AdManager", "Rewarded ad failed to load with error: " + loadAdError.getMessage());
            }
        });
    }
}

AppLovinMax

Notas do parceiro

Compartilhe dados de receita de anúncios em nível de impressão usando a API de receita do usuário em nível de impressão da Applovin.

Selecione a base de código para sua implementação do SDK:

Como funciona:

Utiliza a AppLovin Impression-Level User Revenue API (Android): Consulte o Guia de Introdução.
Integração com o AppLovin: Carregue um anúncio recompensado do AppLovin MAX e use a função onMessageReceived para lidar com eventos de receita de anúncios.
Validação de receita: Adicione uma verificação para garantir que a receita seja maior que 0. Isso evita o envio de valores de receita zero ou negativos.
Validação de moeda: Na amostra abaixo, a moeda é codificada como "USD". Certifique-se de que a moeda é exata e não nula ou vazia antes de enviar dados para a Singular.
Registo de dados inválidos: Se os dados falharem na validação, imprima uma mensagem de log para depuração e não envie os dados para o Singular.

import com.singular.sdk.*

override fun onMessageReceived(message: AppLovinCommunicatorMessage) {
    // In the case that you are subscribed to multiple topics, check for the desired one

    if ("max_revenue_events" == message.topic) {
        val adData: Bundle? = message.messageData
        
        // Safely access and validate revenue value

        val revenueValue = adData?.getDouble("revenue", 0.0) ?: 0.0
        
        if (revenueValue > 0) {
            val data = SingularAdData(
                adPlatform = "AppLovin",
                currency = "USD",
                revenue = revenueValue
            )
            Singular.adRevenue(data)
        } else {
            Log.e("AppLovinRevenue", "Failed to parse valid revenue value from message data or revenue is not greater than 0")
        }
    }
}

Como funciona:

Usa a API AppLovin Impression-Level User Revenue (Android): Consulte o Guia de Introdução.
Integração com o AppLovin: Carregue um anúncio recompensado do AppLovin MAX e use a função onMessageReceived para lidar com eventos de receita de anúncios.
Validação de receita: Adicione uma verificação para garantir que a receita seja maior que 0. Isso evita o envio de valores de receita zero ou negativos.
Validação de moeda: Na amostra abaixo, a moeda é codificada como "USD". Certifique-se de que a moeda é exata e não nula ou vazia antes de enviar dados para a Singular.
Registo de dados inválidos: Se os dados falharem na validação, imprima uma mensagem de log para depuração e não envie os dados para o Singular.

import com.singular.sdk.*;

@Override
public void onMessageReceived(AppLovinCommunicatorMessage message) {
    // In the case that you are subscribed to multiple topics, check for the desired one

    if ("max_revenue_events".equals(message.getTopic())) {
        Bundle adData = message.getMessageData();

        // Safely access and validate revenue value

        double revenueValue = (adData != null) ? adData.getDouble("revenue", 0.0) : 0.0;

        if (revenueValue > 0) {
            SingularAdData data = new SingularAdData(
                "AppLovin",
                "USD",
                revenueValue
            );
            Singular.adRevenue(data);
        } else {
            Log.e("AppLovinRevenue", "Failed to parse valid revenue value from message data or revenue is not greater than 0");
        }
    }
}

Unity LevelPlay (IronSource)

Notas do parceiro

A API do SDK Impression Level Revenue (ILR) fornece dados de nível de impressão para o ironSource Ads e outras redes mediadas, usando o SDK do ironSource. Leia mais em[developers.is.com].
Certifique-se de que o sinalizador ARM SDK Postbacks no IronSource esteja ativado

Selecione a base de código para a implementação do SDK:

Como funciona:

Usa o SDK do ironSource para obter a receita do usuário no nível de impressão (Android): Consulte o Guia de Introdução.
Integração com o Ironsource: Carrega um anúncio premiado da Ironsource e utiliza a função onImpressionDataSuccess para tratar os eventos de receita do anúncio.
Validação de receita: Adicione uma verificação para garantir que a receita seja maior que 0. Isso evita o envio de valores de receita zero ou negativos.
Validação de moeda: Na amostra abaixo, a moeda é codificada como "USD". Certifique-se de que a moeda é exata e não nula ou vazia antes de enviar dados para a Singular.
Registo de dados inválidos: Se os dados falharem na validação, imprima uma mensagem de log para depuração e não envie os dados para o Singular.

import com.singular.sdk.Singular

// Method called when impression data is successfully received

fun onImpressionDataSuccess(impressionData: ISImpressionData?) {
    // Ensure impressionData is not null

    if (impressionData == null) {
        Log.d("IronSource", "No impression data available.")
        return
    }

    // Ensure revenue value is valid

    val revenue = impressionData.revenue.toDouble()
    if (revenue <= 0) {
        Log.w("IronSource", "Invalid revenue value: $revenue")
        return
    }

    // Create SingularAdData object with required fields

    val data = SingularAdData(
        adPlatform = "IronSource",
        currency = "USD",
        revenue = revenue
    )

    // Send the Ad Revenue data to Singular

    Singular.adRevenue(data)

    // Log the data for debugging

    Log.i("IronSource", "Ad Revenue reported to Singular: AdPlatform: ${data.adPlatform}, Currency: ${data.currency}, Revenue: ${data.revenue}")
}

Como funciona:

Usa o SDK do ironSource para obter a receita do usuário em nível de impressão (Android): Consulte o Guia de introdução.
Integração com o Ironsource: Carrega um anúncio premiado da Ironsource e usa a função onImpressionDataSuccess para lidar com eventos de receita de anúncios.
Validação de receita: Adicione uma verificação para garantir que a receita seja maior que 0. Isso evita o envio de valores de receita zero ou negativos.
Validação de moeda: Na amostra abaixo, a moeda é codificada como "USD". Certifique-se de que a moeda é exata e não nula ou vazia antes de enviar dados para a Singular.
Registo de dados inválidos: Se os dados falharem na validação, imprima uma mensagem de log para depuração e não envie os dados para o Singular.

import com.singular.sdk.Singular;
import com.singular.sdk.SingularAdData;

public class IronSourceAdManager {

    // Method called when impression data is successfully received

    public void onImpressionDataSuccess(ISImpressionData impressionData) {
        // Ensure impressionData is not null

        if (impressionData == null) {
            Log.d("IronSource", "No impression data available.");
            return;
        }

        // Ensure revenue value is valid

        double revenue = impressionData.getRevenue().doubleValue();
        if (revenue <= 0) {
            Log.w("IronSource", "Invalid revenue value: " + revenue);
            return;
        }

        // Create SingularAdData object with required fields

        SingularAdData data = new SingularAdData(
            "IronSource", // adPlatform

            "USD",        // currency

            revenue       // revenue

        );

        // Send the Ad Revenue data to Singular

        Singular.adRevenue(data);

        // Log the data for debugging

        Log.i("IronSource", "Ad Revenue reported to Singular: AdPlatform: " + data.getAdPlatform() +
                             ", Currency: " + data.getCurrency() +
                             ", Revenue: " + data.getRevenue());
    }
}

TradPlus

Notas do parceiro

Definir o impressionDelegate
Adicionar Singular ao retorno de chamada TradPlusAdImpression

Selecione a base de código para sua implementação do SDK:

Como funciona:

Integração com o TradPlus: Carrega um anúncio premiado do TradPlus e usa a função onImpressionSuccess para lidar com eventos de receita de anúncios.
Validação de receita: Adicionar uma verificação para garantir que a receita é superior a 0. Isto evita o envio de valores de receita nulos ou negativos. O dicionário adInfo contém uma chave"ecpm" com um valor NSNumber válido. Ele converte esse valor em um Double e o dimensiona(normalmente, o ecpm é fornecido em miliunidades, portanto, a divisão por 1000,0 o converte em dólares).
Validação de moeda: Na amostra abaixo, a moeda é codificada como "USD". Certifique-se de que a moeda é exata e não nula ou vazia antes de enviar dados para o Singular.
Registo de dados inválidos: Se os dados falharem na validação, imprima uma mensagem de log para depuração e não envie os dados para o Singular.

import com.singular.sdk.Singular
import com.singular.sdk.SingularAdData

// Set the global impression listener for TradPlus

TradPlusSdk.setGlobalImpressionListener(
    object : GlobalImpressionManager.GlobalImpressionListener {
        override fun onImpressionSuccess(tpAdInfo: TPAdInfo?) {
            // Ensure tpAdInfo is not null

            if (tpAdInfo == null) {
                println("AdInfo is null")
                return
            }

            // Calculate revenue (assuming ecpm is a valid field)

            val revenue = tpAdInfo.ecpm.toDouble() / 1000

            // Validate the revenue value

            if (revenue <= 0) {
                println("Ad Revenue value out of expected range: $revenue")
                return
            }

            // Create SingularAdData object with required fields

            val data = SingularAdData(
                adPlatform = "TradPlus",
                currency = "USD", // Assuming USD, adjust if necessary

                revenue = revenue
            )

            // Send the Ad Revenue data to Singular

            Singular.adRevenue(data)

            // Log for debugging

            println("Ad Revenue reported to Singular: AdPlatform: ${data.adPlatform}, Currency: ${data.currency}, Revenue: ${data.revenue}")
        }
    }
)

Como funciona:

Integração com o TradPlus: Carregue um anúncio premiado do TradPlus e use a função onImpressionSuccess para tratar os eventos de receita do anúncio.
Validação de receita: Adicione uma verificação para garantir que a receita seja maior que 0. Isso evita o envio de valores de receita zero ou negativos. O dicionário adInfo contém uma chave"ecpm" com um valor NSNumber válido. Ele converte esse valor em um Double e o dimensiona(normalmente, o ecpm é fornecido em miliunidades, portanto, a divisão por 1000,0 o converte em dólares).
Validação de moeda: Na amostra abaixo, a moeda é codificada como "USD". Certifique-se de que a moeda é exata e não nula ou vazia antes de enviar dados para o Singular.
Registo de dados inválidos: Se os dados falharem na validação, imprima uma mensagem de log para depuração e não envie os dados para o Singular.

import com.singular.sdk.Singular;
import com.singular.sdk.SingularAdData;

public class AdImpressionListener implements GlobalImpressionManager.GlobalImpressionListener {

    private static final String TAG = "AdImpressionListener";

    @Override
    public void onImpressionSuccess(TPAdInfo tpAdInfo) {
        // Ensure tpAdInfo is not null

        if (tpAdInfo == null) {
            Log.e(TAG, "AdInfo is null");
            return;
        }

        // Ensure eCPM is valid and not null

        if (tpAdInfo.getEcpm() == null) {
            Log.e(TAG, "eCPM value is null");
            return;
        }

        // Calculate revenue (assuming ecpm is in micros)

        double revenue = tpAdInfo.getEcpm().doubleValue() / 1000;

        // Validate the revenue value

        if (revenue <= 0) {
            Log.e(TAG, "Ad Revenue value out of expected range: " + revenue);
            return;
        }

        // Create SingularAdData object with required fields

        SingularAdData data = new SingularAdData(
            "TradPlus",
            "USD",
            revenue
        );

        // Send the Ad Revenue data to Singular

        Singular.adRevenue(data);

        // Log for debugging

        Log.d(TAG, "Ad Revenue reported to Singular: AdPlatform: " + data.getAdPlatform() +
                ", Currency: " + data.getCurrency() + ", Revenue: " + data.getRevenue());
    }
}

Outros (genéricos)

Notas do parceiro

Integração genérica: Inicialize um objeto SingularAdData e passe os dados necessários. Os dados devem incluir o adPlatform como uma cadeia de caracteres, a moeda como uma cadeia de caracteres e a receita como um Double.
Relatório de receita: Verifique se os dados de receita e moeda estão corretos antes de enviá-los para a Singular. Dados incorretos NÃO podem ser corrigidos posteriormente, por isso é crucial garantir que sejam precisos.
Dica: Registre informações para fins de depuração.

Selecione a base de código para a implementação do SDK:

import com.singular.sdk.Singular
import com.singular.sdk.SingularAdData

// Function to send Ad Revenue data to Singular

fun reportAdRevenue(adPlatform: String, currency: String, revenue: Double) {
    // Validate the revenue value

    if (revenue <= 0) {
        println("Invalid revenue value: $revenue")
        return
    }
    
    // Create a SingularAdData object with the provided fields

    val data = SingularAdData(
        adPlatform = adPlatform,
        currency = currency,
        revenue = revenue
    )
    
    // Send the Ad Revenue data to Singular

    Singular.adRevenue(data)
    
    // Log the data for debugging

    println("Ad Revenue reported to Singular: AdPlatform: ${data.adPlatform}, Currency: ${data.currency}, Revenue: ${data.revenue}")
}

import com.singular.sdk.Singular;
import com.singular.sdk.SingularAdData;

// Function to send Ad Revenue data to Singular

public void reportAdRevenue(String adPlatform, String currency, double revenue) {
    // Validate the revenue value

    if (revenue <= 0) {
        Log.w("AdRevenue", "Invalid revenue value: " + revenue);
        return;
    }

    // Create a SingularAdData object with the provided fields

    SingularAdData data = new SingularAdData(
        adPlatform, // adPlatform

        currency,   // currency

        revenue     // revenue

    );

    // Send the Ad Revenue data to Singular

    Singular.adRevenue(data);

    // Log the data for debugging

    Log.d("AdRevenue", "Ad Revenue reported to Singular: AdPlatform: " + data.getAdPlatform() + ", Currency: " + data.getCurrency() + ", Revenue: " + data.getRevenue());
}