وقتی ظهوری رخ میدهد، Google Mobile Ads SDK (Legacy) دادههای درآمد آگهی مرتبط با آن ظهور را ارائه میدهد. میتوانید از این دادهها برای محاسبه ارزش طول عمر کاربر استفاده کنید یا دادهها را به سیستمهای مرتبط دیگر ارسال کنید.
این راهنما برای کمک به شما در پیادهسازی ضبط دادههای درآمد آگهی در سطح ظهور در برنامه Android شما طراحی شده است.
پیشنیازها
- مطمئن شوید که ویژگی درآمد آگهی در سطح ظهور را روشن کردهاید در رابط کاربری AdMob.
- Google Mobile Ads SDK (Legacy) نسخه ۲۱.۱.۰ یا بالاتر را وارد کنید.
- Google Mobile Ads SDK (Legacy) را راهاندازی کنید.
قبلاز اینکه بتوانید درآمد آگهی در سطح ظهور دریافت کنید، باید حداقل یک قالب آگهی را پیادهسازی کنید:
مدیریتكننده رویداد پولی
هر قالب آگهی دارای
OnPaidEventListener است.
درطول چرخه حیات رویداد آگهی، Google Mobile Ads SDK (Legacy) رویدادهای ظهور را پایش میکند و گرداننده را با مقدار کسبشده فراخوانی میکند.
مثال زیر رویدادهای پولی را برای آگهی پاداشدار مدیریت میکند:
جاوا
private void setOnPaidEventListener(RewardedAd ad) {
ad.setOnPaidEventListener(
new OnPaidEventListener() {
@Override
public void onPaidEvent(@NonNull AdValue adValue) {
// Extract the impression-level ad revenue data.
long valueMicros = adValue.getValueMicros();
String currencyCode = adValue.getCurrencyCode();
int precision = adValue.getPrecisionType();
// Get the ad unit ID.
String adUnitId = ad.getAdUnitId();
// Extract ad response information.
AdapterResponseInfo loadedAdapterResponseInfo =
ad.getResponseInfo().getLoadedAdapterResponseInfo();
if (loadedAdapterResponseInfo != null) {
String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();
Bundle extras = ad.getResponseInfo().getResponseExtras();
String mediationGroupName = extras.getString("mediation_group_name");
String mediationABTestName = extras.getString("mediation_ab_test_name");
String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
}
}
});
}Kotlin
private fun setOnPaidEventListener(ad: RewardedAd) {
ad.onPaidEventListener = OnPaidEventListener { adValue ->
// Extract the impression-level ad revenue data.
val valueMicros = adValue.valueMicros
val currencyCode = adValue.currencyCode
val precision = adValue.precisionType
// Get the ad unit ID.
val adUnitId = ad.adUnitId
// Extract ad response information.
val loadedAdapterResponseInfo = ad.responseInfo.loadedAdapterResponseInfo
val adSourceName = loadedAdapterResponseInfo?.adSourceName
val adSourceId = loadedAdapterResponseInfo?.adSourceId
val adSourceInstanceName = loadedAdapterResponseInfo?.adSourceInstanceName
val adSourceInstanceId = loadedAdapterResponseInfo?.adSourceInstanceId
val extras = ad.responseInfo.responseExtras
val mediationGroupName = extras.getString("mediation_group_name")
val mediationABTestName = extras.getString("mediation_ab_test_name")
val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
}
}شناسایی نام منبع آگهی رویداد سفارشی
برای منابع آگهی رویداد سفارشی، روش getAdSourceName()
نام منبع آگهی Custom event را برمیگرداند. اگر از چند رویداد سفارشی استفاده میکنید، نام منبع آگهی بهاندازه کافی جزئی نیست که بتواند بین چند رویداد سفارشی تمایز قائل شود. برای پیدا کردن رویداد سفارشی خاص، این کار را انجام دهید:
- روش
getAdSourceName()را فراخوانی کنید. - نام منبع آگهی منحصربهفردی تنظیم کنید.
مثال زیر نام منبع آگهی منحصربهفردی را برای رویداد سفارشی تنظیم میکند:
جاوا
private String getUniqueAdSourceName(@NonNull AdapterResponseInfo loadedAdapterResponseInfo) {
String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
if (adSourceName.equals("Custom Event")) {
if (loadedAdapterResponseInfo
.getAdapterClassName()
.equals("com.google.ads.mediation.sample.customevent.SampleCustomEvent")) {
adSourceName = "Sample Ad Network (Custom Event)";
}
}
return adSourceName;
}
Kotlin
private fun getUniqueAdSourceName(loadedAdapterResponseInfo: AdapterResponseInfo): String {
var adSourceName = loadedAdapterResponseInfo.adSourceName
if (adSourceName == "Custom Event") {
if (
loadedAdapterResponseInfo.adapterClassName ==
"com.google.ads.mediation.sample.customevent.SampleCustomEvent"
) {
adSourceName = "Sample Ad Network (Custom Event)"
}
}
return adSourceName
}
برای اطلاعات بیشتر درباره منبع آگهی برنده، به بازیابی اطلاعات درباره پاسخ آگهی مراجعه کنید.
ادغام «شریک ارجاع برنامه» (AAP)
برای جزئیات کامل درباره بازارسال دادههای درآمد آگهی به پلاتفرمهای تجزیهوتحلیل، به راهنمای شریک مراجعه کنید:
| کیت توسعه نرمافزار شریک |
|---|
| تنظیم کردن |
| AppsFlyer |
| Singular |
| Tenjin |
روالهای مطلوب پیادهسازی
- بهمحض ایجاد یا دسترسی به شیء آگهی، شنونده را تنظیم کنید، و حتماً قبلاز نمایش آگهی این کار را انجام دهید. این کار تضمین میکند که هیچکدام از فراخوانیهای رویداد پولی را ازدست ندهید.
- اطلاعات درآمد آگهی در سطح ظهور را بلافاصله در زمان فراخوانی برگشت فراخوانی رویداد پولی به سرور تجزیهوتحلیل دلخواهتان ارسال کنید. این کار تضمین میکند که بهطور تصادفی هیچکدام از تماسهای برگشتی را ازدست ندهید و از اختلاف دادهها جلوگیری میکند.
AdValue
AdValue کلاسی است که ارزش پولی کسبشده برای آگهی را نشان میدهد،
ازجمله کد واحد پول مقدار و نوع دقت آن که بهصورت زیر کدگذاری شده است.
| PrecisionType | شرح |
|---|---|
UNKNOWN |
مقدار آگهی که ناشناخته است. این خطا زمانی برگردانده میشود که پینگبک LTV فعال باشد اما دادههای کافی دردسترس نباشد. |
ESTIMATED |
مقدار آگهی تخمینزدهشده از دادههای تجمیعی. |
PUBLISHER_PROVIDED |
مقدار آگهی ارائهشده توسط ناشر، مانند هزارظهوربهای دستی در گروه میانجیگری. |
PRECISE |
مبلغ دقیقی که برای این آگهی پرداخت شده است. |
در «واسطهگری AdMob»، AdMob تلاش میکند
مقدار ESTIMATED را برای منابع آگهیای که
بهینهسازی شدهاند ارائه دهد.
برای منابع آگهی بهینهنشده، یا در مواردی که دادههای تجمیعی کافی برای گزارش برآورد معنادار وجود ندارد، مقدار PUBLISHER_PROVIDED برگردانده میشود.
آزمایش ظهورها از منابع آگهی مناقصه
پساز اینکه رویداد درآمد آگهی در سطح ظهور برای منبع آگهی مزایدهای ازطریق درخواست آزمایشی رخ میدهد، فقط مقادیر زیر را دریافت میکنید:
-
UNKNOWN: نوع دقت را نشان میدهد.
0: نشاندهنده ارزش آگهی است.
UNKNOWN و مقدار آگهی را بیشتر از 0 ببینید.
برای جزئیات درباره ارسال درخواست آگهی آزمایشی، به فعال کردن دستگاههای آزمایشی مراجعه کنید.