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

اختيار النظام الأساسي: Android Android iOS

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

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

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

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;
                      }
                    }];
}
AdPlacementsSnippets.m

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

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

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

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

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

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

Swift

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

Objective-C

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

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

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

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

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

Swift

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

Objective-C

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

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

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

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

Swift

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

Objective-C

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

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

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