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

כדי לפלח את נתוני הדיווח על ביצועי המודעות, אתם יכולים להשתמש בתכונה "מיקומי מודעות". מיקומי מודעות מאפשרים לפלח את נתוני החשיפות בדוח בלי להשתמש ביחידות מודעות נוספות. כדי להשתמש בתכונה "מיקומי מודעות", אתם צריכים מזהה מיקום מודעה. מידע נוסף על מיקומי מודעות זמין במאמר מידע על מיקומי מודעות.

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

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

לפני שממשיכים, צריך לבצע את הפעולות הבאות:

  • מסיימים את ההגדרה של Google Mobile Ads SDK (Legacy).
  • גרסה 24.5.0 ומעלה של Google Mobile Ads SDK (Legacy).
  • מקבלים גישה לתכונה "מזהה מיקום מודעה". כדי לבקש גישה, פנו למנהל החשבון שלכם.
  • יוצרים מזהה מיקום לאפליקציה.

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

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

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

אפשר לעדכן את מזהה מיקום המודעה לפי הצורך. כשמערכת Google Mobile Ads SDK (Legacy) מתעדת חשיפה של מודעה, היא משתמשת במזהה מיקום המודעה האחרון שהוגדר.

הגדרת מזהה מיקום בזמן הטעינה

בקטע הזה מוסבר איך להגדיר מזהה מיקום בזמן הטעינה. תהליך העבודה הזה רלוונטי לכל הפורמטים של המודעות.

בדוגמה הבאה מוגדר מזהה מיקום למודעת מעברון בזמן הטעינה:

Kotlin

private fun loadInterstitial(context: Context) {
  val adRequest = AdRequest.Builder().setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    context,
    "AD_UNIT_ID",
    adRequest,
    object : InterstitialAdLoadCallback() {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}

Java

public void loadInterstitial(Context context) {
  AdRequest adRequest = new AdRequest.Builder().setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      context,
      "AD_UNIT_ID",
      adRequest,
      new InterstitialAdLoadCallback() {
        @Override
        public void onAdLoaded(@NonNull InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}

מחליפים את הערכים הבאים:

  • ‫AD_UNIT_ID במזהה יחידת המודעות.
  • ‫PLACEMENT_ID במזהה מיקום המודעה.

הגדרת מזהה מיקום בזמן ההצגה

בקטע הזה מוסבר איך להגדיר מזהה מיקום בזמן ההצגה לכל פורמטי המודעות. בוחרים את הפורמטים המועדפים של המודעות מהקטעים הבאים:

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

Kotlin

private fun showBannerView(adView: AdView, parentView: ViewGroup) {
  adView.placementId = PLACEMENT_ID
  parentView.addView(adView)
}

Java

public void showBannerView(AdView adView, ViewGroup parentView) {
  adView.setPlacementId(PLACEMENT_ID);
  parentView.addView(adView);
}

מודעות במסך מלא

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

בדוגמה הבאה מוגדר מזהה מיקום למודעת מעברון בזמן ההצגה:

Kotlin

private fun showAd(activity: Activity, ad: InterstitialAd) {
  ad.placementId = PLACEMENT_ID
  ad.show(activity)
}

Java

private void showInterstitial(Activity activity, InterstitialAd ad) {
  ad.setPlacementId(PLACEMENT_ID);
  ad.show(activity);
}

מודעות מותאמות

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

בדוגמה הבאה מוגדר מזהה מיקום למודעה מותאמת בזמן ההצגה:

Kotlin

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.setNativeAd(nativeAd)
}

Java

private void showNativeAd(NativeAdView nativeAdView, NativeAd nativeAd) {
  nativeAd.setPlacementId(PLACEMENT_ID);
  nativeAdView.setNativeAd(nativeAd);
}

הצגת הדוח על מיקומי מודעות

אחרי שמגדירים את מזהה המיקום, אפשר לראות דוח של המאפיין "מזהה מיקום" בממשק המשתמש של AdMob. כדי לראות את הדוח, פועלים לפי ההוראות במאמר עיון במיקומי המודעות.