REST Resource: accounts.mediationGroups

משאב: MediationGroup

מתאר קבוצה לבחירת רשת ב-AdMob.

ייצוג JSON 
{
  "name": string,
  "mediationGroupId": string,
  "displayName": string,
  "targeting": {
    object (MediationGroupTargeting)
  },
  "state": enum (State),
  "mediationGroupLines": {
    string: {
      object (MediationGroupLine)
    },
    ...
  },
  "mediationAbExperimentState": enum (ExperimentState)
}
שדות
name

string

שם המשאב של הקבוצה הזו לבחירת רשת (Mediation). הפורמט הוא: accounts/{publisherId}/mediateGroups/{MediationGroupId} דוגמה: accounts/pub-9876543210987654/MediationGroups/0123456789
mediationGroupId

string

המזהה של הקבוצה לבחירת רשת. דוגמה: "0123456789". זהו מאפיין לקריאה בלבד.
displayName

string

השם שסופק על ידי משתמש לקבוצה לבחירת רשת. האורך המקסימלי המותר הוא 120 תווים.
targeting

object (MediationGroupTargeting)

קבוצת קריטריונים שהקבוצה לבחירת רשת (Mediation) מטרגטת, כמו יחידות מודעות ומיקומים גיאוגרפיים.
state

enum (State)

הסטטוס של הקבוצה לבחירת רשת. יוצגו רק קבוצות שהופעלו לבחירת רשת.
mediationGroupLines

map (key: string, value: object (MediationGroupLine))

השורות בתהליך בחירת הרשת המשמשות להצגה בקבוצה זו לבחירת רשת.

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

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }
mediationAbExperimentState

enum (ExperimentState)

פלט בלבד. המצב של ניסוי A/B של תהליך בחירת הרשת ששייך לקבוצה הזו לבחירת רשת.

MediationGroupTargeting

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

ייצוג JSON 
{
  "platform": string,
  "format": string,
  "adUnitIds": [
    string
  ],
  "targetedRegionCodes": [
    string
  ],
  "excludedRegionCodes": [
    string
  ],
  "idfaTargeting": enum (IdfaTargeting)
}
שדות
platform

string

מתארת את הפלטפורמה של האפליקציה. דוגמאות: "iOS", "Android".
format

string

פורמט מודעה שהקבוצה הזו לבחירת רשת (Mediation) מטרגטת. דוגמאות: "מודעת באנר", "מותאמת".
adUnitIds[]

string

יחידות מודעות שהקבוצה לבחירת רשת (Mediation) מטורגטת אליהן. לדוגמה: "ca-app-pub-1234/8790".
targetedRegionCodes[]

string

קוד המדינה או האזור (CLDR) של מיקום ב-Unicode, למשל "US". צריך לבטל את ההגדרה אם הקבוצה הזו לבחירת רשת (Mediation) מטרגטת לכל האזורים הזמינים. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#unicode_region_subtag.
excludedRegionCodes[]

string

קוד המדינה או האזור (CLDR) של מיקום ב-Unicode, למשל "US". אם הקבוצה הזו לבחירת רשת (Mediation) לא מחריגה אף אזור, צריך לבטל את ההגדרה.
idfaTargeting

enum (IdfaTargeting)

אפשר להשתמש בפרמטר כדי לטרגט בקשות להצגת מודעות על סמך זמינות ה-IDFA. אם המדיניות מוגדרת כ-ALL, הקבוצה לבחירת רשת (Mediation) תחול על כל הבקשות להצגת מודעות (עם או בלי IDFA). אם המדיניות מוגדרת לערך AVAILABLE, הקבוצה לבחירת הרשת (Mediation) תחול על בקשות להצגת מודעות עם IDFA. אם הערך שמוגדר הוא NOT_AVAILABLE, הקבוצה לבחירת רשת (Mediation) תחול על בקשות להצגת מודעות בלי IDFA. אין צורך לציין את המיקום למכשיר Android.

IdfaTargeting

הזמינות של IDFA במכשירי iOS.

טיפוסים בני מנייה (enums)
IDFA_TARGETING_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
ALL כל המכשירים מטורגטים, בלי קשר לזמינות ה-IDFA.
AVAILABLE מתבצע טירגוט רק למכשירים עם זמינות IDFA.
NOT_AVAILABLE מתבצע טירגוט רק למכשירים ללא זמינות IDFA.

ארץ

סוגי הסטטוסים הזמינים לקבוצה לבחירת רשת (Mediation).

טיפוסים בני מנייה (enums)
STATE_UNSPECIFIED ערך ברירת המחדל לשדה שלא הוגדר. אין להשתמש בו.
ENABLED הקבוצה לבחירת רשת פעילה ומשמשת להצגת מודעות או לאיסוף נתונים סטטיסטיים.
DISABLED הקבוצה לבחירת רשת הושבתה והיא לא מציגה יותר מודעות או אוספת נתונים סטטיסטיים. אפשר להפעיל מחדש קבוצות לבחירת רשת שהושבתו.

ExperimentState

מצב ניסוי ה-A/B של תהליך בחירת הרשת (Mediation) עבור הקבוצה לבחירת רשת.

טיפוסים בני מנייה (enums)
EXPERIMENT_STATE_UNSPECIFIED ערך ברירת המחדל לשדה שלא הוגדר. אין להשתמש בו.
RUNNING בקבוצה לבחירת רשת יש ניסוי במצב 'פועל'.
NOT_RUNNING אין ניסוי במצב 'פועל' בקבוצה לבחירת רשת.

שיטות

create

 יוצרים קבוצה לבחירת רשת בחשבון AdMob הספציפי.

list

 הצגת רשימה של קבוצות לבחירת רשת (Mediation) בחשבון AdMob שצוין.

patch

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