انواع قرارگیری

همه فراخوانی‌های adBreak() باید نوع قرارگیری را مشخص کنند. این رشته ای است که وضعیت بازی شما را در زمانی که تبلیغ نمایش داده می شود، توصیف می کند. آیا بازی شما فقط در حال بارگذاری است؟ آیا بازیکن بازی را متوقف کرده است؟ یا آیا آنها به نقطه ای از بازی شما رسیده اند که می توان به آنها جایزه داد؟

نوع دقیقی که استفاده می کنید مهم است. از آنجایی که می تواند مستقیماً بر نوع تجربه تبلیغاتی که نشان داده می شود تأثیر بگذارد (تبلیغ بینابینی در مقابل تبلیغ پاداش). اما همچنین می تواند اثرات کمتر قابل مشاهده دیگری بر رفتار API داشته باشد. مهم است که نوع قرارگیری را به درستی مشخص کنید تا API بتواند به خوبی کار کند.

نوع قرارگیری	شرح
'preroll'	بازی شما رابط کاربری خود را بارگذاری نکرده است و صدا پخش نمی شود. به ازای هر بارگذاری صفحه، تنها می‌توان یک جای «پیش‌پول» در بازی شما وجود داشته باشد. مثال: یک بازیکن روی بازی شما در کاتالوگ بازی کلیک می کند. بوم بازی نمایش داده می شود و قبل از اینکه بازی شما رابط کاربری خود را ارائه کند یا صدا را فعال کند، یک تبلیغ نمایش داده می شود. بازیکن می تواند روی تبلیغ کلیک کند یا آن را رد کند که در آن لحظه بازی شروع می شود.
'start'	بازی شما بارگیری شده است، رابط کاربری قابل مشاهده است و صدا فعال است، بازیکن می تواند با بازی تعامل داشته باشد، اما بازی هنوز شروع نشده است. مثال: شما یک صفحه بارگیری کوتاه "بارگیری..." را نمایش می دهید و یک تبلیغ بینابینی نشان داده می شود. بازیکن می تواند روی تبلیغ کلیک کند یا آن را رد کند تا به بازی ادامه دهد. توجه: یک بازی start preroll کمی بیشتر برای شما انجام می دهد. preroll منتظر می ماند تا API مقداردهی اولیه شود و به طور خودکار تبلیغات را بارگیری می کند. شما باید از preroll به جای start برای اولین تبلیغی که در حین بارگیری بازی شما نشان داده می شود، قبل از رندر شدن رابط کاربری استفاده کنید. هنگامی که رابط کاربری شما رندر شد و بازیکن قادر به تعامل با بازی باشد، start یک مکان بهتر است. start همچنین می‌تواند در هنگام شروع مجدد بازی استفاده شود—در هر بارگذاری صفحه می‌تواند چندین مکان start وجود داشته باشد. اگر قرار دادن start اولین preroll در بازی شما باشد (یعنی از قرار دادن قبل از پخش استفاده نمی کنید)، ممکن است لازم باشد به صورت دستی درخواست کنید که تبلیغات از قبل بارگذاری شوند .
'pause'	بازیکن بازی را متوقف می کند. مثال: بازیکن بازی را متوقف می کند و یک تبلیغ بینابینی نشان داده می شود. تبلیغ تا زمانی که پخش کننده آن را رد نکند روی صفحه باقی می ماند. وقتی آنها برمی گردند، بازی همچنان متوقف است. سپس بازیکن می تواند بازی را از سر بگیرد و به بازی ادامه دهد.
'next'	بازیکن به سطح بعدی حرکت می کند. مثال: بازیکن به تازگی یک سطح را تکمیل کرده است. آنها روی دکمه "سطح بعدی..." ضربه می زنند، یک تبلیغ بینابینی نشان داده می شود. آنها آگهی را مشاهده می کنند، آن را رد می کنند و به مرحله بعدی می روند.
'browse'	بازیکن گزینه های خارج از گیم پلی را بررسی می کند. مثال: بازیکن می خواهد سبک شخصیت خود را تغییر دهد. آنها روی دکمه "گزینه ها..." ضربه می زنند، یک تبلیغ بینابینی نشان داده می شود. آنها آگهی را مشاهده می کنند، آن را رد می کنند و به سمت ویرایشگر کاراکتر می روند.
'reward'	بازیکن در بازی به نقطه ای می رسد که می توان به او جایزه داد. مثال: بازیکن به تازگی مرده است و جانش تمام شده است. در این مرحله اگر تبلیغی را تماشا کنند، به آنها یک عمر پاداش پیشنهاد می شود. Ad Placement API کد شما را فراخوانی می کند تا پاداش را به بازیکن ارائه دهد. آنها روی دکمه پاداش ضربه می زنند و تمام یک تبلیغ ویدیویی را تماشا می کنند. آنها سپس زندگی جدیدی دریافت می کنند و به بازی ادامه می دهند.

توجه : این مجموعه از انواع قرارگیری یک منطقه توسعه فعال است.

اگر مکان‌هایی در بازی خود دارید که به طور طبیعی در یکی از این دسته‌ها قرار نمی‌گیرند، به مدیر حساب Google خود اطلاع دهید و ما به مرور از این بازخورد برای اصلاح این دسته‌ها استفاده خواهیم کرد.