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}/mediaGroups/{mediaGroupId} مثال: accounts/pub-9876543210987654/mediaGroups/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

شكل الإعلان الذي تستهدفه مجموعة التوسط هذه. أمثلة: "إعلان بانر" أو "مدمج مع المحتوى".
adUnitIds[]

string

الوحدات الإعلانية التي تستهدفها مجموعة التوسّط هذه. مثال: "ca-app-pub-1234/8790".
targetedRegionCodes[]

string

رمز البلد/المنطقة بتنسيق يونيكود (CLDR) لأحد المواقع الجغرافية، مثل "US". لا يتم تحديده ما إذا كانت مجموعة التوسّط هذه تستهدف جميع المناطق المتاحة. لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#unicode_region_subtag.
excludedRegionCodes[]

string

رمز البلد/المنطقة بتنسيق يونيكود (CLDR) لأحد المواقع الجغرافية، مثل "US". لا يتم الضبط إذا كانت مجموعة التوسّط هذه لا تستبعد أي منطقة.
idfaTargeting

enum (IdfaTargeting)

يمكن استخدام المَعلمة لاستهداف طلبات الإعلانات استنادًا إلى مدى توفُّر معرّف المعلِنين. وفي حال ضبطها على "الكل"، تنطبق مجموعة التوسّط على جميع طلبات الإعلانات (التي تستخدم معرّف المعلِنين أو بدونه). وفي حال ضبط هذه السياسة على "متوفّر"، ستنطبق مجموعة التوسّط على طلبات الإعلانات التي تستخدم معرّف المعلِنين. وفي حال ضبط هذه السياسة على NOT_FEATURE، تنطبق مجموعة التوسّط على طلبات الإعلانات التي لا تستخدم معرّف المعلِنين (IDFA). لا يلزم تحديده لجهاز ANDROID.

IdfaTargeting

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

عمليات التعداد
IDFA_TARGETING_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
ALL يتم استهداف جميع الأجهزة، بغض النظر عن مدى توفُّر معرّف المعلِنين (IDFA).
AVAILABLE يتم استهداف الأجهزة التي تتوفّر لها معرّف المعلِنين (IDFA) فقط.
NOT_AVAILABLE لا يتم استهداف سوى الأجهزة التي لا تتضمّن معرّف المعلِنين (IDFA).

الحالة

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

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

ExperimentState

حالة تجربة "أ/ب" للتوسّط لمجموعة التوسّط.

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

الطُرق

create

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

list

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

patch

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