گروه های میانجیگری

AdMob API به شما امکان می‌دهد گروه‌های میانجی را ایجاد، فهرست‌بندی و به‌روزرسانی کنید، از جمله:

  • مشخص کردن هدف گذاری گروه میانجی شامل مناطق، قالب، پلتفرم و هدف گذاری IDFA
  • افزودن خطوط گروه میانجی جدید به یک گروه میانجیگری موجود
  • مشاهده اینکه کدام گروه‌های میانجی بخشی از یک آزمایش میانجی‌گری A/B هستند و چه خطوط گروه میانجی متعلق به هر گونه است: A یا B

نمونه ها

با ایجاد اعتبارنامه 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 را ببینید. این ممکن است شامل اطلاعات حساب، تنظیمات موجودی و میانجیگری، گزارش‌ها و سایر داده‌ها باشد. این شامل داده‌های حساس، مانند پرداخت‌ها یا جزئیات کمپین نمی‌شود.

ایجاد کنید

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

در قطعه کد زیر، شناسه ناشر خود را جایگزین pub-XXXXXXXXXXXXXXXX کنید.

سپس، 10 رقم آخر شناسه واحد تبلیغاتی خود را جایگزین YYYYYYYYYY ، با رعایت این قالب کنید:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

همانطور که در این مثال دو واحد تبلیغاتی وجود دارد، YYYYY11111 به اولین واحد تبلیغات و WWWWW11111 به نگاشت اولین واحد تبلیغاتی اشاره دارد. YYYYY22222 و WWWWW22222 به دومین واحد تبلیغات و نگاشت واحد تبلیغات اشاره دارد.

حلقه (خط فرمان)

شناسه نقشه واحد تبلیغاتی خود را جایگزین WWWWWWWWWW کنید. شناسه نگاشت واحد تبلیغات را می توان با استفاده از روش accounts.adUnits.adUnitMappings.list پیدا کرد.

 curl --http1.0 -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
  "displayName": "Test Mediation Group"
  "targeting": {
    "platform": "ANDROID",
    "format": "INTERSTITIAL"
    "adUnitIds":["ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222"}
  }
  "mediationGroupLines": {
    "-1": {
      "displayName": "test line",
      "adSourceId": "7681903010231960328",
      "cpmMode": "MANUAL",
      "cpmMicros": "150000",
      "state": "ENABLED",
      "adUnitMappings": {
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
      }
  }
}

فهرست کنید

برای مشاهده گروه‌های میانجی‌تان، شناسه ناشر خود را جایگزین pub-XXXXXXXXXXXXXXXX کنید.

حلقه (خط فرمان)

نمونه درخواست:

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

نمونه پاسخ:

{
"mediationGroups": [
  {
    "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ",
    "mediationGroupId": "ZZZZZZZZZZ",
    "displayName": "Test Mediation Group",
    "state": "ENABLED",
    "state": "NOT_RUNNING",
    "targeting": {
      "platform": "iOS",
      "format": "BANNER",
      "targetedRegionCodes": "[CA]",
      "adUnits": ["YYYYY11111", "YYYYY22222"]
    },
    "mediationGroupLines": {
      "11111111111111111": {
        "id": "11111111111111111",
        "displayName": "AdMob Network",
        "adSourceId": "5450213213286189855",
        "cpmMode": "LIVE",
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      },
      "22222222222222222": {
        "id": "22222222222222222",
        "displayName": "test line",
        "adSourceId": "7681903010231960328",
        "cpmMode": "MANUAL",
        "cpmMicros": "150000",
        "adUnitMappings": {
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
        },
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      }
    },
  }]
}

پچ

در اینجا لیستی از فیلد ماسک ها برای به روز رسانی یک گروه میانجی آمده است. به روز رسانی فیلدهای مکرر، مانند موارد موجود در یک لیست، به طور کامل مقادیر موجود را با مقادیر جدید جایگزین می کند. به روز رسانی مقادیر فردی در نقشه را می توان از طریق نمایه سازی توسط کلید انجام داد.

فیلد ماسک‌های زیر برای به‌روزرسانی‌های گروه میانجی پشتیبانی می‌شوند:

  • targeting.adUnitIds
  • mediationGroupLines[mediationGroupLineId]
  • mediationGroupLines[mediationGroupLineId].state
  • mediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]

برای به روز رسانی یک گروه میانجی با یک خط گروه میانجی جدید، از یک عدد منفی متمایز برای mediationGroupLineId استفاده کنید. برای به‌روزرسانی خطوط گروه میانجی‌گری موجود، به شناسه خط گروه میانجی‌گری هم در update_mask و هم در payload همانطور که در زیر مشاهده می‌کنید، ارجاع دهید.

"updateMask" {
    paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}

"mediationGroup" {
  "mediationGroupLines": {
   "123": {
     "id": "123"
     "adUnitMappings": {
      "456": "newAdUnitMappingId"
     }
    }
  }
}

حلقه (خط فرمان)

مثال زیر 3 خط میانجی جدید را به یک گروه میانجیگری موجود اضافه می کند. updateMask شامل 3 خط گروه میانجی با مقادیر منفی متمایز به عنوان مکان نگهدار است:

updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]

شما باید کاراکترهای ویژه را ترجمه کنید زیرا همه URL ها باید با نحو مشخص شده توسط مشخصات Uniform Resource Identifier (URI) مطابقت داشته باشند، بنابراین updateMask تبدیل به:

updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D

برای اجرای مثال زیر، pub-XXXXXXXXXXXXXXXX با شناسه ناشر خود و ZZZZZZZZZZ با شناسه گروه میانجی خود جایگزین کنید. شناسه گروه میانجی را می‌توان در رابط کاربری AdMob یا با استفاده از روش accounts.mediationGroups:list پیدا کرد.

10 رقم آخر شناسه واحد تبلیغاتی خود را جایگزین YYYYYYYYYY کنید.

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

شناسه نقشه واحد تبلیغاتی خود را جایگزین WWWWWWWWWW کنید. شناسه نگاشت واحد تبلیغات را می توان با استفاده از روش accounts.adUnits.adUnitMappings.list پیدا کرد.

curl --http1.0 -X PATCH https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ?
updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
"mediationGroupLines": {
  "-1": {
    "displayName": "test line 2",
    "adSourceId": "7681903010231960458",
    "cpmMode": "MANUAL",
    "cpmMicros": "150000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-2": {
    "displayName": "test line 3",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "120000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-3": {
    "displayName": "test line 4",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "130000",
    "state": "ENABLED",
    "adUnitMappings": {
     "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
  }
}
}
EOF