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}/layoutGroups/{ مؤهلاًGroupId} مثال: 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)

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