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

چرا برای همه قالب‌ها آگهی دریافت نمی‌کنم؟
برچسب‌های آگهی آزمایشی به‌گونه‌ای تنظیم شده‌اند که همیشه برای درخواست‌های معتبر آگهی برگردانند. این کار برای تسهیل ادغام و آسان‌تر کردن آزمایش نحوه درخواست و ارائه آگهی‌های پخش‌کننده شما انجام می‌شود. بااین‌حال، آگهی‌ها همیشه در همه قالب‌ها برای سایت، حساب، یا واحد آگهی شما دردسترس نیستند. اگر یکپارچگی شما برای برچسب آزمایشی به‌درستی کار می‌کند اما برای برچسب خودتان کار نمی‌کند، ممکن است دلیل آن یکی از موارد زیر باشد:
  • ویدیوهایی با قالب پشتیبانی‌نشده را به محیطتان ارائه می‌کنید. برای مثال، فقط آگهی‌های HTML5 را به iOS یا Android ارائه می‌کنید.
  • اگر از Ad Manager استفاده می‌کنید، ممکن است شناسه ناشر شما درحال‌حاضر هیچ تبلیغی نداشته باشد که آن را هدف‌یابی کند. همچنین مطمئن شوید که آگهی‌ها و عناصر خلاقانه مربوطه را در Ad Manager تأیید کرده‌اید.
  • اگر از AdSense استفاده می‌کنید، ممکن است معیارهای هدف‌یابی برای سایت یا صفحه آزمایشی شما هیچ تبلیغات فعالی نداشته باشد. رایج‌ترین دلیل استفاده از وب‌سایت‌های خصوصی و خزنده نشده است.
  • اگر از «مدیریت شریک شبکه Ad Exchange» استفاده می‌کنید و descriptionURL تنظیم نشده است یا در فهرست مدیریت دامنه‌های تحت مالکیت یا تحت مدیریت نیست، آگهی‌ها در آن نمایش داده نمی‌شود.
  • آستانه‌های minCPM تعریف‌شده در «ویدیو Ad Exchange» را بررسی کنید. «هزارظهوربهای» نسبتاً بالا ممکن است منجر به نرخ پر شدن بسیار پایین شود. برای اصلاح این وضعیت، یا 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 در برچسب آگهی Ad Manager تنظیم کنم؟
لزومی ندارد. 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، ViewModes را روی NORMAL تنظیم کنید.
  2. در برچسب آگهی‌تان، پارامتر overlay=1 را اضافه کنید.
آگهی‌های جایگاه کامل
  1. در AdsRequest، «حالت‌های نمایش» را روی FULLSCREEN تنظیم کنید.
  2. در برچسب آگهی‌تان، پارامتر overlay=0 را اضافه کنید.
وقتی روی آگهی‌ام کلیک می‌کنم، خطای «نشانی وب کلیک‌گذر نامعتبر» دریافت می‌کنم. علت چه می‌تواند باشد؟
رایج‌ترین دلیل این خطا نشانی وب کلیک‌گذری است که به‌درستی گریز داده نشده است. اگر این خطا را می‌بینید، مطمئن شوید که نشانی وب ازطریق کلیک شما به‌درستی در پاسخ VAST شما گریز داده شده است.
چرا خطای «VAST Document Empty» را می‌بینم؟
این خطا زمانی رخ می‌دهد که برچسب آگهی سند VAST خالی برمی‌گرداند، که نشان می‌دهد آگهی به‌درستی ارائه نشده است. با مدیر حسابتان یا نماینده سرور آگهی صحبت کنید تا ببینید چرا برچسب آگهی‌تان کار نمی‌کند.
آیا می‌توانم اندازه/نوشتار چارگوش رد کردن آگهی یا دیگر عناصر میانای کاربر را تغییر دهم؟
«کیت‌های توسعه نرم‌افزار IMA» از تغییر چیدمان، اندازه، یا محتوای عناصر «میانای کاربر» پشتیبانی نمی‌کنند. برای جزئیات بیشتر درباره عناصر واسط کاربر، AdsManager.uiElements را ببینید.
آیا کنترل‌های ویدیو بومی با «کیت توسعه نرم‌افزار HTML5» پشتیبانی می‌شوند؟
نه، «کیت توسعه نرم‌افزاری HTML5» از کنترل‌های بومی پشتیبانی نمی‌کند.
در پیاده‌سازی HTML5 خود با پیام «اجرای play در HTMLMediaElement ناموفق بود: API فقط می‌تواند با اشاره کاربر آغاز شود» مواجه می‌شوم. چگونه این مشکل را حل کنم؟
در دستگاه‌های همراه، باید adDisplayContainer.initialize() را درنتیجه کنش کاربر (مثل تک‌ضرب) فراخوانی کنید. اگر این خطا را می‌بینید، احتمالاً آن را در زمینه‌ای که کاربر آغاز نکرده است فراخوانی می‌کنید. توجه داشته باشید که باید نتیجه مستقیم کنش کاربر باشد. برای مثال، اگر به رویداد «تک‌ضرب» با پخش ویدیو پاسخ دهید و سپس از رویداد «پخش» پخش‌کننده ویدیو برای فراخوانی initialize() استفاده کنید، کیت توسعه نرم‌افزار این خطا را برمی‌گرداند. باید initialize() را به‌عنوان نتیجه رویداد تک‌ضرب خودتان فراخوانی کنید.
چگونه تمرکز صفحه‌کلید را در کلیک‌های آگهی مدیریت کنم؟
اگر از کنترل‌های صفحه‌کلید برای پخش‌کننده خود استفاده می‌کنید، ممکن است متوجه شوید که پس‌از کلیک روی adDisplayContainer دیگر کار نمی‌کنند. دلیل این است که وقتی روی آگهی کلیک می‌شود، تمرکز صفحه‌کلید به IMA iframe تغییر می‌کند. برای حفظ تمرکز صفحه‌کلید روی پخش‌کننده محتوا، لطفاً از رویداد CLICK استفاده کنید تا تمرکز صفحه‌کلید را به محفظه موردنظر برگردانید. برای جزئیات بیشتر، تکه‌کد زیر را ببینید: 
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });