REST Resource: accounts.adUnits

المرجع: وحدة إعلانية

يصف وحدة إعلانية في AdMob.

تمثيل JSON
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ],
  "rewardSettings": {
    object (RewardSettings)
  }
}
الحقول
name

string

اسم المورد لهذه الوحدة الإعلانية. التنسيق هو accounts/{publisherId}/adUnits/{ad_unit_id_segment} مثال: accounts/pub-9876543210987654/adUnits/0123456789

adUnitId

string

رقم التعريف الظاهر خارجيًا للوحدة الإعلانية الذي يمكن استخدامه للتكامل مع حزمة تطوير البرامج (SDK) في AdMob. هذه خاصية للقراءة فقط. مثال: ca-app-pub-9876543210987654/0123456789

appId

string

رقم التعريف الظاهر خارجيًا للتطبيق المرتبط به هذه الوحدة الإعلانية. مثال: ca-app-pub-9876543210987654~0123456789

displayName

string

الاسم المعروض للوحدة الإعلانية كما هو موضّح في واجهة مستخدم AdMob، والذي يقدّمه المستخدم. الحد الأقصى للطول المسموح به هو 80 حرفًا.

adFormat

string

شكل الإعلان للوحدة الإعلانية في ما يلي القيم المحتمَلة:

"APP_OPEN" - شكل الإعلان على شاشة فتح التطبيق. "BANNER" - شكل إعلان البانر "BANNER_INTERSTITIAL" - تنسيق قديم يمكن استخدامه كإعلان بانر أو بيني. لم يعُد من الممكن إنشاء هذا الشكل، ولكن يمكن استهدافه من خلال مجموعات التوسّط. "بيني" - إعلان بملء الشاشة. أنواع الإعلانات المتوفرة هي "RICH_MEDIA" و "VIDEO". "NATIVE" - شكل إعلان مدمج مع المحتوى. "مكافأة" - الإعلان الذي يتلقى بعد مشاهدته معاودة الاتصال للتحقق من المشاهدة حتى يمكن منح مكافأة للمستخدم. أنواع الإعلانات المعتمدة هي "RICH_MEDIA" (تفاعلي) وإعلانات الفيديو التي لا يمكن استبعاد الفيديو فيها. "REWARDED_INTERSTITIAL" - شكل الإعلان البيني الذي يضم مكافأة لا تدعم سوى نوع إعلان الفيديو. اطّلع على https://support.google.com/admob/answer/9884467.

adTypes[]

string

نوع وسائط الإعلانات التي تتوافق معها هذه الوحدة الإعلانية القيم المتاحة على النحو التالي:

"RICH_MEDIA" - النصية والصورية والوسائط الأخرى غير الفيديو. "VIDEO" - وسائط الفيديو

rewardSettings

object (RewardSettings)

اختياريّ. إعدادات وحدة إعلانية تضم مكافأة يمكن ضبط هذه القيمة أو إلغاء ضبطها فقط عندما تكون قيمة شكل الإعلان "REWARDED".

RewardSettings

إعدادات وحدة إعلانية تضم مكافأة

تمثيل JSON
{
  "unitAmount": string,
  "unitType": string
}
الحقول
unitAmount

string (int64 format)

مبلغ المكافأة لهذه الوحدة الإعلانية.

unitType

string

عنصر المكافأة لهذه الوحدة الإعلانية.

الطُرق

create

ينشئ وحدة إعلانية ضمن حساب AdMob المحدّد.

list

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