پرسش‌های متداول کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی 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، ViewModes را روی NORMAL تنظیم کنید.
  2. در برچسب آگهی‌تان، پارامتر overlay=1 را اضافه کنید.
آگهی‌های تمام‌جایگاه
  1. در AdsRequest، «حالت‌های نمایش» را روی FULLSCREEN تنظیم کنید.
  2. در برچسب آگهی‌تان، پارامتر overlay=0 را اضافه کنید.
وقتی روی آگهی‌ام کلیک می‌کنم، خطای «نشانی وب کلیک‌گذر نامعتبر» دریافت می‌کنم. علت چه می‌تواند باشد؟
رایج‌ترین دلیل این خطا نشانی وب کلیک‌گذری است که به‌درستی گریز داده نشده است. اگر این خطا را می‌بینید، مطمئن شوید که نشانی وب ازطریق کلیک شما به‌درستی در پاسخ VAST شما گریز داده شده است.
در کیت‌های توسعه نرم‌افزار Android و iOS، آیا راهی برای کلیک‌کردنی کردن کل آگهی ویدیویی وجود دارد؟
تا جایی که به ردیابی کلیک کل ویدیو مربوط می‌شود، تجربه استاندارد بیننده برای ویدیو تلفن همراه که پدیدار شده است این است که تک‌ضرب زدن روی ویدیو یا آن را موقتاً متوقف می‌کند یا کنترل‌های پخش‌کننده را نشان می‌دهد. برای جلوگیری از کلیک ناخواسته کاربران روی آگهی‌ها وقتی واقعاً فقط می‌خواهند به کنترل‌های پخش‌کننده دسترسی داشته باشند، IMA از دکمه بیشتر بدانید استفاده می‌کند تا به کاربران امکان دهد روی آگهی کلیک کنند و درباره محصول تبلیغ‌شده بیشتر بدانند.
چرا خطای «VAST Document Empty» را می‌بینم؟
این خطا زمانی رخ می‌دهد که برچسب آگهی یک سند VAST خالی را برمی‌گرداند، که نشان می‌دهد آگهی به‌درستی ارائه نشده است. با مدیر حسابتان یا نماینده سرور آگهی صحبت کنید تا ببینید چرا برچسب آگهی‌تان کار نمی‌کند.
آیا می‌توانم اندازه/نوشتار چارگوش رد کردن آگهی یا دیگر عناصر واسط کاربر را تغییر دهم؟
کیت‌های توسعه نرم‌افزار IMA از تغییر چیدمان، اندازه، یا محتوای عناصر میانای کاربر پشتیبانی نمی‌کنند. برای جزئیات بیشتر درباره عناصر واسط کاربر، AdsManager.uiElements را ببینید.
چرا نمی‌توانم میزان صدای آگهی را در iOS تغییر دهم؟
‫iOS به شما اجازه نمی‌دهد صدا را به‌صورت برنامه‌ریزی‌شده تنظیم کنید. اگر از «کیت توسعه نرم‌افزار HTML5» استفاده می‌کنید، adsManager.setVolume() تأثیری ندارد. به همین دلیل، کیت توسعه نرم‌افزار iOS تنظیم‌کننده میزان صدا را در IMAAdsManager ارائه نمی‌دهد.
آیا می‌توانم از چند رشته برای مقداردهی اولیه و دستکاری واسط کاربر استفاده کنم؟
همه مقداردهی‌های اولیه واسط کاربر باید در رشته اصلی انجام شود. پس‌از راه‌اندازی اولیه، می‌توانید پیاده‌سازی پخش آگهی پس‌زمینه‌ای را انتخاب کنید.