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/PartnershipGroups/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)

يمكن استخدام المَعلمة لاستهداف طلبات الإعلانات استنادًا إلى مدى توفُّر معرّف المعلِنين (IDFA). في حال ضبطها على "الكل"، تنطبق مجموعة التوسّط على جميع طلبات الإعلانات (التي تستخدم معرّف المعلِنين (IDFA) أو لا تستخدمها). في حال ضبطها على AVAILABLE، تنطبق مجموعة التوسّط على طلبات الإعلانات التي تستخدم معرّف المعلِنين. في حال ضبطها على NOT_AVAILABLE، تنطبق مجموعة التوسّط على طلبات الإعلانات التي لا تتضمّن معرّف المعلِنين (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 المحدّد.