मीडिएशन ग्रुप

AdMob API की मदद से, मीडिएशन ग्रुप बनाए जा सकते हैं, उनकी सूची देखी जा सकती है, और उन्हें अपडेट किया जा सकता है. इनमें ये शामिल हैं:

  • मीडिएशन ग्रुप टारगेटिंग तय करना. इसमें क्षेत्र, फ़ॉर्मैट, प्लैटफ़ॉर्म, और आईडीएफ़ए टारगेटिंग शामिल है
  • किसी मौजूदा मीडिएशन ग्रुप में नई मीडिएशन ग्रुप लाइनें जोड़ना
  • यह देखना कि कौनसे मीडिएशन ग्रुप, मीडिएशन 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 को अपने विज्ञापन यूनिट आईडी के आखिरी 10 अंकों से बदलें. इसके लिए, इस फ़ॉर्मैट का इस्तेमाल करें:

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

आपको खास वर्णों का अनुवाद करना होगा, क्योंकि सभी यूआरएल को यूनिफ़ॉर्म रिसॉर्स आइडेंटिफ़ायर (यूआरआई) के लिए तय किए गए सिंटैक्स के मुताबिक होना चाहिए. इसलिए, 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 तरीके का इस्तेमाल करके ढूंढा जा सकता है.

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