پرسش‌های متداول کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی Google

چرا برای همه قالب‌ها آگهی دریافت نمی‌کنم؟
برچسب‌های آگهی آزمایشی به‌گونه‌ای تنظیم شده‌اند که همیشه برای درخواست‌های معتبر آگهی برگردانند. هدف از این کار تسهیل ادغام و آسان‌تر کردن آزمایش نحوه درخواست و ارائه آگهی توسط پخش‌کننده شما است. بااین‌حال، آگهی‌ها همیشه در همه قالب‌ها برای سایت، حساب، یا واحد آگهی شما دردسترس نیستند. اگر یکپارچگی شما برای برچسب آزمایشی به‌درستی کار می‌کند اما برای برچسب خودتان کار نمی‌کند، ممکن است دلیل آن یکی از موارد زیر باشد:
  • ویدیوهایی با قالب پشتیبانی‌نشده را به محیطتان ارائه می‌کنید. برای مثال، فقط آگهی‌های HTML5 را به iOS یا Android ارائه می‌کنید.
  • اگر از Ad Manager استفاده می‌کنید، ممکن است درحال‌حاضر هیچ آگهی‌ای برای شناسه ناشر شما هدف‌یابی نشده باشد. همچنین مطمئن شوید که آگهی‌ها و عناصر خلاقانه مربوطه را در Ad Manager تأیید کرده‌اید.
  • اگر از AdSense استفاده می‌کنید، ممکن است معیارهای هدف‌یابی برای سایت یا صفحه آزمایشی شما هیچ تبلیغات فعالی نداشته باشد. رایج‌ترین دلیل استفاده از وب‌سایت‌های خصوصی و خزنده نشده است.
  • اگر از «مدیریت شریک شبکه Ad Exchange» استفاده می‌کنید و descriptionURL تنظیم نشده است یا در فهرست مدیریت دامنه‌های تحت مالکیت یا اداره‌شده نیست، آگهی‌ها به این مورد ارائه نمی‌شود.
  • آستانه‌های minCPM تعریف‌شده در Ad Exchange Video را بررسی کنید. «هزارظهوربهای» نسبتاً بالا ممکن است منجر به نرخ پر شدن بسیار پایین شود. برای اصلاح این وضعیت، یا minCPM را بردارید یا پارامتر واحد آگهی را از درخواست آگهی بردارید (یعنی slotname) تا بررسی کنید که آیا این وضعیت بر نرخ تکمیل تأثیر می‌گذارد یا نه.
‫descriptionUrl خوب چگونه است؟
برای اینکه بیشترین تأثیر را داشته باشد، محتوای صفحه‌ای که descriptionUrl به آن اشاره می‌کند نباید مجموعه‌ای از کلمات یا عبارات باشد، بلکه باید ۱ تا ۳ پاراگراف باشد که محتوا و نقش شما در ارائه آن را به‌طور واقعی توصیف کند. یکی از روش‌هایی که در گذشته موفقیت‌آمیز بوده است، به‌هم دوختن محتوای صفحه descriptionUrl به‌صورت پویا از بلوک‌های ازپیش تعریف‌شده است. برای مثال، چند جمله درباره محتوا، چند جمله درباره پیشنهاد سایتتان، و سپس چند گلچین ازپیش‌تعریف‌شده مرتبط با هر کانال AdSense (مثل «سرگرمی» یا «ورزش»). در نتیجه، هر قطعه محتوا دارای descriptionUrl نسبتاً متمایزی است که با آن مرتبط است و هم اطلاعات کلی (مانند توصیف‌گرهای ژانر) و هم اطلاعات خاص (محتوای مربوط به خود محتوا) را ارائه می‌دهد.

