سؤالات متداول SDK تبلیغات رسانه تعاملی Google

چرا تبلیغات را برای همه فرمت‌ها پس نمی‌گیرم؟
برچسب‌های آگهی آزمایشی به گونه‌ای تنظیم شده‌اند که همیشه برای درخواست‌های معتبر، تبلیغات را برمی‌گردانند. این به منظور تسهیل یکپارچه سازی و آسان تر کردن آزمایش نحوه درخواست و ارائه تبلیغات توسط پخش کننده شما است. با این حال، تبلیغات همیشه در هر قالبی برای سایت، حساب یا واحد تبلیغات شما در دسترس نیستند. اگر ادغام شما برای تگ تست به درستی کار می کند اما برای تگ خود شما کار نمی کند، علت ممکن است یکی از موارد زیر باشد:
  • شما در حال ارائه ویدیوهایی با فرمت پشتیبانی نشده به محیط خود هستید. به عنوان مثال، شما فقط تبلیغات HTML5 را برای iOS یا Android ارائه می دهید.
  • اگر از Ad Manager استفاده می‌کنید، ممکن است شناسه ناشر شما در حال حاضر هیچ تبلیغی برای آن نداشته باشد. همچنین، مطمئن شوید که تبلیغات و خلاقیت‌های مربوطه را در Ad Manager تأیید کرده‌اید.
  • اگر از AdSense استفاده می کنید، معیارهای هدف گذاری برای سایت یا صفحه آزمایشی شما ممکن است تبلیغات فعال نداشته باشد. شایع ترین علت استفاده از وب سایت های خصوصی و بدون خزیدن است.
  • اگر از مدیریت شریک شبکه Ad Exchange استفاده می‌کنید و descriptionURL تنظیم نشده است یا در فهرست مدیریت دامنه‌های تحت مالکیت یا اداره‌شده نیست، تبلیغات به این مورد ارائه نمی‌شوند.
  • آستانه minCPM تعریف شده در Ad Exchange Video را بررسی کنید. CPM نسبتاً بالا ممکن است منجر به نرخ پر شدن بسیار پایین شود. برای تصحیح این، سعی کنید minCPM را حذف کنید یا پارامتر واحد تبلیغات را از درخواست آگهی (یعنی نام شکاف) حذف کنید تا بررسی کنید که آیا این روی نرخ پر شدن تأثیر می گذارد یا خیر.
توضیحات خوب descriptionUrl چگونه به نظر می رسد؟
برای مؤثرتر بودن، محتوای صفحه‌ای که descriptionUrl به آن اشاره می‌کند نباید مجموعه‌ای از کلمات یا عبارات باشد، بلکه باید 1 تا 3 پاراگراف باشد که در واقع محتوا و نقش شما در ارائه آن را توصیف می‌کند. یکی از روش‌هایی که در گذشته موفقیت‌آمیز بوده این است که محتوای صفحه 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 را تماشا کنید. اگر یک تصویر grey.gif 1x1 پیکسل در یک بلوک لنگر HTML برگردانده شود، باید هدف خود را در Ad Manager بررسی کنید.
من می‌خواهم با استفاده از یک برچسب بیش از یک بار آگهی درخواست کنم، اما فقط برای اولین درخواستم آگهی دریافت می‌کنم. چگونه این را درست کنم؟
وقتی بیش از یک بار درخواست تبلیغات می‌کنید، باید به سرور آگهی اطلاع دهید که این درخواست‌ها قانونی هستند و تکراری تصادفی نیستند. SDK با دو تماس سریع API این کار را برای شما انجام می دهد:
  1. در نمونه AdsManager خود destroy() فراخوانی کنید. هنگامی که تماس زیر را با contentComplete() برقرار می‌کنید، از پخش هر پست رول جلوگیری می‌کند. هنگامی که درخواست بعدی خود را ارائه می کنید، یک AdsManager جدید دریافت می کنید.
  2. contentComplete() را در نمونه AdsLoader خود فراخوانی کنید. این SDK را بازنشانی می‌کند تا درخواست آگهی جدید شبیه درخواست قبلی نباشد.
