تقسيم بيانات الإعلانات حسب مواضع الإعلانات

لتقسيم بيانات تقارير أداء الإعلانات، استخدِم ميزة مواضع الإعلانات. تتيح لك مواضع الإعلانات تقسيم بيانات مرّات الظهور في تقرير بدون الحاجة إلى وحدات إعلانية إضافية. لاستخدام ميزة "مواضع الإعلانات"، تحتاج إلى رقم تعريف موضع الإعلان. لمعرفة تفاصيل عن مواضع الإعلانات، يُرجى الاطّلاع على لمحة عن مواضع الإعلانات.

يتناول هذا الدليل كيفية ضبط رقم تعريف موضع الإعلان في Google Mobile Ads SDK (Legacy) وعرض تقرير أداء الإعلان.

المتطلبات الأساسية

قبل المتابعة، عليك تنفيذ ما يلي:

  • أكمِل إعداد "Google Mobile Ads SDK (Legacy)".
  • أن يكون لديك الإصدار 24.5.0 أو إصدار أحدث من Google Mobile Ads SDK (Legacy)
  • الوصول إلى ميزة رقم تعريف المكان. لطلب إذن الوصول، يُرجى التواصل مع مدير حسابك.
  • أنشِئ معرّف موضع إعلان لتطبيقك.

ضبط معرّف موضع الإعلان

لتقسيم بيانات أداء إعلانك، يمكنك ضبط رقم تعريف موضع الإعلان بإحدى الطرق التالية:

  • عند تحميل الإعلان
  • قبل عرض الإعلان

يمكنك تعديل رقم تعريف موضع الإعلان حسب الحاجة. عندما يسجّل Google Mobile Ads SDK (Legacy) مرة ظهور للإعلان، يستخدم أحدث رقم تعريف تم ضبطه للموضع.

ضبط رقم تعريف المكان في مدّة التحميل

يتناول هذا القسم كيفية ضبط رقم تعريف المكان في وقت التحميل. ينطبق سير العمل هذا على جميع أشكال الإعلانات.

يضبط المثال التالي معرّف موضع "إعلان بيني" في وقت التحميل:

Kotlin

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

جافا

public void loadInterstitial(Context context) {
  AdRequest adRequest = new AdRequest.Builder().setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      context,
      "AD_UNIT_ID",
      adRequest,
      new InterstitialAdLoadCallback() {
        @Override
        public void onAdLoaded(@NonNull InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}

استبدِل القيم التالية:

  • AD_UNIT_ID بمعرّف الوحدة الإعلانية.
  • ‫PLACEMENT_ID برقم تعريف المكان.

ضبط رقم تعريف المكان في وقت العرض

يتناول هذا القسم كيفية ضبط معرّف موضع الإعلان في وقت العرض لجميع أشكال الإعلانات. اختَر أشكال الإعلانات المفضّلة لديك من الأقسام التالية:

بالنسبة إلى إعلانات البانر، يمكنك ضبط معرّف موضع الإعلان قبل وضع عرض الإعلان في هيكلية طرق العرض. يضبط المثال التالي معرّف موضع إعلان بانر في وقت العرض:

Kotlin

private fun showBannerView(adView: AdView, parentView: ViewGroup) {
  adView.placementId = PLACEMENT_ID
  parentView.addView(adView)
}

جافا

public void showBannerView(AdView adView, ViewGroup parentView) {
  adView.setPlacementId(PLACEMENT_ID);
  parentView.addView(adView);
}

الإعلانات بملء الشاشة

بالنسبة إلى أشكال الإعلانات بملء الشاشة، يمكنك ضبط رقم تعريف موضع الإعلان قبل عرض الإعلان. ينطبق سير العمل هذا على التنسيقات التالية:

يضبط المثال التالي معرّف موضع الإعلان البيني في وقت العرض:

Kotlin

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

جافا

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

إعلانات مدمجة مع المحتوى

بالنسبة إلى الإعلانات المدمجة مع المحتوى، يمكنك ضبط رقم تعريف الموضع بعد تحميل إعلان مدمج مع المحتوى وقبل تسجيل الإعلان في عرض الإعلان.

يضبط المثال التالي معرّف موضع "إعلان مدمج مع المحتوى" في وقت العرض:

Kotlin

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.setNativeAd(nativeAd)
}

جافا

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

عرض تقرير مواضع الإعلانات

بعد ضبط رقم تعريف موضع الإعلان، سيظهر لك تقرير عن سمة رقم تعريف موضع الإعلان في واجهة مستخدم AdMob. للاطّلاع على التقرير، اتّبِع الخطوات الواردة في مقالة عرض مواضع إعلاناتك.