‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

تخصیص‌های واحد آگهی

تخصیص‌های واحد آگهی تنظیمات پیکربندی طرف سوم هستند که به واحد آگهی AdMob تخصیص داده می‌شوند و آن را قادر می‌سازند تا درخواست آگهی را به شبکه آگهی طرف سوم ارسال کند.

هنگام ایجاد گروه میانجی‌گری، نگاشت‌های واحد آگهی به‌عنوان پارامتر برای هر خط گروه میانجی‌گری به‌عنوان تنظیمات واحد آگهی مشخص‌شده برای ایجاد درخواست‌های شبکه آگهی طرف سوم استفاده می‌شود. برخلاف «میانای کاربری AdMob»، نگاشت‌های واحد آگهی باید به‌طور مستقل در خارج از گروه‌های واسطه‌گری و خطوط گروه واسطه‌گری ایجاد شوند. پس‌از ایجاد، می‌توانید همه نگاشت‌های واحد آگهی را فهرست کنید و هنگام ایجاد یا به‌روزرسانی خطوط گروه میانجی‌گری با نگاشت‌های واحد آگهی جدید، از آن‌ها به‌عنوان پارامتر استفاده کنید.

مثال‌ها

با اعتبارنامه‌های OAuth 2.0 ایجادشده، آماده‌اید که استفاده از AdMob API را شروع کنید. برای درخواست دسترسی بااستفاده از OAuth 2.0، برنامه شما به اطلاعات محدوده نیز نیاز دارد.

در اینجا اطلاعات محدوده OAuth 2.0 آمده است:

حوزه	معنی
`https://www.googleapis.com/auth/admob.monetization`	دیدن، ایجاد، و ویرایش تنظیمات درآمدزایی AdMob.
`https://www.googleapis.com/auth/admob.readonly`	دیدن همه داده‌های AdMob. این داده‌ها ممکن است شامل اطلاعات حساب، تنظیمات موجودی و میانجی‌گری، گزارش‌ها، و داده‌های دیگر باشد. این داده‌ها شامل داده‌های حساس مثل پرداخت‌ها یا جزئیات پویش نمی‌شود.

برای ایجاد اولین تخصیص واحد آگهی شروع کنید:

curl (خط فرمان)

درخواست‌های استفاده از curl

فایل رمزهای کارخواه را بار کنید و اعتبارنامه‌های مجوز تولید کنید.

اولین‌باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود پیام‌واره مجوزی را در مرورگرتان بپذیرید. قبل‌از پذیرفتن، مطمئن شوید که با «حساب Google» که به AdMob API دسترسی دارد وارد شده‌اید. برنامه شما مجاز خواهد بود ازطرف هر حسابی که درحال‌حاضر به سیستم وارد شده است به داده‌ها دسترسی داشته باشد.

برای اصالت‌سنجی و صدور مجوز، توصیه می‌کنیم از oauth2l، ابزار خط فرمان ساده‌ای برای کار کردن با Google OAuth 2.0 استفاده کنید. ‫oauth2l را نصب کنید و فرمان زیر را اجرا کنید، و path_to_credentials_json را با مسیر فایل credentials.json که هنگام ثبت کردن برنامه ابری‌تان بارگیری می‌کنید جایگزین کنید. برای اولین اجرا، فرمان شما را در جریان صدور مجوز OAuth 2.0 راهنمایی می‌کند. اجراهای بعدی به‌طور خودکار نشان را بازآوری می‌کنند.
```
oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization
```

فهرست کردن منابع آگهی.

با جایگزین کردن pub-XXXXXXXXXXXXXXXX با شناسه ناشر خود، اطلاعات منبع آگهی AdMob را دریافت کنید. دستورالعمل‌های نحوه پیدا کردن شناسه ناشر را ببینید.

curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

پاسخ نمونه:

{
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

آداپتورها را فهرست کنید.

‫SSSSSSSSSSSSSSSSSSSS را با شناسه منبع آگهی برای تبلیغ‌کننده‌های موردنظر جایگزین کنید.

برای دریافت فهرست آداپتورها، از فرمان زیر استفاده کنید:

curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

پاسخ نمونه برای منبع آگهی «شبکه AdMob» با شناسه 5450213213286189855:

{
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}

تخصیص واحد آگهی ایجاد کنید.

YYYYYYYYYY را با بخش شناسه واحد آگهی‌تان جایگزین کنید. تکه شناسه واحد آگهی ۱۰ رقم آخر شناسه واحد آگهی شما است که از قالب «ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY» پیروی می‌کند. دستورالعمل‌های مربوط به پیدا کردن شناسه واحد آگهی را ببینید.
```
curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF
```

فهرست کردن همه تخصیص‌های واحد آگهی.

YYYYYYYYYY را با بخش شناسه واحد آگهی‌تان جایگزین کنید. تکه شناسه واحد آگهی ۱۰ رقم آخر شناسه واحد آگهی شما از قالب «ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY» است. دستورالعمل‌های مربوط به پیدا کردن شناسه واحد آگهی را ببینید.

 curl --http1.0 -X GET \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

{
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}

تخصیص‌های واحد آگهی با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

مثال‌ها

curl (خط فرمان)

درخواست‌های استفاده از curl

تخصیص‌های واحد آگهی