מטמיעים פילוח של מפתח/ערך

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

הערה: פילוח לפי צמד מפתח/ערך הוא בתקופת גישה מוגבלת. צריך לפנות לנציג של חשבון Google כדי לבקש גישה.

פילוח לפי מפתח/ערך מאפשר לכם להגדיר טירגוט מותאם אישית לפילוח משתמשים באמצעות בקשה להצגת מודעה. לפרטים על פילוח לפי מפתח/ערך, כמו הוספה של צמד מפתח/ערך בממשק המשתמש של AdMob, אפשר לעיין במאמר הוספת פילוח לפי מפתח/ערך לקבוצה לבחירת רשת (Mediation).

בדף הזה מוסבר איך להטמיע פילוח לפי זוגות מפתח/ערך כשמגדירים בקשה להצגת מודעות באמצעות Google Mobile Ads Android SDK.

לפני שמתחילים

כדי להגדיר פילוח לפי מפתח/ערך באפליקציה, קודם צריך להוסיף פילוח לפי מפתח/ערך לקבוצה לבחירת רשת (Mediation).

צירוף צמדים של מפתח/ערך לבקשה להצגת מודעה

אחרי שמגדירים את הצמדים המותאמים אישית של מפתח/ערך בממשק המשתמש של AdMob, צריך לצרף אותם לבקשה להצגת מודעה באפליקציה.

כדי לצרף את צמדי המפתח/ערך לבקשה להצגת מודעה, קוראים לפונקציה putCustomTargeting() עם המפתח והערך.

בדוגמה הבאה, המשתמשים מפולחים לפי משך השימוש באפליקציה:

Kotlin

val daysInApp = 1
val request = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("USER_DURATION", if (daysInApp < 3) "NEW" else "MATURE")
  .build()

Java

int daysInApp = 1;
AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
    .putCustomTargeting("USER_DURATION", (daysInApp < 3) ? "NEW" : "MATURE")
    .build();

בדיקת ההגדרה של פילוח לפי מפתח/ערך

כדי לבדוק את ההטמעה של צמדי מפתח/ערך בהתאמה אישית, שולחים בקשה להצגת מודעה ובודקים את האובייקט response info. מוודאים שהערך בשדה mediation_group_name תואם לשם קבוצת הגישור שציפיתם לו.

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

{
  "Response ID": "r6_DZtitA8Gi2OMPyKeksAI",
  ...
  "Response Extras": {
    "mediation_group_name": "Mediation group for new users"
  }
}