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

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

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

במדריך הזה מוסבר איך להגדיר מזהה מיקום מודעה ב-GMA Next-Gen SDK ואיך לצפות בדוח ביצועי מודעות.

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

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

  • משלימים את ההגדרה GMA Next-Gen SDK.
  • מכשיר עם GMA Next-Gen SDK מגרסה ואילך.
  • קבלת גישה לתכונה 'מזהה מיקום'. כדי לבקש גישה, צריך לפנות למנהל החשבון.
  • יוצרים מזהה מיקום לאפליקציה.

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

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

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

אפשר לעדכן את מזהה המיקום לפי הצורך. כשמערכת GMA Next-Gen SDK מתעדת צפייה במודעה, היא משתמשת במזהה מיקום המודעה העדכני ביותר.

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

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

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

Kotlin

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

Java

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

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

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

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

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

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

Kotlin

private fun showBannerView(ad: BannerAd, parentView: ViewGroup, activity: Activity) {
  ad.placementId = PLACEMENT_ID
  parentView.addView(ad.getView(activity))
}

Java

private void showBannerView(BannerAd ad, ViewGroup parentView, Activity activity) {
  ad.setPlacementId(PLACEMENT_ID);
  parentView.addView(ad.getView(activity));
}

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

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

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

Kotlin

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

Java

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

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

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

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

Kotlin

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

Java

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

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

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