แบ่งกลุ่มข้อมูลโฆษณาด้วยตำแหน่งโฆษณา

เลือกแพลตฟอร์ม: Android iOS Android (เวอร์ชันเก่า)

หมายเหตุ: รหัสตำแหน่งโฆษณาอยู่ในการเข้าถึงแบบจำกัด หากต้องการขอสิทธิ์เข้าถึง โปรดติดต่อผู้จัดการบัญชี

หากต้องการแบ่งกลุ่มข้อมูลการรายงานประสิทธิภาพโฆษณา ให้ใช้ฟีเจอร์ตำแหน่งโฆษณา ตำแหน่งโฆษณาช่วยให้คุณแบ่งกลุ่มข้อมูลการแสดงผลในรายงานได้โดยไม่ต้องใช้หน่วยโฆษณาเพิ่มเติม หากต้องการใช้ฟีเจอร์ตำแหน่งโฆษณา คุณต้องมีรหัสตำแหน่งโฆษณา ดูรายละเอียดเกี่ยวกับตำแหน่งโฆษณาได้ที่ เกี่ยวกับตำแหน่งโฆษณา

คู่มือนี้ครอบคลุมการตั้งค่ารหัสตำแหน่งโฆษณาใน GMA Next-Gen SDK และ การดูรายงานประสิทธิภาพโฆษณา

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ ให้ทำดังนี้

• ตั้งค่า GMA Next-Gen SDK ให้เสร็จสมบูรณ์
• มี GMA Next-Gen SDK เวอร์ชัน ขึ้นไป
• เข้าถึงฟีเจอร์รหัสตำแหน่งโฆษณา หากต้องการขอสิทธิ์เข้าถึง โปรดติดต่อผู้จัดการบัญชี
• สร้างรหัสตำแหน่งโฆษณาสำหรับแอป

ตั้งค่ารหัสตำแหน่งโฆษณา

หากต้องการแบ่งกลุ่มข้อมูลประสิทธิภาพโฆษณา ให้ตั้งค่ารหัสตำแหน่งโฆษณาด้วยวิธีใดวิธีหนึ่งต่อไปนี้

• เมื่อโหลดโฆษณา
• ก่อนแสดงโฆษณา

คุณสามารถอัปเดตรหัสตำแหน่งโฆษณาได้ตามต้องการ เมื่อ GMA Next-Gen SDK บันทึก การแสดงผลโฆษณา ระบบจะใช้รหัสตำแหน่งโฆษณาที่ตั้งค่าล่าสุด

ตั้งค่ารหัสตำแหน่งโฆษณาในเวลาโหลด

ส่วนนี้ครอบคลุมการตั้งค่ารหัสตำแหน่งโฆษณาในเวลาโหลด เวิร์กโฟลว์นี้ใช้ได้กับโฆษณาทุกรูปแบบ

ตัวอย่างต่อไปนี้จะตั้งค่ารหัสตำแหน่งโฆษณาสำหรับโฆษณาคั่นระหว่างหน้าในเวลาโหลด

Kotlin

private fun loadInterstitial() {
  val adRequest = AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    adRequest,
    object : AdLoadCallback<InterstitialAd> {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}
AdPlacementsSnippets.kt

Java

private void loadInterstitial() {
  AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      adRequest,
      new AdLoadCallback<>() {
        @Override
        public void onAdLoaded(InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}
AdPlacementsSnippets.java

แทนที่ค่าต่อไปนี้

• AD_UNIT_ID ด้วยรหัสหน่วยโฆษณา
• PLACEMENT_ID ด้วยรหัสตำแหน่งโฆษณา

ตั้งค่ารหัสตำแหน่งโฆษณาในเวลาแสดง

ส่วนนี้ครอบคลุมการตั้งค่ารหัสตำแหน่งโฆษณาในเวลาแสดงสำหรับโฆษณาทุกรูปแบบ เลือกรูปแบบโฆษณาที่ต้องการจากส่วนต่อไปนี้

โฆษณาแบนเนอร์

สำหรับโฆษณาแบนเนอร์ ให้ตั้งค่ารหัสตำแหน่งโฆษณาก่อนวาง มุมมองโฆษณาในลำดับชั้นของมุมมอง ตัวอย่างต่อไปนี้จะตั้งค่ารหัสตำแหน่งโฆษณาสำหรับโฆษณาแบนเนอร์ในเวลาแสดง

Kotlin

private fun showBannerView(ad: BannerAd, parentView: ViewGroup, activity: Activity) {
  ad.placementId = PLACEMENT_ID
  parentView.addView(ad.getView(activity))
}
AdPlacementsSnippets.kt

Java

private void showBannerView(BannerAd ad, ViewGroup parentView, Activity activity) {
  ad.setPlacementId(PLACEMENT_ID);
  parentView.addView(ad.getView(activity));
}
AdPlacementsSnippets.java

โฆษณาแบบเต็มหน้าจอ

สำหรับรูปแบบโฆษณาแบบเต็มหน้าจอ ให้ตั้งค่ารหัสตำแหน่งโฆษณาก่อนแสดงโฆษณา เวิร์กโฟลว์นี้ใช้ได้กับรูปแบบต่อไปนี้

• โฆษณาเปิดแอป: แสดงโฆษณา
• โฆษณาคั่นระหว่างหน้า: แสดงโฆษณา
• โฆษณาที่มีการให้รางวัล: แสดงโฆษณา
• โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล: แสดงโฆษณา

ตัวอย่างต่อไปนี้จะตั้งค่ารหัสตำแหน่งโฆษณาสำหรับโฆษณาคั่นระหว่างหน้าในเวลาแสดง

Kotlin

private fun showAd(activity: Activity, ad: InterstitialAd) {
  ad.placementId = PLACEMENT_ID
  ad.show(activity)
}
AdPlacementsSnippets.kt

Java

private void showAd(Activity activity, InterstitialAd ad) {
  ad.setPlacementId(PLACEMENT_ID);
  ad.show(activity);
}
AdPlacementsSnippets.java

โฆษณาเนทีฟ

สำหรับ โฆษณาเนทีฟ, ให้ตั้งค่ารหัสตำแหน่งโฆษณาหลังจากโหลดโฆษณาเนทีฟและก่อนลงทะเบียน โฆษณาในมุมมองโฆษณา

ตัวอย่างต่อไปนี้จะตั้งค่ารหัสตำแหน่งโฆษณาสำหรับโฆษณาเนทีฟในเวลาแสดง

Kotlin

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd, mediaView: MediaView) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.registerNativeAd(nativeAd, mediaView)
}
AdPlacementsSnippets.kt

Java

private void showNativeAd(NativeAdView nativeAdView, NativeAd nativeAd, MediaView mediaView) {
  nativeAd.setPlacementId(PLACEMENT_ID);
  nativeAdView.registerNativeAd(nativeAd, mediaView);
}
AdPlacementsSnippets.java

ดูรายงานตำแหน่งโฆษณา

หลังจากตั้งค่ารหัสตำแหน่งโฆษณาแล้ว คุณจะเห็นรายงานมิติข้อมูลรหัสตำแหน่งโฆษณา ใน UI ของ AdMob หากต้องการดูรายงาน ให้ทำตามขั้นตอนใน ดูตำแหน่งโฆษณา