Seguimiento de los ingresos publicitarios – Centro de ayuda

Documento

Atribución de ingresos publicitarios

La atribución de ingresos por publicidad le ayuda a relacionar sus ingresos por publicidad con las campañas específicas que llevaron a los usuarios a su aplicación. Esto le ofrece una imagen clara del rendimiento de sus anuncios al mostrar el coste de la campaña, los ingresos dentro de la aplicación y los ingresos publicitarios, todo en un mismo lugar. Esta función también le permite enviar los datos de ingresos publicitarios a sus redes publicitarias para mejorar el rendimiento de sus anuncios.

Puntos clave:

Qué hace: Ad Revenue Attribution vincula los ingresos publicitarios de las aplicaciones móviles a las campañas de marketing que generaron usuarios para su aplicación. De este modo, puede ver cuánto ha ganado con cada campaña y cómo afecta a su ROI publicitario global.
Fuente de datos: Estos datos suelen proceder de su plataforma de mediación y pueden ser a nivel de usuario o a nivel de impresión. Singular admite diferentes formas de obtener estos datos de atribución.
Más información: Para obtener más detalles, consulte el artículo Preguntas frecuentes y solución de problemas sobre Singular Ad Revenue Attribution.

Notas importantes:

Códigos de moneda: Utilice códigos de moneda ISO 4217 de tres letras (por ejemplo, "USD" para dólares estadounidenses, "EUR" para euros, "INR" para rupias indias). Muchas plataformas de mediación utilizan "USD", así que asegúrese de que su código coincide con éste si lo utiliza. Si utiliza una moneda distinta, actualice el código de validación en consecuencia.
Exactitud de los datos: Compruebe siempre que sus datos de ingresos y divisas son correctos antes de enviarlos a Singular. Los datos incorrectos no se pueden corregir más tarde, por lo que es crucial asegurarse de que son exactos.

Implementación de la atribución de ingresos publicitarios

Actualice el SDK: Asegúrese de que dispone de la última versión del SDK de Singular.
Añada fragmentos de código: Dependiendo de su plataforma de mediación, añada los fragmentos de código adecuados a la configuración de Singular SDK.

Seguir estos pasos le ayudará a configurar Ad Revenue Attribution correctamente y a sacar el máximo partido de sus datos publicitarios.

AdMob

Notas para socios

Esta función debe estar habilitada en su cuenta de AdMob.
Consulte Soporte de AdMob.
Cuando cargue un formato de anuncio (como "App Open", "Banner", "Interstitial", "Native" o "Rewarded"), configure un paidEventHandler como función de devolución de llamada que se active cada vez que un anuncio genere ingresos. El SDK de Google Mobile Ads realiza un seguimiento de los eventos de impresión y llama a este controlador con los ingresos generados por el anuncio.

Para ello, modifica la función"load" del formato del anuncio para incluir el paidEventHandler. Dentro de esta devolución de llamada, gestiona los datos de ingresos del anuncio, los valida y los envía a Singular mediante la función Singular.adRevenue.

Por ejemplo, cuando un "anuncio recompensado" se carga correctamente, el paidEventHandler recibirá la información de ingresos del anuncio (adValue). En esta función, maneja los datos de ingresos y los envía a Singular.

Para más detalles, consulte la documentación de AdMob.

IMPORTANTE: El SDK de AdMob informa de los ingresos de forma diferente en función de la plataforma. Por ejemplo, los ingresos publicitarios de 0,005 $ se devolverán como 5000 en las plataformas Unity y Android, pero como 0,005 en iOS. Para iOS, envíe 0,005 directamente al SDK de Singular. En otras plataformas, convierta adValue de micros a dólares antes de enviarlo a Singular.

Seleccione la base de código para la implementación de su SDK:

Cómo funciona:

Implemente el SDK de Google AdMob Mobile Ads (Android): Consulte la Guía de introducción.
Integración con AdMob: Cargue el anuncio desde AdMob y configure un setOnPaidEventListener para gestionar los eventos de ingresos publicitarios.
Validación de ingresos: Añada una comprobación para asegurarse de que los ingresos son superiores a 0. De este modo se evita el envío de valores de ingresos nulos o negativos.
Validación de divisas: Asegúrese de que la divisa no sea nula o esté vacía antes de enviar los datos a Singular.
Registro de datos no válidos: Si los datos no superan la validación, imprima un mensaje de registro para depuración y no envíe los datos 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}")
            }
        })
    }
}

Cómo funciona:

Implemente el SDK de Google AdMob Mobile Ads (Android): Consulte la Guía de introducción.
Integración con AdMob: Cargue el anuncio desde AdMob y configure un setOnPaidEventListener para gestionar los eventos de ingresos de anuncios.
Validación de ingresos: Añada una comprobación para asegurarse de que los ingresos son superiores a 0. De este modo se evita el envío de valores de ingresos nulos o negativos.
Validación de divisas: Asegúrese de que la divisa no sea nula o esté vacía antes de enviar los datos a Singular.
Registro de datos no válidos: Si los datos no superan la validación, imprima un mensaje de registro para depuración y no envíe los datos a 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 para socios

Comparta datos de ingresos publicitarios a nivel de impresiones mediante la API de ingresos de usuarios a nivel de impresiones de Applovin.

Seleccione la base de código para la implementación de su SDK:

Cómo funciona:

