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

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

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

במדריך הזה מוסבר איך מגדירים מזהה מיקום מודעה ב-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)
      }
    },
  )
}

AdPlacementsSnippets.kt

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());
        }
      });
}

AdPlacementsSnippets.java

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

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

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

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

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

Kotlin 

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

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

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

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

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

Kotlin 

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

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

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

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

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

Kotlin 

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

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

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

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