این فراداده HTML باید ساده باشد، برای مثال:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
چرا خطای «پاسخ آگهی حاوی نوع آگهی معتبری نیست» را دریافت می‌کنم؟
این خطا معمولاً به این دلیل ظاهر می‌شود که هیچ آگهی‌ای برای publisherId خاص (برای دوره زمانی معین) هدف‌یابی نشده است. این وضعیت ممکن است درطول روز یا درطول چند روز با شروع و پایان پویش‌ها تغییر کند. باید بررسی کنید که آگهی‌ای که می‌خواهید هدف‌یابی کنید منقضی نشده باشد و معیارهای هدف‌یابی آگهی صحیح باشد. تا زمانی که آگهی‌ها به‌درستی درخواست، دریافت، و بااستفاده از publisherId آزمایشی ارائه شوند، می‌توانید مطمئن باشید که این آگهی‌ها به‌درستی بااستفاده از publisherId فعال شما در زمانی که آگهی‌ها دردسترس هستند مدیریت می‌شوند.
آیا برچسب آگهی ویدیویی Ad Manager دارید که بتوانم برای آزمایش استفاده کنم؟
برچسب‌های نمونه در صفحه برچسب‌های نمونه دردسترس هستند.
آیا باید adSlotWidth و adSlotHeight را روی همان مقادیر sz در برچسب آگهی «مدیر آگهی» تنظیم کنم؟
لزوماً نه. adSlotWidth و adSlotHeight باید روی عرض/ارتفاع پخش‌کننده یا ناحیه‌ای که می‌خواهید آگهی‌هایتان پر کند تنظیم شود. ‫AdSense از آن‌ها برای تعیین اینکه کدام آگهی‌ها برای قرار گرفتن در آن فضا دردسترس هستند استفاده می‌کند. جفت کلید/مقدار sz در برچسب آگهی Ad Manager شما پارامتر هدف‌یابی است و لزوماً بر طرح‌آگهی ارائه‌شده تأثیر نمی‌گذارد (اطلاعات بیشتر در زیر).
برچسب آگهی نمایشی عالی به‌نظر می‌رسد، اما وقتی آن را با برچسب آگهی خودم عوض می‌کنم، هیچ آگهی‌ای ظاهر نمی‌شود.
بررسی کنید تا مطمئن شوید چیزی به برچسب آگهی که درخواست می‌کنید ارسال شده باشد. آسان‌ترین راه برای فهمیدن این موضوع، تماشای ترافیک HTTP است. اگر تصویر 1x1 pixel grey.gif در بلوک لنگر HTML برگردانده شود، باید هدف‌یابی‌تان را در Ad Manager بررسی کنید.
می‌خواهم بااستفاده از برچسب یکسان بیش‌از یک‌بار آگهی درخواست کنم، اما فقط برای اولین درخواستم آگهی دریافت می‌کنم. چگونه این مشکل را حل کنم؟
وقتی بیش‌از یک‌بار درخواست آگهی می‌کنید، باید به سرور آگهی اطلاع دهید که این درخواست‌ها قانونی هستند و تکراری تصادفی نیستند. کیت توسعه نرم‌افزار این کار را با دو فراخوانی سریع میانای برنامه‌سازی کاربردی برای شما انجام می‌دهد:
  1. با destroy() در نمونه AdsManager تماس بگیرید. این کار از پخش هرگونه پس‌از پخش هنگام برقراری تماس زیر با contentComplete() جلوگیری می‌کند. وقتی درخواست بعدی را ارائه می‌کنید، AdsManager جدیدی دریافت می‌کنید.
  2. با contentComplete() در نمونه AdsLoader تماس بگیرید. این کار کیت توسعه نرم‌افزار را بازنشانی می‌کند تا درخواست آگهی جدید شبیه درخواست قبلی نباشد.
پس‌از برقراری دو تماس بالا، می‌توانید با requestAds() در نمونه AdsLoader خود تماس بگیرید تا مجموعه دیگری از آگهی‌ها را برای پخش در ویدیو جدیدتان دریافت کنید.
چگونه بااستفاده از «کیت توسعه نرم‌افزار IMA» برای آگهی‌های رونهاد و جایگاه کامل AdSense درخواست کنم؟

برای درخواست آگهی‌های AdSense بااستفاده از کیت توسعه نرم‌افزار، ابتدا باید برچسب آگهی AdSense دریافت کنید. می‌توانید درباره آن در صفحه AdSense برای ویدیو بیشتر بدانید. وقتی برچسبتان را دریافت کردید، باید مراحل زیر را برای ایجاد درخواست آگهی هم‌پوشان یا تمام‌جایگاه دنبال کنید:

