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

Để phân khúc 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 khúc dữ liệu lượt hiển thị trong một báo cáo mà không cần 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 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 Thiết lập GMA Next-Gen SDK.
  • GMA Next-Gen SDK phiên bản trở lên.
  • Nhận quyền truy cập vào 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í cho ứng dụng của bạn.

Đặt mã vị trí

Để phân khúc 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, nó sẽ sử dụng mã vị trí được đặt gần đây 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 làm việc này áp dụng cho tất cả định dạng quảng cáo.

Ví dụ sau đây đặt mã vị trí cho 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)
      }
    },
  )
}

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());
        }
      });
}

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ả định dạng quảng cáo. Chọn định dạng quảng cáo bạn muốn trong các phần sau:

Đối với quảng cáo biểu ngữ, bạn hãy đặt mã vị trí trước khi đặt chế độ xem quảng cáo vào hệ phân cấp chế độ xem. 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))
}

Java

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

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 hãy đặt mã vị trí trước khi hiển thị quảng cáo. Quy trình làm việc này áp dụng cho các định dạng sau:

Ví dụ sau đây đặt mã vị trí cho 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)
}

Java

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

Quảng cáo gốc

Đối với quảng cáo gốc, bạn hãy đặt mã vị trí sau khi tải quảng cáo gốc và trước khi đăng ký quảng cáo vào chế độ xem 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)
}

Java

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

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 bài viết Xem vị trí của bạn.