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

اختيار النظام الأساسي: Android iOS Android (الإصدار القديم)

ملاحظة: لا يمكن لبعض المستخدِمين استخدام معرّف موضع الإعلان. لطلب إذن الوصول، يُرجى التواصل مع مدير حسابك.

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

يتناول هذا الدليل كيفية ضبط معرّف موضع إعلان في 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)
      }
    },
  )
}
AdPlacementsSnippets.kt

جافا

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

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

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

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

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

إعلانات البانر

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

Kotlin

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

جافا

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

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

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

• الإعلان على شاشة فتح التطبيق: عرض الإعلان
• الإعلان البيني: عرض الإعلان
• الإعلان مقابل مكافأة: عرض الإعلان
• إعلان بيني مقابل مكافأة: عرض الإعلان

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

Kotlin

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

جافا

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

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

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

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

Kotlin

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

جافا

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

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

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