Phân đoạn dữ liệu quảng cáo theo vị trí

Chọn nền tảng: Android (thử nghiệm) Mới chọn Android iOS

Để phân đoạn dữ liệu báo cáo hiệu suất quảng cáo, hãy sử dụng tính năng vị trí đặt quảng cáo. Vị trí cho phép bạn phân đoạn dữ liệu lượt hiển thị trong báo cáo mà không cần tạo thêm đơn vị quảng cáo. Để sử dụng tính năng vị trí, bạn cần có mã vị trí. Để biết thông tin chi tiết về vị trí, hãy xem bài viết Giới thiệu về vị trí.

Hướng dẫn này trình bày cách đặt mã vị trí trong GMA Next-Gen SDK và xem báo cáo hiệu suất quảng cáo.

Điều kiện tiên quyết

Trước khi tiếp tục, hãy làm như sau:

  • Hoàn tất việc Thiết lập GMA Next-Gen SDK.
  • Có phiên bản GMA Next-Gen SDK trở lên.
  • Có quyền sử dụng tính năng mã vị trí. Để yêu cầu quyền truy cập, hãy liên hệ với người quản lý tài khoản của bạn.
  • Tạo mã vị trí đặt quảng cáo cho ứng dụng của bạn.

Đặt mã vị trí

Để phân đoạn dữ liệu hiệu suất của quảng cáo, bạn hãy đặt mã vị trí theo một trong những cách sau:

  • Khi tải quảng cáo.
  • Trước khi hiển thị quảng cáo.

Bạn có thể cập nhật mã vị trí nếu cần. Khi GMA Next-Gen SDK ghi lại một lượt hiển thị quảng cáo, hệ thống sẽ sử dụng mã vị trí đặt mới nhất.

Đặt mã vị trí tại thời điểm tải

Phần này trình bày cách đặt mã vị trí tại thời điểm tải. Quy trình này áp dụng cho tất cả các định dạng quảng cáo.

Ví dụ sau đây đặt mã vị trí cho một quảng cáo xen kẽ tại thời điểm tải:

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

Thay thế các giá trị sau:

  • AD_UNIT_ID bằng mã đơn vị quảng cáo của bạn.
  • PLACEMENT_ID bằng mã vị trí của bạn.

Đặt mã vị trí tại thời điểm hiển thị

Phần này trình bày cách đặt mã vị trí tại thời điểm hiển thị cho tất cả các định dạng quảng cáo. Chọn định dạng quảng cáo mà bạn muốn trong các mục sau:

Đối với quảng cáo biểu ngữ, bạn đặt mã vị trí trước khi đặt khung hiển thị quảng cáo vào hệ phân cấp khung hiển thị. Ví dụ sau đây đặt mã vị trí cho quảng cáo biểu ngữ tại thời điểm hiển thị:

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

Quảng cáo toàn màn hình

Đối với các định dạng quảng cáo toàn màn hình, bạn đặt mã vị trí trước khi hiển thị quảng cáo. Quy trình này áp dụng cho các định dạng sau:

Ví dụ sau đây đặt mã vị trí cho một quảng cáo xen kẽ tại thời điểm hiển thị:

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

Quảng cáo gốc

Đối với quảng cáo gốc, bạn đặt mã vị trí sau khi tải một quảng cáo gốc và trước khi đăng ký quảng cáo vào khung hiển thị quảng cáo.

Ví dụ sau đây đặt mã vị trí cho quảng cáo gốc tại thời điểm hiển thị:

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

Xem báo cáo vị trí

Sau khi đặt mã vị trí, bạn sẽ thấy báo cáo về phương diện mã vị trí trong giao diện người dùng AdMob. Để xem báo cáo, hãy làm theo hướng dẫn trong phần Xem vị trí.