آگهی‌های هم‌پوشانی
  1. در AdsRequest، «حالت‌های نمایش» را روی NORMAL تنظیم کنید.
  2. در برچسب آگهی‌تان، پارامتر overlay=1 را اضافه کنید.
آگهی‌های جایگاه کامل
  1. در AdsRequest، ViewModes را روی FULLSCREEN تنظیم کنید.
  2. در برچسب آگهی‌تان، پارامتر overlay=0 را اضافه کنید.
وقتی روی آگهی‌ام کلیک می‌کنم، خطای «نشانی وب کلیک‌گذر نامعتبر» دریافت می‌کنم. علت چه می‌تواند باشد؟
رایج‌ترین دلیل این خطا نشانی وب کلیک‌گذری است که به‌درستی گریز داده نشده است. اگر این خطا را می‌بینید، بررسی کنید که آیا نشانی وب کلیک‌گذر شما در پاسخ VAST به‌درستی فرار کرده است یا خیر.
در کیت‌های توسعه نرم‌افزار Android و iOS، آیا راهی برای کلیک‌کردنی کردن کل آگهی ویدیویی وجود دارد؟
تا جایی که به ردیابی کلیک کل ویدیو مربوط می‌شود، تجربه استاندارد بیننده برای ویدیو تلفن همراه که پدید آمده است این است که تک‌ضرب زدن روی ویدیو یا آن را موقتاً متوقف می‌کند یا کنترل‌های پخش‌کننده را ظاهر می‌کند. برای جلوگیری از کلیک ناخواسته کاربران روی آگهی‌ها وقتی واقعاً فقط می‌خواهند به کنترل‌های پخش‌کننده دسترسی داشته باشند، IMA از دکمه بیشتر بدانید استفاده می‌کند تا به کاربران اجازه دهد روی آگهی کلیک کنند و درباره محصولی که تبلیغ می‌شود بیشتر بدانند.
چرا خطای «VAST Document Empty» را می‌بینم؟
این خطا زمانی رخ می‌دهد که برچسب آگهی سند VAST خالی برمی‌گرداند، که نشان می‌دهد آگهی به‌درستی ارائه نشده است. با مدیر حسابتان یا نماینده سرور آگهی صحبت کنید تا ببینید چرا برچسب آگهی‌تان کار نمی‌کند.
آیا می‌توانم اندازه/نوشتار چارگوش رد کردن آگهی یا دیگر عناصر واسط کاربر را تغییر دهم؟
کیت‌های توسعه نرم‌افزار IMA از تغییر چیدمان، اندازه، یا محتوای عناصر میانای کاربر پشتیبانی نمی‌کنند. برای جزئیات بیشتر درباره عناصر میانای کاربر، AdsManager.uiElements را ببینید.
چرا در زمان اجرا خطاهای «روش مجازی وجود ندارد» دریافت می‌کنم؟

پیام‌های خطا مشابه پیام زیر به‌دلیل استفاده از نسخه قدیمی‌تر «خدمات Google Play» است که شناسه تبلیغاتی را ندارد.

No virtual method
getInfo()Lcom/google/android/gms/ads/identifier/AdvertisingIdClient$Info; in
class Lcom/google/android/gms/ads/identifier/AdvertisingIdClient; or its
super classes (declaration of 'com.google.android.gms.ads.identifier.AdvertisingIdClient'

ارتقا به نسخه ۴.۰ یا بالاتر (اما ترجیحاً جدیدترین نسخه) این مشکل را حل می‌کند.

آیا می‌توانم از چند رشته برای مقداردهی اولیه و دستکاری واسط کاربر استفاده کنم؟
نه، همه مقداردهی‌های اولیه و دستکاری‌های واسط کاربر باید در رشته اصلی انجام شود. در Android، اشیای رابط کاربری نخ‌امن نیستند. برای اطلاعات بیشتر، Threads را ببینید.