پس از برقراری دو تماس بالا، می‌توانید requestAds() در نمونه AdsLoader خود فراخوانی کنید تا مجموعه دیگری از تبلیغات را برای پخش ویدیوی جدید خود دریافت کنید.
چگونه می‌توانم با استفاده از کیت توسعه نرم‌افزار IMA، آگهی‌های AdSense همپوشانی و شکاف کامل را درخواست کنم؟

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

تبلیغات همپوشانی
  1. در AdsRequest خود، ViewModes خود را روی NORMAL تنظیم کنید.
  2. در تگ تبلیغاتی خود، پارامتر overlay=1 اضافه کنید.
تبلیغات اسلات کامل
  1. در AdsRequest خود، ViewModes خود را روی FULLSCREEN تنظیم کنید.
  2. در تگ تبلیغاتی خود، پارامتر overlay=0 اضافه کنید.
وقتی روی تبلیغ خود کلیک می کنم با خطای "Invalid clickthrough URL" مواجه می شوم. علت چی میتونه باشه؟
رایج‌ترین دلیل این خطا، نشانی اینترنتی کلیکی است که به درستی از آن خارج شده است. اگر این خطا را می‌بینید، بررسی کنید تا مطمئن شوید که URL کلیک شما به درستی در پاسخ VAST شما خارج شده است.
چرا خطای "VAST Document Empty" را می بینم؟
این خطا زمانی رخ می دهد که تگ آگهی یک سند VAST خالی را برمی گرداند که نشان می دهد تبلیغ به درستی ارائه نشده است. با مدیر حساب یا نماینده سرور تبلیغات خود صحبت کنید تا ببینید چرا برچسب تبلیغات شما کار نمی کند.
آیا می توانم اندازه/متن کادر Skip Ad یا سایر عناصر رابط کاربری را تغییر دهم؟
کیت توسعه نرم افزار IMA از تغییر طرح، اندازه یا محتوای عناصر رابط کاربری پشتیبانی نمی کند. برای جزئیات بیشتر در مورد عناصر رابط کاربری، AdsManager.uiElements را ببینید.
آیا کنترل‌های ویدئویی بومی با HTML5 SDK پشتیبانی می‌شوند؟
خیر، HTML5 SDK از کنترل های بومی پشتیبانی نمی کند.
من در اجرای HTML5 خود عبارت "بازی را در "HTMLMediaElement" اجرا نشد: API را فقط می توان با اشاره کاربر شروع کرد." چگونه این را درست کنم؟
در دستگاه های تلفن همراه، باید adDisplayContainer.initialize() در نتیجه یک اقدام کاربر (مانند ضربه زدن) فراخوانی کنید. اگر این خطا را مشاهده می کنید، به احتمال زیاد آن را در یک زمینه غیر آغاز شده توسط کاربر فراخوانی می کنید. توجه داشته باشید که باید نتیجه مستقیم یک اقدام کاربر باشد. به عنوان مثال، اگر با پخش یک ویدیو به یک رویداد «tap» پاسخ دهید و سپس از رویداد «play» پخش‌کننده ویدیو برای فراخوانی initialize() استفاده کنید، SDK این خطا را برمی‌گرداند. شما باید initialize() به عنوان نتیجه خود رویداد tap فراخوانی کنید.
چگونه می توانم با تمرکز صفحه کلید روی کلیک های تبلیغاتی مقابله کنم؟
اگر از کنترل های صفحه کلید برای پخش کننده خود استفاده می کنید، ممکن است متوجه شوید که پس از کلیک روی adDisplayContainer دیگر کار نمی کنند. این به این دلیل است که پس از کلیک روی یک تبلیغ، تمرکز صفحه کلید به iframe IMA تغییر می کند. برای حفظ تمرکز صفحه کلید بر روی پخش کننده محتوا، لطفاً از رویداد CLICK برای انتقال فوکوس صفحه کلید به ظرف مورد نظر استفاده کنید. برای جزئیات بیشتر به قطعه کد زیر مراجعه کنید: 
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });