মেডিয়েশন গ্রুপ

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 ডেটা দেখুন। এর মধ্যে অ্যাকাউন্ট সংক্রান্ত তথ্য, ইনভেন্টরি ও মধ্যস্থতা সেটিংস, রিপোর্ট ও অন্যান্য ডেটা থাকতে পারে। এর মধ্যে পেমেন্ট ও ক্যাম্পেনের বিবরণের মতো সংবেদনশীল ব্যক্তিগত তথ্য অন্তর্ভুক্ত নয়।

তৈরি করুন

মধ্যস্থতা গ্রুপ তৈরি করতে, আপনাকে অবশ্যই প্রাসঙ্গিক বিজ্ঞাপন ইউনিট সহ মধ্যস্থতা গ্রুপ টার্গেটিং তথ্য উল্লেখ করতে হবে। নিচের উদাহরণে ২টি বিজ্ঞাপন ইউনিটের জন্য Android ইন্টারস্টিশিয়াল বিজ্ঞাপনের একটি নতুন মধ্যস্থতা গ্রুপ তৈরি করা হয়েছে। InMobi বিজ্ঞাপন সোর্সের জন্য তৈরি করার সময় একটি মধ্যস্থতা গ্রুপ লাইন যোগ করা হয়। আপনাকে AdMob নেটওয়ার্ক যোগ করতে হবে না, কারণ এটি তৈরি করার সময় ডিফল্ট হিসেবে যোগ করা হবে।

নিচে দেওয়া কোড স্নিপেটে, pub-XXXXXXXXXXXXXXXX-এর জায়গায় আপনার প্রকাশক আইডি লিখুন।

তারপরে, YYYYYYYYYY-এর জায়গায় আপনার বিজ্ঞাপন ইউনিট আইডির শেষ ১০টি সংখ্যা লিখুন, এটি এই ফর্ম্যাট মেনে চলে:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

এই উদাহরণে যেহেতু দুটি বিজ্ঞাপন ইউনিট আছে, তাই YYYYY11111 প্রথম বিজ্ঞাপন ইউনিট এবং WWWWW11111 প্রথম বিজ্ঞাপন ইউনিটের ম্যাপিংকে বোঝায়। YYYYY22222 এবং WWWWW22222 দ্বিতীয় বিজ্ঞাপন ইউনিট ও বিজ্ঞাপন ইউনিট ম্যাপিংকে বোঝায়।

curl (কমান্ড লাইন)

আপনার বিজ্ঞাপন ইউনিট ম্যাপিং আইডির সাথে 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 (কমান্ড লাইন)

অনুরোধের নমুনা:

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 ও পে-লোডে মধ্যস্থতা গ্রুপ লাইন আইডি রেফারেন্স হিসেবে ব্যবহার করুন।

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

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

curl (কমান্ড লাইন)

নিচের উদাহরণে আগে থেকে থাকা একটি মধ্যস্থতা গ্রুপে ৩টি নতুন মধ্যস্থতা লাইন যোগ করা হয়েছে। updateMask-এ ৩টি মধ্যস্থতা গ্রুপের লাইন রয়েছে যেগুলির আলাদা আলাদা নেগেটিভ ভ্যালু প্লেসহোল্ডার হিসেবে ব্যবহার করা হয়:

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

আপনাকে বিশেষ অক্ষর অনুবাদ করতে হবে কারণ সব URL-কে ইউনিফর্ম রিসোর্স আইডেন্টিফায়ার (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 UI-তে অথবা accounts.mediationGroups:list মেথড ব্যবহার করে মধ্যস্থতা গ্রুপ আইডি খুঁজে পাওয়া যাবে।

এই ফর্ম্যাট মেনে আপনার বিজ্ঞাপন ইউনিট আইডির শেষ ১০টি সংখ্যা দিয়ে 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