این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

نگاشت واحد تبلیغات

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

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

مثال‌ها

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

اطلاعات مربوط به محدوده‌ی OAuth 2.0 به شرح زیر است:

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

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

کرل (خط فرمان)

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

فایل اسرار کلاینت را بارگذاری کنید و اعتبارنامه‌های مجوز را ایجاد کنید.
اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب گوگل که به API AdMob دسترسی دارد، وارد سیستم شده‌اید. برنامه شما مجاز به دسترسی به داده‌ها از طرف هر حسابی که در حال حاضر وارد سیستم شده است، خواهد بود.
برای احراز هویت و مجوزدهی، توصیه می‌کنیم از 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
```

منابع تبلیغاتی را فهرست کنید.

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

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 ، شناسه منبع تبلیغ (ad source ID) آداپتورهای مورد نظر را قرار دهید.

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

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

نگاشت واحد تبلیغات