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

בחירת פלטפורמה: Android (בטא) חדש Android iOS

כדי לפלח את נתוני הדיווח על ביצועי המודעות, אפשר להשתמש בתכונה 'מיקומי מודעות'. מיקומי מודעות מאפשרים לפלח את נתוני החשיפות בדוח בלי להשתמש ביחידות מודעות נוספות. כדי להשתמש בתכונת מיקומי המודעות, צריך מזהה של מיקום מודעה. פרטים על מיקומי מודעות זמינים במאמר מידע על מיקומי מודעות.

במדריך הזה מוסבר איך מגדירים מזהה מיקום מודעה ב-Google Mobile Ads SDK ואיך צופים בדוח ביצועי מודעות.

דרישות מוקדמות

לפני שממשיכים, צריך:

  • משלימים את ההגדרה Google Mobile Ads SDK.
  • להשתמש ב-Google Mobile Ads SDK בגרסה 12.9.0 ואילך.
  • קבלת גישה לתכונה 'מזהה מיקום'. כדי לבקש גישה, צריך לפנות למנהל החשבון.
  • יוצרים מזהה מיקום לאפליקציה.

הגדרת מזהה מיקום

כדי לפלח את נתוני הביצועים של המודעה, צריך להגדיר מזהה מיקום מודעה באחת מהדרכים הבאות:

  • בזמן טעינת המודעה.
  • לפני הצגת המודעה.

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