Методы Обратного Вызова Для Отслеживания Дохода От Рекламы

Appodeal SDK позволяет вам получить данные о доходе от рекламы на уровне показа с помощью Ad Revenue Callbacks. Эти данные включают в себя такую информацию, как название рекламной сети, доход, тип рекламы, и т.д.

Данные о доходе от рекламы на уровне показа могут использоваться для отправки в сторонние SDK, такие как Firebase, для всех поддерживаемых рекламных сетей.

Если вы уже интегрировали Firebase, который включен в Appodeal SDK, используя инструкцию, то данные о доходе от рекламы будут отправлены автоматически, можете почитать подробнее здесь во втором шаге.

Минимальные требования:

Appodeal SDK 3.0.1+

Реализация Методов Обратного Вызова

UPM Дистрибуция

1. Подпишитесь на событие дохода от рекламы, используя один из методов из нашей инструкции.
2. Вы можете использовать методы обратного вызова, как показано ниже:

public void SomeMethod()
{
	AppodealCallbacks.AdRevenue.OnReceived += (sender, args) => {};
}

Manual Дистрибуция

1. Наследуйте ваш класс от IAdRevenueListener:

SomeClassName : IAdRevenueListener {}

2. Реализуйте все методы обратного вызова в вашем классе:

#region IAdRevenueListener implementation

public void onAdRevenueReceived(AppodealAdRevenue ad)
{
    // Called whenever SDK receives revenue information for an ad
}

#endregion

3. Затем вызовите следующий метод перед инициализацией Appodeal SDK:

Appodeal.setAdRevenueCallback(this);

Примечание Admob

Для получения дохода от рекламы на уровне показов от Admob вам также необходимо включить эту настройку в вашей учетной записи AdMob.

Перейдите в Admob Account Settings → Account → включите Impression-level ad revenue переключатель.

---

Описание Appodeal Ad Revenue

AppodealAdRevenue - представляет информацию о доходах.

Parameter	Type	Description
NetworkName	String	Имя рекламной сети
DemandSource	String	Имя источника в случае показа в результате торгов в реальном времени
AdUnitName	String	Уникальное название рекламного блока
Placement	String	Имя плейсмента в Appodeal
Revenue	Double	Сумма дохода от объявления или 0, если его не существует
AdType	String	Тип рекламы Appodeal в строковом представлении
Currency	String	Текущая валюта, поддерживаемая Appodeal (USD) в строковом представлении
RevenuePrecision	String	Точность дохода

Варианты точности дохода

1. exact - программный доход - это итоговая цена аукциона
2. publisher_defined - доход от кросс-промо кампаний
3. estimated - доход на основе исторических данных сети eCPM и прайсфлоров
4. undefined - сумма дохода не определена

---

Вариант Использования

Помните:

Если вы интегрировали аналитику, например Firebase, используя это руководство с Appodeal, то никаких дополнительных действий не требуется.

Если вы используете в проекте свою собственную аналитику, то воспользуйтесь примером ниже:

UPM Дистрибуция

#region IAdRevenueListener implementation

public void OnAdRevenueReceived(AppodealAdRevenue ad)
{
	//AppsFlyer
	var dict = new Dictionary<string, string>();
	dict.Add("AdUnitName", ad.AdUnitName);
	dict.Add("AdType", ad.AdType);
	AppsFlyerAdRevenue.logAdRevenue(ad.NetworkName,
		AppsFlyerAdRevenueMediationNetworkType.AppsFlyerAdRevenueMediationNetworkTypeAppodeal,
		ad.Revenue, ad.Currency, dict
	);

	//Adjust
	AdjustAdRevenue adRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourcePublisher);
	adRevenue.setRevenue(ad.Revenue, ad.Currency);
	adRevenue.setAdRevenueNetwork(ad.NetworkName);
	adRevenue.setAdRevenueUnit(ad.AdUnitName);
	Adjust.trackAdRevenue(adRevenue);

	//Firebase
	Firebase.Analytics.FirebaseAnalytics.LogEvent(
		Firebase.Analytics.FirebaseAnalytics.EventAdImpression,
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.ParameterAdPlatform, "Appodeal"),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.ParameterAdFormat, ad.AdType),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.ParameterAdSource, ad.NetworkName),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.AdUnitName, ad.AdUnitName),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.AdCurrency, ad.Currency),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.Value, ad.Revenue)
	);
}

#endregion

Manual Дистрибуция

#region IAdRevenueListener implementation

public void onAdRevenueReceived(AppodealAdRevenue ad)
{
	//AppsFlyer
	var dict = new Dictionary<string, string>();
	dict.Add("AdUnitName", ad.AdUnitName);
	dict.Add("AdType", ad.AdType);
	AppsFlyerAdRevenue.logAdRevenue(ad.NetworkName,
		AppsFlyerAdRevenueMediationNetworkType.AppsFlyerAdRevenueMediationNetworkTypeAppodeal,
		ad.Revenue, ad.Currency, dict
	);

	//Adjust
	AdjustAdRevenue adRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourcePublisher);
	adRevenue.setRevenue(ad.Revenue, ad.Currency);
	adRevenue.setAdRevenueNetwork(ad.NetworkName);
	adRevenue.setAdRevenueUnit(ad.AdUnitName);
	Adjust.trackAdRevenue(adRevenue);

	//Firebase
	Firebase.Analytics.FirebaseAnalytics.LogEvent(
		Firebase.Analytics.FirebaseAnalytics.EventAdImpression,
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.ParameterAdPlatform, "Appodeal"),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.ParameterAdFormat, ad.AdType),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.ParameterAdSource, ad.NetworkName),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.AdUnitName, ad.AdUnitName),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.AdCurrency, ad.Currency),
			new Firebase.Analytics.Parameter(
				Firebase.Analytics.FirebaseAnalytics.Value, ad.Revenue)
	);
}

#endregion

---