โฆษณาการแสดงภาพซ้อนภาพ (PIP) จะแสดงในหน้าต่างลอยที่อยู่ด้านบนของเนื้อหาบนหน้าจอ เช่น บทความ ฟีด หรือการเล่นเกม รูปแบบนี้ช่วยให้ผู้ใช้โต้ตอบกับแอปได้ขณะที่โฆษณายังคงปรากฏอยู่ หากต้องการแสดงโฆษณา Display ที่ไม่ใช้พื้นที่ทั้งหน้าจอ ให้เลือกรูปแบบนี้ ดูข้อมูลเพิ่มเติม เกี่ยวกับโฆษณาการแสดงภาพซ้อนภาพ โฆษณา
คู่มือนี้ครอบคลุมการขอและแสดงโฆษณาการแสดงภาพซ้อนภาพในแอป โดยใช้ GMA Next-Gen SDK
ก่อนเริ่มต้น
โปรดทำดังนี้ก่อนดำเนินการต่อ
ติดตั้ง GMA Next-Gen SDK เวอร์ชัน
1.4.0ขึ้นไป
เปิดใช้โฆษณาทดสอบ และใช้รหัสหน่วยโฆษณาทดสอบต่อไปนี้
ca-app-pub-3940256099942544/9657123429
โหลดโฆษณา
หากต้องการโหลดออบเจ็กต์
PictureInPictureAd
ให้สร้างคำขอโฆษณาและเรียกใช้เมธอด load ดังนี้
Kotlin
Java
แทนที่ AD_UNIT_ID ด้วยรหัสหน่วยโฆษณา
แสดงโฆษณา
หากต้องการแสดงโฆษณาการแสดงภาพซ้อนภาพบนหน้าจอ ให้เรียกใช้เมธอด show ตัวอย่างต่อไปนี้จะแสดงโฆษณาในตำแหน่งเริ่มต้นและตั้งค่าขอบเขตการแสดงเป็นหน้าจอ
Kotlin
private fun showPictureInPictureAd(activity: Activity) { // Capture the ad reference saved from the onAdLoaded callback. val ad = pipAd if (ad != null) { val options = PictureInPictureAdOptions.Builder() // Uses the Google Mobile Ads SDK's default screen position. .setPosition(PictureInPictureAdPosition.DEFAULT) // Binds the ad lifecycle to the host screen. .setPresentationScope(PictureInPictureAdPresentationScope.SCREEN) .build() ad.show(activity, options) } else { Log.d(TAG, "No ad to show.") } }
Java
private void showPictureInPictureAd(@NonNull Activity activity) { // Use the ad reference saved from the onAdLoaded callback. if (pipAd != null) { PictureInPictureAdOptions options = new PictureInPictureAdOptions.Builder() // Uses the Google Mobile Ads SDK's default screen position. .setPosition(PictureInPictureAdPosition.DEFAULT) // Binds the ad lifecycle to the host screen. .setPresentationScope(PictureInPictureAdPresentationScope.SCREEN) .build(); pipAd.show(activity, options); } else { Log.d(TAG, "No ad to show."); } }
กำหนดตำแหน่ง
โดยค่าเริ่มต้น GMA Next-Gen SDK จะแสดงโฆษณาการแสดงภาพซ้อนภาพที่มุมขวาล่าง ของหน้าจอเมื่อแสดงครั้งแรก หรือในตำแหน่งสุดท้ายที่ทราบหาก เคยแสดงก่อนหน้านี้ หากต้องการปรับแต่งตำแหน่งที่โฆษณาปรากฏ ให้ระบุตำแหน่งเมื่อแสดงโฆษณา ตัวอย่างต่อไปนี้จะตั้งค่าตำแหน่งไว้ด้านบนของเนื้อหาที่มุมซ้ายบนของหน้าจอ
Kotlin
private fun createTopLeftPositionOptions(): PictureInPictureAdOptions { return PictureInPictureAdOptions.Builder() // Sets the ad position to the top-left corner of the screen. .setPosition(PictureInPictureAdPosition.TOP_LEFT) .build() }
Java
private PictureInPictureAdOptions createTopLeftPositionOptions() { return new PictureInPictureAdOptions.Builder() // Sets the ad position to the top-left corner of the screen. .setPosition(PictureInPictureAdPosition.TOP_LEFT) .build(); }
ดูตำแหน่งทั้งหมดที่ใช้ได้ที่
PictureInPictureAdPosition
ตั้งค่าขอบเขตการแสดง
โดยค่าเริ่มต้น GMA Next-Gen SDK จะผูกโฆษณาการแสดงภาพซ้อนภาพกับหน้าจอโฮสต์ปัจจุบัน GMA Next-Gen SDK จะปิดโฆษณาเมื่อลำดับชั้นการแสดงผลของหน้าจอโฮสต์ไม่อยู่ในหน่วยความจำอีกต่อไป หากต้องการให้โฆษณายังคงปรากฏอยู่หลังจากนำหน้าจอโฮสต์ออกจากหน่วยความจำแล้ว ให้ตั้งค่าขอบเขตการแสดงเป็นแอปพลิเคชัน
Kotlin
private fun createApplicationScopedOptions(): PictureInPictureAdOptions { return PictureInPictureAdOptions.Builder() // Keeps the ad visible beyond the host screen's lifecycle. .setPresentationScope(PictureInPictureAdPresentationScope.APPLICATION) .build() }
Java
private PictureInPictureAdOptions createApplicationScopedOptions() { return new PictureInPictureAdOptions.Builder() // Keeps the ad visible beyond the host screen's lifecycle. .setPresentationScope(PictureInPictureAdPresentationScope.APPLICATION) .build(); }
ดูข้อมูลเพิ่มเติมได้ที่ให้โฆษณายังคงปรากฏอยู่บน หน้าจอต่างๆ
รอเหตุการณ์โฆษณา
หากต้องการจัดการเหตุการณ์วงจรการทำงานของโฆษณาการแสดงภาพซ้อนภาพ ให้ลงทะเบียนเพื่อรับเหตุการณ์โฆษณาก่อนแสดงโฆษณา รายงานเหตุการณ์เหล่านี้จะรายงานการโต้ตอบกับโฆษณา เช่น การคลิกและการแสดงโฆษณา นอกจากนี้ เหตุการณ์เหล่านี้ยังรายงานเหตุการณ์เฉพาะของการแสดงภาพซ้อนภาพ เช่น เมื่อโฆษณาแสดงหรือซ่อน
Kotlin
private fun setAdEventCallback(pipAd: PictureInPictureAd) { pipAd.adEventCallback = object : PictureInPictureAdEventCallback { override fun onAdShown() { Log.d(TAG, "Picture-in-Picture ad shown.") } override fun onAdHidden() { Log.d(TAG, "Picture-in-Picture ad hidden.") } override fun onAdImpression() { Log.d(TAG, "Picture-in-Picture ad recorded an impression.") } override fun onAdClicked() { Log.d(TAG, "Picture-in-Picture ad recorded a click.") } override fun onAdShowedFullScreenContent() { Log.d(TAG, "Picture-in-Picture ad showed full screen content.") } override fun onAdDismissedFullScreenContent() { Log.d(TAG, "Picture-in-Picture ad dismissed full screen content.") } override fun onAdFailedToShowFullScreenContent( fullScreenContentError: FullScreenContentError ) { Log.w( TAG, "Picture-in-Picture ad failed to show full screen content: $fullScreenContentError", ) } override fun onAdPaid(value: AdValue) { Log.d(TAG, "Picture-in-Picture ad paid: ${value.valueMicros} ${value.currencyCode}") } } }
Java
private void setAdEventCallback(@NonNull PictureInPictureAd pipAd) { pipAd.setAdEventCallback( new PictureInPictureAdEventCallback() { @Override public void onAdShown() { Log.d(TAG, "Picture-in-Picture ad shown."); } @Override public void onAdHidden() { Log.d(TAG, "Picture-in-Picture ad hidden."); } @Override public void onAdImpression() { Log.d(TAG, "Picture-in-Picture ad recorded an impression."); } @Override public void onAdClicked() { Log.d(TAG, "Picture-in-Picture ad recorded a click."); } @Override public void onAdShowedFullScreenContent() { Log.d(TAG, "Picture-in-Picture ad showed full screen content."); } @Override public void onAdDismissedFullScreenContent() { Log.d(TAG, "Picture-in-Picture ad dismissed full screen content."); } @Override public void onAdFailedToShowFullScreenContent( @NonNull FullScreenContentError fullScreenContentError) { Log.w( TAG, "Picture-in-Picture ad failed to show full screen content: " + fullScreenContentError); } @Override public void onAdPaid(@NonNull AdValue value) { Log.d( TAG, "Picture-in-Picture ad paid: " + value.getValueMicros() + " " + value.getCurrencyCode()); } }); }
ซ่อนโฆษณา
หากต้องการนำโฆษณาแบบลอยออกจากหน้าจอ ให้เรียกใช้เมธอด hide เมธอดนี้จะเรียกใช้เหตุการณ์ ad hidden
Kotlin
private fun hidePictureInPictureAd() { // Capture the ad reference saved from the onAdLoaded callback. val ad = pipAd if (ad != null) { ad.hide() } else { Log.d(TAG, "No ad to hide.") } }
Java
private void hidePictureInPictureAd() { // Use the ad reference saved from the onAdLoaded callback. if (pipAd != null) { pipAd.hide(); } else { Log.d(TAG, "No ad to hide."); } }
ล้างข้อมูลทรัพยากรโฆษณา
หากต้องการหลีกเลี่ยงหน่วยความจำรั่วไหล ให้ยกเลิกการอ้างอิงออบเจ็กต์โฆษณาเมื่อแอปใช้โฆษณาเสร็จแล้ว เช่น เมื่อแอปไม่แสดงหรือโต้ตอบกับโฆษณาอีก สำหรับโฆษณาที่มีขอบเขตเป็นหน้าจอ ให้ยกเลิกการอ้างอิงเมื่อแอปนำหน้าจอโฮสต์ออกจากหน่วยความจำ สำหรับโฆษณาที่มีขอบเขตเป็นแอป ให้เก็บการอ้างอิงโฆษณาไว้ขณะที่ผู้ใช้ไปยังหน้าจอต่างๆ และยกเลิกการอ้างอิงเมื่อผู้ใช้ปิดโฆษณา
Kotlin
private fun cleanUpPictureInPictureAd() { pipAd?.destroy() pipAd = null }
Java
private void cleanUpPictureInPictureAd() { // Use the ad reference saved from the onAdLoaded callback. if (pipAd != null) { pipAd.destroy(); pipAd = null; } }
ให้โฆษณายังคงปรากฏอยู่บนหน้าจอต่างๆ
เมื่อตั้งค่าขอบเขตการแสดงเป็นแอปพลิเคชัน โฆษณาการแสดงภาพซ้อนภาพจะยังคงปรากฏอยู่แม้ว่าแอปจะนำหน้าจอโฮสต์ออกจากหน่วยความจำแล้วก็ตาม หากต้องการโต้ตอบกับโฆษณาหรือปิดโฆษณาเมื่อผู้ใช้ออกจากหน้าจอโฮสต์ แอปจะต้องเก็บสิทธิ์เข้าถึงโฆษณาการแสดงภาพซ้อนภาพไว้ เราขอแนะนำให้เก็บโฆษณาไว้ในตัวจัดการสถานะที่แชร์หรือซิงเกิลตันระดับแอปแทนที่จะเก็บไว้ในตัวแปรอินสแตนซ์ของหน้าจอเดียว
ดูตัวอย่างวิธีให้โฆษณายังคงปรากฏอยู่บนหน้าจอต่างๆ ได้ที่แอปตัวอย่างต่อไปนี้