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

نگاشت واحد تبلیغات تنظیمات پیکربندی شخص ثالثی است که به یک واحد تبلیغاتی 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

1. فایل اسرار مشتری را بارگیری کنید و اعتبارنامه مجوز ایجاد کنید.

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

   برای احراز هویت و مجوز، توصیه می کنیم از oauth2l ، یک ابزار خط فرمان ساده برای کار با Google OAuth 2.0 استفاده کنید. oauth2l را نصب کنید و دستور زیر را اجرا کنید و مسیری به فایل credentials.json که هنگام ثبت برنامه ابری خود دانلود می کنید جایگزین path_to_credentials_json کنید. برای اولین اجرا، دستور شما را در جریان مجوز OAuth 2.0 راهنمایی می کند. اجراهای بعدی توکن را به طور خودکار بازخوانی می کنند.

   oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization
   

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

   با جایگزین کردن 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",
      }
    ]
   }

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

   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"
        }]
     }]
   }

4. یک نقشه واحد تبلیغاتی ایجاد کنید.

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

   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
   

5. فهرست همه نگاشت واحدهای تبلیغاتی

   قطعه شناسه واحد تبلیغات خود را جایگزین YYYYYYYYYY کنید. قطعه شناسه واحد تبلیغات، 10 رقم آخر شناسه واحد تبلیغاتی شما از قالب «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",
        }
      }
   }