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

رقم التعريف المرئي للوحدة الإعلانية الذي يمكن استخدامه للدمج مع AdMob SDK. هذه خاصية للقراءة فقط. مثال: 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 (RICH_MEDIA) - الوسائط النصية والصورية وغيرها من الوسائط غير المرئية "فيديو" - وسائط الفيديو.

rewardSettings

object (RewardSettings)

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

RewardSettings

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

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

string (int64 format)

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

unitType

string

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

الطُرق

create

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

list

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