فراخوانی ()adConfig پیکربندی فعلی بازی را با Ad Placement API ارتباط می دهد. Ad Placement API می‌تواند از این برای تنظیم شیوه بارگیری تبلیغات و فیلتر کردن انواع تبلیغاتی که درخواست می‌کند استفاده کند (مثلاً تبلیغات ویدیویی که به صدا نیاز دارند).
امضای عملکرد:
adConfig({
preloadAdBreaks: 'on|auto', // Ad preloading strategy
sound: 'on|off' // This game has sound
onReady: () => {}, // Called when API has initialised and adBreak() is ready
});
پارامترهای adConfig
| نام | تایپ کنید | شرح |
|---|---|---|
sound | رشته | (اختیاری) آیا بازی در حال پخش صدا است یا خیر. ارزش های: - on (پیش‌فرض)- offاین فراخوانی مشخص می‌کند که آیا بازی شما قابلیت پخش صدا را دارد یا خیر، و اینکه آیا قبل از فراخوانی adBreak() . این به Ad Placement API کمک می کند تا نوع تبلیغ مناسبی را برای بازی شما انتخاب کند.به محض اینکه وضعیت صدای بازی شما تغییر کرد، این تابع را فراخوانی کنید، زیرا ممکن است Ad Placement API مجبور شود خلاقیت های جدیدی را درخواست کند، و این حداکثر زمان را برای انجام این کار به آن می دهد. مقدار پیش فرض صدا روشن است. بنابراین اکثر بازی‌ها زمانی که شروع به اعلام فعال بودن صدا می‌کنند باید با adConfig() تماس بگیرند. |
preloadAdBreaks | رشته | (اختیاری) آیا تبلیغات باید همیشه قبل از اولین تماس با adBreak() از قبل بارگذاری شوند یا خیر. ارزش های:- on- auto (پیش‌فرض)مقدار پیش‌فرض auto تصمیم‌گیری را به API قرار دادن آگهی واگذار می‌کند. preloadAdBreaks را می توان تنها یک بار با adConfig() تنظیم کرد و مقادیر بیشتر ارسال شده به preloadAdBreaks هیچ تاثیری ندارند.تنظیم preloadAdBreaks بعد از اولین تماس با adBreak() هیچ تاثیری ندارد. |
onReady | رشته | (اختیاری) زمانی فراخوانی می شود که API مقداردهی اولیه شده و بارگیری اولیه تبلیغات را تمام کرده باشد (اگر درخواست بارگیری اولیه با استفاده از preloadAdBreaks بالا را داشته باشید). |