मीडिएशन A/B प्रयोग

AdMob API, मीडिएशन A/B एक्सपेरिमेंट बना सकता है. इससे अलग-अलग कॉन्फ़िगरेशन की जांच करके, विज्ञापनों की परफ़ॉर्मेंस को बेहतर बनाया जा सकता है. A/B टेस्ट की मदद से, किसी मीडिएशन ग्रुप के दो अलग-अलग वैरिएंट का आकलन किया जा सकता है. इससे, नतीजों की तुलना एक साथ की जा सकती है और पसंदीदा कॉन्फ़िगरेशन चुना जा सकता है.

यहां उन एक्सपेरिमेंट के उदाहरण दिए गए हैं जिन्हें सेट अप किया जा सकता है:

  • अपने मीडिएशन ग्रुप पर विज्ञापन सोर्स का असर देखने के लिए, उन्हें जोड़ना या हटाना
  • विज्ञापन सोर्स की मैन्युअल ईसीपीएम वैल्यू को बदलकर, किसी अलग वॉटरफ़ॉल के ऑर्डर का इस्तेमाल करना
  • वॉटरफ़ॉल के विज्ञापन सोर्स पर ऑप्टिमाइज़ेशन को चालू या बंद करना
  • किसी विज्ञापन सोर्स के ट्रिगर होने की संख्या बदलना

उदाहरण

किसी मौजूदा मीडिएशन ग्रुप का इस्तेमाल करके उसके अलग-अलग वैरिएंट बनाएं. इससे यह देखा जा सकता है कि कौनसा वैरिएंट, A या B, बेहतर परफ़ॉर्म कर रहा है. टेस्ट, आपके ऐप्लिकेशन के उपयोगकर्ताओं को आपके मौजूदा मीडिएशन ग्रुप के सेटअप और उसके अलग-अलग वैरिएंट के बीच बांट देता है. यह बंटवारा, आपके दिए गए प्रतिशत (1%, 10% या 50%) के आधार पर होता है.

curl (कमांड लाइन)

