پرسش‌های متداول کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی 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 بررسی کنید.
می‌خواهم بااستفاده از برچسب یکسان بیش‌از یک‌بار آگهی درخواست کنم، اما فقط برای اولین درخواستم آگهی دریافت می‌کنم. چگونه این مشکل را حل کنم؟
وقتی بیش‌از یک‌بار درخواست آگهی می‌کنید، باید به سرور آگهی اطلاع دهید که این درخواست‌ها قانونی هستند و تکرار تصادفی نیستند. کیت توسعه نرم‌افزار این کار را با دو فراخوانی سریع API برای شما انجام می‌دهد:
  1. با destroy() در نمونه AdsManager تماس بگیرید. این کار از پخش هرگونه آگهی پس‌پخش هنگام برقراری تماس زیر با contentComplete() جلوگیری می‌کند. وقتی درخواست بعدی را ارائه می‌کنید، AdsManager جدیدی دریافت می‌کنید.
  2. با contentComplete() در نمونه AdsLoader تماس بگیرید. این کار کیت توسعه نرم‌افزار را بازنشانی می‌کند تا درخواست آگهی جدید شبیه درخواست قبلی نباشد.
پس‌از برقراری دو تماس بالا، می‌توانید با requestAds() در نمونه AdsLoader خود تماس بگیرید تا مجموعه دیگری از آگهی‌ها را برای پخش در ویدیو جدیدتان دریافت کنید.
چگونه بااستفاده از کیت توسعه نرم‌افزار IMA، آگهی‌های رونهاد و جایگاه کامل AdSense را درخواست کنم؟

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

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