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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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