פילוח נתוני המודעות לפי מיקומי מודעות

בחירת פלטפורמה: 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. כדי לראות את הדוח, פועלים לפי ההוראות במאמר עיון במיקומי המודעות.