curl का इस्तेमाल करके किए गए अनुरोध

  1. क्लाइंट सीक्रेट फ़ाइल लोड करें और अनुमति देने के क्रेडेंशियल जनरेट करें.

    पहली बार यह चरण पूरा करने पर, आपसे ब्राउज़र में अनुमति देने के लिए कहा जाएगा. न्योता स्वीकार करने से पहले, पक्का करें कि आपने उस Google खाते से साइन इन किया हो जिसके पास AdMob API का ऐक्सेस है. आपका ऐप्लिकेशन, उस खाते के डेटा को ऐक्सेस कर पाएगा जो फ़िलहाल लॉग इन है.

    हमारा सुझाव है कि पुष्टि करने और अनुमति देने के लिए, oauth2l का इस्तेमाल करें. यह Google OAuth 2.0 के साथ काम करने के लिए, एक आसान कमांड-लाइन टूल है. oauth2l इंस्टॉल करें और नीचे दिया गया निर्देश चलाएं. साथ ही, path_to_credentials_json की जगह credentials.json फ़ाइल का पाथ डालें. यह फ़ाइल, क्लाउड ऐप्लिकेशन रजिस्टर करते समय डाउनलोड की जाती है. पहली बार चलाने पर, यह निर्देश आपको OAuth 2.0 ऑथराइज़ेशन फ़्लो के बारे में जानकारी देता है. इसके बाद, टोकन अपने-आप रीफ़्रेश हो जाता है.

    oauth2l header --json path_to_credentials_json --scope admob.monetization,admob.readonly
    
  2. मीडिएशन का A/B एक्सपेरिमेंट बनाएं.

    pub-XXXXXXXXXXXXXXXX की जगह अपना पब्लिशर आईडी और ZZZZZZZZZZ की जगह अपना मीडिएशन ग्रुप आईडी डालें. मीडिएशन ग्रुप आईडी को AdMob यूज़र इंटरफ़ेस (यूआई) में देखा जा सकता है. इसके अलावा, accounts.mediationGroups:list तरीके का इस्तेमाल करके भी इसे देखा जा सकता है.

    आपको treatmentMediationLines और treatmentTrafficPercentage तय करने होंगे. हालांकि, controlMediationLines पैरंट मीडिएशन ग्रुप से इनहेरिट किए जाते हैं और इन्हें तय करने की ज़रूरत नहीं होती.

    इस अनुरोध से, मीडिएशन A/B एक्सपेरिमेंट बनाया जाता है. इसमें ट्रीटमेंट वैरिएंट, जिसे वैरिएंट B भी कहा जाता है, में AdMob नेटवर्क के लिए एक मीडिएशन लाइन होती है. यह LIVE मोड का इस्तेमाल करती है.

    curl --http1.0 \
    -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ/mediationAbExperiments \
    -H "Content-Type:application/json" \
    -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
    --data @- << EOF
    {
      "displayName":"Mediation A/B Experiment Test Name",
      "treatmentTrafficPercentage": "50",
      "treatmentMediationLines": [{
        "mediationGroupLine": {
          "displayName": "Test mediation group line",
          "adSourceId": "5450213213286189855",
          "cpm_mode": "LIVE"
        }
      }]
    }
    EOF

    यहां दिए गए सैंपल रिस्पॉन्स में, SSSSSSSSSSSSSSSSSSSSSS का मतलब बनाए गए मीडिएशन A/B एक्सपेरिमेंट का आईडी है. वहीं, YYYYYYYYYY का मतलब आपके विज्ञापन यूनिट आईडी के आखिरी 10 अंक हैं. यह फ़ॉर्मैट ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY के मुताबिक है.

    {
      "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ/mediationAbExperiments/SSSSSSSSSSSSSSSSSSSSSS",
      "displayName": "Mediation A/B Experiment Test Name",
      "experimentId": "SSSSSSSSSSSSSSSSSSSSSS",
      "treatmentTrafficPercentage": "50",
      "treatmentMediationLines": [
        {
          "mediationGroupLine": {
            "id": "11111111111111111",
            "displayName": "Test mediation group line",
            "adSourceId": "5450213213286189855",
            "cpmMode": "LIVE",
            "cpmMicros": "10000",
            "adUnitMappings": {
              "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/
              "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/
            },
            "state": "ENABLED"
          }
        }
      ],
      "controlMediationLines": [
        {
          "mediationGroupLine": {
            "id": "22222222222222222",
            "displayName": "AdMob Network (control)",
            "adSourceId": "5450213213286189855",
            "cpmMode": "LIVE",
            "cpmMicros": "10000",
            "adUnitMappings": {
              "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/
              "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/
            },
            "state": "ENABLED"
          }
        }
      ],
      "state": "RUNNING"
    }
  3. पुष्टि करें कि मीडिएशन A/B एक्सपेरिमेंट चल रहा हो.

    उस मीडिएशन ग्रुप के लिए, मीडिएशन A/B एक्सपेरिमेंट का स्टेटस पाने के लिए, कॉल accounts.mediationGroups:list करें. ज़्यादा जानकारी के लिए, मीडिएशन ग्रुप से जुड़ी गाइड देखें.

    चालू मीडिएशन A/B एक्सपेरिमेंट के लिए, mediationAbExperimentState को RUNNING पर सेट किया जाता है. साथ ही, अगर मीडिएशन ग्रुप में कोई एक्सपेरिमेंट नहीं चल रहा है, तो इसे NOT_RUNNING पर सेट किया जाता है.

    अनुरोध का उदाहरण:

     curl --http1.0 \
    -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups \
    -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"
    
  4. मीडिएशन A/B एक्सपेरिमेंट को रोकें और कोई वैरिएंट चुनें.

    pub-XXXXXXXXXXXXXXXX की जगह अपना पब्लिशर आईडी और ZZZZZZZZZZ की जगह अपना मीडिएशन ग्रुप आईडी डालें. मीडिएशन ग्रुप आईडी को AdMob यूज़र इंटरफ़ेस (यूआई) में देखा जा सकता है. इसके अलावा, accounts.mediationGroups:list तरीके का इस्तेमाल करके भी इसे देखा जा सकता है.

    एक्सपेरिमेंट पूरा करने के लिए, अनुरोध में सबसे अच्छा परफ़ॉर्म करने वाले वैरिएंट के बारे में बताएं:

    • VARIANT_CHOICE_A: वैरिएंट A की मीडिएशन लाइनें इस्तेमाल करें और एक्सपेरिमेंट पूरा करें. वैरिएंट A में, एक्सपेरिमेंट बनाने से पहले की ओरिजनल लाइनें शामिल होती हैं.
    • VARIANT_CHOICE_B: वैरिएंट B से मीडिएशन लाइनें इस्तेमाल करें और एक्सपेरिमेंट पूरा करें. वैरिएंट B में, हाल ही में जोड़ी गई विज्ञापन दिखाने वाली लाइनें शामिल हैं.

    अनुरोध का उदाहरण:

     curl --http1.0 \
    -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ/mediationAbExperiments:stop \
    -H "Content-Type:application/json" \
    -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
    --data @- << EOF
    {
    "variantChoice": "VARIANT_CHOICE_A"
    }
    

    जवाब का उदाहरण:

    {
    "experimentId": "SSSSSSSSSSSSSSSSSSSSSS",
    "state": "EXPIRED",
    }