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

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

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

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

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

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

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

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

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

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

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

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

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

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

Swift

private func loadInterstitial() async {
  do {
    let interstitial = try await InterstitialAd.load(
      with: "adUnitID", request: Request())
    interstitial.placementID = adPlacementID
    print("Placement ID set to: \(interstitial.placementID)")
  } catch {
    print("Failed to load interstitial ad with error: \(error.localizedDescription)")
  }
}

Objective-C

- (void)loadInterstitial {
  GADRequest *request = [GADRequest request];
  request.placementID = adPlacementID;
  [GADInterstitialAd loadWithAdUnitID:"adUnitID"
                              request:request
                    completionHandler:^(GADInterstitialAd *ad, NSError *error) {
                      if (!error) {
                        NSLog(@"Placement ID: %lld", ad.placementID);
                        return;
                      }
                    }];
}

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

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

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

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

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

Swift

private func showBanner(_ bannerView: BannerView) {
  bannerView.placementID = adPlacementID
  view.addSubview(bannerView)
}

Objective-C

- (void)showBannerView:(GADBannerView *)bannerView {
  bannerView.placementID = adPlacementID;
  [self.view addSubview:bannerView];
}

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

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

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

Swift

private func showInterstitial(_ ad: InterstitialAd) {
  ad.placementID = adPlacementID
  ad.present(from: self)
}

Objective-C

- (void)showAd:(GADInterstitialAd *)ad {
  ad.placementID = adPlacementID;
  [ad presentFromRootViewController:self];
}

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

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

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

Swift

private func configureView(_ nativeAdView: NativeAdView, withAd nativeAd: NativeAd) {
  nativeAd.placementID = adPlacementID
  nativeAdView.nativeAd = nativeAd
}

Objective-C

- (void)configureView:(GADNativeAdView *)nativeAdView withNativeAd:(GADNativeAd *)nativeAd {
  nativeAd.placementID = adPlacementID;
  nativeAdView.nativeAd = nativeAd;
}

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

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