REST Resource: accounts.mediationGroups

משאב: MediationGroup

מיועד לתיאור קבוצה לבחירת רשת (Mediation) ב-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}/mediationGroups/{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))

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

המפתח הוא המזהה של השורה של הקבוצה לבחירת רשת (Mediation). כדי ליצור, צריך להשתמש בערכים שליליים נפרדים בתור 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

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

string

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

enum (IdfaTargeting)

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

IdfaTargeting

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

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

מדינה

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

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

ExperimentState

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

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

שיטות

create

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

list

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

patch

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