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

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

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

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

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

جافا

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

جافا

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

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

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

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

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

Kotlin

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

جافا

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

جافا

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

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

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