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

اختيار النظام الأساسي: 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. للاطّلاع على التقرير، اتّبِع الخطوات الواردة في مقالة عرض مواضع إعلاناتك.