آدرس اینترنتی شفافیت آگهی به شما امکان میدهد نماد AdChoices را که در تبلیغات خاصی نمایش داده میشود، سفارشی کنید. به طور پیشفرض، این نماد از طریق یک تجربه شفافیت و کنترل آگهی (AT&C) ارائه شده توسط گوگل که شامل اطلاعاتی مانند تبلیغکننده و خود آگهی است، برای کاربران شما ظاهر میشود.
شما میتوانید با ارسال درخواست تبلیغ به SDK تبلیغات موبایل گوگل، URL شفافیت تبلیغ را دریافت کنید و پاسخی حاوی URL شفافیت تبلیغ دریافت کنید. پس از دریافت URL در برنامه خود، میتوانید یک آیکون شخصیسازیشده را که میتواند با طراحی تبلیغات شما مطابقت داشته باشد، ادغام کنید و تجربه AT&C خود را به کاربرانتان ارائه دهید.
این صفحه نحوه درخواست، تجزیه و تحلیل و اعتبارسنجی URL شفافیت تبلیغات را پوشش میدهد.
پیشنیازها
قبل از ادامه، مطمئن شوید که موارد زیر را تکمیل کردهاید:
- تبلیغات بومی را در برنامه خود تنظیم کنید. برای جزئیات بیشتر در مورد تبلیغات بومی، به تبلیغات بومی مراجعه کنید.
- درخواست دسترسی به این ویژگی از طریق لیست مجاز. برای درخواست دسترسی، با مدیر حساب خود تماس بگیرید.
- اگر دسترسی نداشته باشید، پاسخهای شما URL شفافیت تبلیغ را برنمیگردانند و نماد پیشفرض مطابق انتظار نمایش داده میشود.
درخواست آدرس اینترنتی (URL)
برای اینکه GMA Next-Gen SDK آدرس اینترنتی شفافیت تبلیغات را به شما برگرداند، باید یک پارامتر درخواست اضافی در درخواستهای تبلیغات بومی خود اضافه کنید. این پارامتر نشان میدهد که برنامه شما آماده و مهیا برای مدیریت یک آیکون شخصیسازی شده است.
در درخواست خود، باید کلید "ad_transparency_url_requested" را با مقدار "1" به بستهی امکانات شبکهی خود اضافه کنید. برای جزئیات بیشتر در مورد امکانات شبکه، به setGoogleExtrasBundle مراجعه کنید.
مثال زیر این کلید و مقدار را برای درخواست URL شفافیت تبلیغ تنظیم میکند:
جاوا
private void loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation.
Bundle extras = new Bundle();
extras.putString("ad_transparency_url_requested", "1");
NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build();
}
کاتلین
private fun loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation
val extras = Bundle()
extras.putString("ad_transparency_url_requested", "1");
val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build()
}
به جای AD_UNIT_ID ، شناسه واحد تبلیغاتی خود را وارد کنید. برای مثال، ca-app-pub-3940256099942544/2247696110 برای تبلیغات بومی.
URL را تجزیه کنید
پس از درخواست URL، یک پاسخ تبلیغاتی با URL شفاف تبلیغاتی در شیء اطلاعات پاسخ دریافت میکنید. برای جزئیات بیشتر در مورد شیء اطلاعات پاسخ، به Response info مراجعه کنید.
شما میتوانید به آدرس اینترنتی شفافیت تبلیغ (ad transparency URL) در کلید "ad_transparency_url" از قسمت پاسخهای اضافی (response extras) دسترسی پیدا کنید. مثال زیر آدرس اینترنتی شفافیت تبلیغ را در شیء اطلاعات پاسخ (response info object) دریافت میکند:
جاوا
nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");
کاتلین
nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")
اعتبارسنجی URL
برای آزمایش و اعتبارسنجی URL شفافیت تبلیغ، مطمئن شوید که آیکون پیشفرض ارائه شده توسط گوگل را در تبلیغ بومی خود نمیبینید، بلکه آیکون شخصیسازیشده خودتان را میبینید. برای مشاهده تجربه AT&C روی آیکون کلیک کنید.
علاوه بر این، تأیید کنید که URL مربوط به شفافیت تبلیغ را از قسمتهای اضافی پاسخ در شیء اطلاعات پاسخ خود مشاهده میکنید. اگر URL شفافیت تبلیغ را نمیبینید، آیکون پیشفرض گوگل به جای آیکون شخصیسازیشده شما نمایش داده میشود. در زیر نمونهای از URL شفافیت تبلیغ آمده است:
https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID