মধ্যস্থতা গোষ্ঠী

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

তৈরি করুন

একটি মধ্যস্থতা গোষ্ঠী তৈরি করতে, আপনাকে অবশ্যই প্রাসঙ্গিক বিজ্ঞাপন ইউনিট সহ মধ্যস্থতা গোষ্ঠী লক্ষ্য করার তথ্য উল্লেখ করতে হবে। নিম্নলিখিত উদাহরণটি 2টি বিজ্ঞাপন ইউনিটের জন্য Android ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য একটি নতুন মধ্যস্থতা গোষ্ঠী তৈরি করে। একটি মধ্যস্থতা গ্রুপ লাইন InMobi বিজ্ঞাপন উৎসের জন্য তৈরি করার সময় যোগ করা হয়। আপনাকে AdMob নেটওয়ার্ক অন্তর্ভুক্ত করার দরকার নেই কারণ এটি তৈরির সময় ডিফল্টরূপে যোগ করা হবে৷

নীচের কোড স্নিপেটে, pub-XXXXXXXXXXXXXXXX আপনার প্রকাশক আইডি দিয়ে প্রতিস্থাপন করুন।

তারপর, বিন্যাস মেনে YYYYYYYYYY আপনার বিজ্ঞাপন ইউনিট আইডির শেষ 10টি সংখ্যা দিয়ে প্রতিস্থাপন করুন:

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 এবং পেলোড উভয় ক্ষেত্রেই মধ্যস্থতা গ্রুপ লাইন আইডি উল্লেখ করুন যা নীচে দেখানো হয়েছে।

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

আপনাকে বিশেষ অক্ষর অনুবাদ করতে হবে কারণ সমস্ত ইউআরএলকে ইউনিফর্ম রিসোর্স আইডেন্টিফায়ার (ইউআরআই) স্পেসিফিকেশন দ্বারা নির্দিষ্ট সিনট্যাক্স মেনে চলতে হবে, তাই 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 আপনার বিজ্ঞাপন ইউনিট আইডির শেষ 10টি সংখ্যা দিয়ে প্রতিস্থাপন করুন:

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