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

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

mediationGroupId

string

המזהה של הקבוצה לבחירת רשת. דוגמה: "0123456789". זהו נכס לקריאה בלבד.

displayName

string

השם שהמשתמש נתן לקבוצה לבחירת רשת. האורך המקסימלי המותר הוא 120 תווים.

targeting

object (MediationGroupTargeting)

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

state

enum (State)

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

mediationGroupLines

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

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

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

אובייקט שמכיל רשימה של "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

פורמט המודעה שמטורגט על ידי הקבוצה הזו לבחירת רשת. דוגמאות: "BANNER",‏ "NATIVE".

adUnitIds[]

string

יחידות המודעות שמטורגטות על ידי הקבוצה הזו לבחירת רשת. לדוגמה: "ca-app-pub-1234/8790".

targetedRegionCodes[]

string

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

excludedRegionCodes[]

string

קוד המדינה או האזור ב-Unicode ‏ (CLDR) של מיקום, למשל US. הערך לא מוגדר אם בקבוצה הזו לבחירת רשת לא מוגדרת החרגה של אזור כלשהו.

idfaTargeting

enum (IdfaTargeting)

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

IdfaTargeting

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

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

מדינה (State)

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

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

ExperimentState

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

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

Methods

create

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

list

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

patch

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