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

اسم المرجع لمجموعة التوسّط هذه. التنسيق هو: accounts/{publisherId}/mediationGroups/{mediationGroupId}‎، مثال: accounts/pub-9876543210987654/mediationGroups/0123456789
mediationGroupId

string

رقم تعريف مجموعة التوسّط. مثال: "0123456789". هذه السمة مخصّصة للقراءة فقط.
displayName

string

اسم مجموعة التوسّط الذي قدّمه المستخدم الحد الأقصى للطول المسموح به هو 120 حرفًا.
targeting

object (MediationGroupTargeting)

مجموعة المعايير التي تستهدفها مجموعة التوسّط هذه، مثل الوحدات الإعلانية والمواقع الجغرافية
state

enum (State)

تمثّل هذه السمة حالة مجموعة التوسّط. لن يتم عرض سوى مجموعات التوسّط المفعّلة.
mediationGroupLines

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

خطوط التوسّط المستخدَمة لعرض الإعلانات في مجموعة التوسّط هذه

المفتاح هو رقم تعريف سطر مجموعة التوسّط. لإنشاء سمة، استخدِم قيمًا سلبية مميّزة كعناصر نائبة.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
mediationAbExperimentState

enum (ExperimentState)

النتائج فقط. حالة تجربة أ/ب للتوسّط التي تنتمي إلى مجموعة التوسّط هذه

MediationGroupTargeting

مجموعة المعايير التي تستهدفها مجموعة التوسّط هذه. على سبيل المثال، يمكن لمجموعة التوسّط استهداف أرقام تعريف وحدات إعلانية معيّنة ومنصة وشكل وموقع جغرافي.

تمثيل 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)

يمكن استخدام المَعلمة لاستهداف طلبات الإعلانات استنادًا إلى مدى توفّر معرّف المعلِنين. في حال ضبطها على "الكل"، تنطبق مجموعة التوسّط على جميع طلبات الإعلانات (التي تستخدم معرّف المعلِنين والتي لا تستخدمه). في حال ضبطها على AVAILABLE، تنطبق مجموعة التوسّط على طلبات الإعلانات التي تستخدم معرّف المعلِنين. في حال ضبطها على NOT_AVAILABLE، تنطبق مجموعة التوسّط على طلبات الإعلانات التي لا تستخدم معرّف المعلِنين. لا يلزم تحديدها لجهاز Android.

IdfaTargeting

مدى توفّر معرّف المعلِنين (IDFA) على أجهزة iOS

عمليات التعداد
IDFA_TARGETING_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
ALL يتم استهداف جميع الأجهزة، بغض النظر عمّا إذا كان معرّف المعلِن متاحًا أم لا.
AVAILABLE يتم استهداف الأجهزة التي يتوفّر عليها معرّف المعلنين فقط.
NOT_AVAILABLE يتم استهداف الأجهزة التي لا يتوفّر عليها معرّف المعلنين فقط.

ولاية

أنواع الحالات المتاحة لمجموعة التوسّط

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية لحقل لم يتم ضبطه لا تستخدم هذه السمة.
ENABLED مجموعة التوسّط نشطة ويتم استخدامها لعرض الإعلانات أو جمع الإحصاءات.
DISABLED تم إيقاف مجموعة التوسّط، ولم يعُد يتم عرض الإعلانات أو جمع الإحصاءات. يمكن إعادة تفعيل مجموعات التوسّط غير المفعّلة.

ExperimentState

حالة تجربة A/B لمجموعة التوسّط

عمليات التعداد
EXPERIMENT_STATE_UNSPECIFIED القيمة التلقائية لحقل لم يتم ضبطه لا تستخدم هذه السمة.
RUNNING تحتوي مجموعة التوسّط على تجربة في الحالة RUNNING.
NOT_RUNNING ما مِن تجربة في حالة RUNNING في مجموعة التوسّط.

الطُرق

create

 أنشِئ مجموعة توسّط ضمن حساب AdMob المحدّد.

list

 تعرض هذه الطريقة مجموعات التوسّط ضمن حساب AdMob المحدّد.

patch

 تعديل مجموعة التوسّط المحدّدة ضمن حساب AdMob المحدّد