Utiliza la API AppLovin Impression-Level User Revenue (Android): Consulta la Guía de introducción.
Integración con AppLovin: Carga un anuncio recompensado de AppLovin MAX y utiliza la función onMessageReceived para gestionar los eventos de ingresos publicitarios.
Validación de ingresos: Añada una comprobación para garantizar que los ingresos sean superiores a 0. De este modo se evita el envío de valores de ingresos nulos o negativos.
Validación de moneda: En el ejemplo siguiente, la divisa está codificada como "USD". Asegúrese de que la moneda es correcta y no nula o vacía antes de enviar los datos a Singular.
Registro de datos no válidos: Si los datos no superan la validación, imprima un mensaje de registro para depuración y no envíe los datos a 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")
        }
    }
}

Cómo funciona:

Utiliza la API de ingresos de usuario a nivel de impresión de AppLovin (Android): Consulte la Guía de introducción.
Integración con AppLovin: Carga un anuncio recompensado de AppLovin MAX y utiliza la función onMessageReceived para gestionar los eventos de ingresos por anuncios.
Validación de ingresos: Añada una comprobación para garantizar que los ingresos sean superiores a 0. De este modo se evita el envío de valores de ingresos nulos o negativos.
Validación de moneda: En el ejemplo siguiente, la divisa está codificada como "USD". Asegúrese de que la moneda es correcta y no nula o vacía antes de enviar los datos a Singular.
Registro de datos no válidos: Si los datos no superan la validación, imprima un mensaje de registro para depuración y no envíe los datos a 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 del socio

La API del SDK de Impression Level Revenue (ILR) proporciona datos de nivel de impresión para ironSource Ads y otras redes mediadas, utilizando el SDK de ironSource. Más información en[developers.is.com]
Asegúrese de que la bandera ARM SDK Postbacks en IronSource está activada

Seleccione la base de código para la implementación de su SDK:

Cómo funciona:

Utiliza el SDK ironSource para obtener ingresos de usuario a nivel de impresión (Android): Consulte la Guía de introducción.
Integración con Ironsource: Carga un anuncio recompensado desde Ironsource y utiliza la función onImpressionDataSuccess para gestionar los eventos de Ad Revenue.
Validación de ingresos: Añada una comprobación para asegurarse de que los ingresos son superiores a 0. Esto evita el envío de valores de ingresos nulos o negativos.
Validación de moneda: En el ejemplo siguiente, la moneda está codificada como "USD". Asegúrese de que la moneda es correcta y no nula o vacía antes de enviar los datos a Singular.
Registro de datos no válidos: Si los datos no superan la validación, imprima un mensaje de registro para depuración y no envíe los datos a 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}")
}

Cómo funciona:

Utiliza el SDK de ironSource para obtener ingresos de usuario a nivel de impresión (Android): Consulte la Guía de inicio.
Integración con Ironsource: Carga un anuncio recompensado desde Ironsource y utiliza la función onImpressionDataSuccess para gestionar los eventos de Ad Revenue.
Validación de ingresos: Añada una comprobación para asegurarse de que los ingresos son superiores a 0. Esto evita el envío de valores de ingresos nulos o negativos.
Validación de moneda: En el ejemplo siguiente, la moneda está codificada como "USD". Asegúrese de que la moneda es correcta y no nula o vacía antes de enviar los datos a Singular.
Registro de datos no válidos: Si los datos no superan la validación, imprima un mensaje de registro para depuración y no envíe los datos a 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 del socio

Establezca el impressionDelegate
Añada Singular a la devolución de llamada TradPlusAdImpression

Seleccione la base de código para la implementación de su SDK:

Cómo funciona:

Integración con TradPlus: Cargue un anuncio recompensado desde TradPlus y utilice la función onImpressionSuccess para gestionar los eventos de ingresos por anuncios.
Validación de ingresos: Añada una comprobación para asegurarse de que los ingresos son superiores a 0. Esto evita el envío de valores de ingresos nulos o negativos. El diccionario adInfo contiene una clave"ecpm" con un valor NSNumber válido. Convierte este valor a Double y lo escala(normalmente ecpm se da en mili-unidades, por lo que dividiendo por 1000.0 lo convierte a dólares).
Validación de moneda: En el ejemplo de abajo, la moneda está codificada en "USD". Asegúrese de que la moneda es correcta y no nula o vacía antes de enviar los datos a Singular.
Registro de datos no válidos: Si los datos no superan la validación, imprima un mensaje de registro para depuración y no envíe los datos a 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}")
        }
    }
)

Cómo funciona:

Integración con TradPlus: Cargue un anuncio premiado desde TradPlus y utilice la función onImpressionSuccess para gestionar los eventos de ingresos por anuncios.
Validación de ingresos: Añada una comprobación para asegurarse de que los ingresos son superiores a 0. Esto evita el envío de valores de ingresos nulos o negativos. El diccionario adInfo contiene una clave"ecpm" con un valor NSNumber válido. Convierte este valor a Double y lo escala(normalmente ecpm se da en mili-unidades, por lo que dividiendo por 1000.0 lo convierte a dólares).
Validación de moneda: En el ejemplo de abajo, la moneda está codificada en "USD". Asegúrese de que la moneda es correcta y no nula o vacía antes de enviar los datos a Singular.
Registro de datos no válidos: Si los datos no superan la validación, imprima un mensaje de registro para depuración y no envíe los datos a 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());
    }
}

Otros (Genérico)

Notas del socio

Integración genérica: Inicialice un objeto SingularAdData y pásele los datos necesarios. Los datos deben incluir la adPlatform como cadena, la divisa como cadena y los ingresos como doble.
Informes de ingresos: Compruebe que los datos de ingresos y divisa son correctos antes de enviarlos a Singular. Los datos incorrectos NO se pueden corregir más tarde, por lo que es crucial asegurarse de que son exactos.
Consejo: Registre la información con fines de depuración.

Seleccione la base de código para la implementación de su 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());
}