মধ্যস্থতা A/B পরীক্ষা

AdMob API বিভিন্ন কনফিগারেশন পরীক্ষা করে আপনার বিজ্ঞাপনের পারফরম্যান্স সর্বোচ্চ করতে মধ্যস্থতা A/B পরীক্ষা তৈরি করতে পারে। একটি A/B পরীক্ষা আপনাকে একটি মধ্যস্থতা গোষ্ঠীর দুটি বৈচিত্র মূল্যায়ন করতে দেয় ফলাফলগুলি পাশাপাশি তুলনা করতে এবং একটি পছন্দের কনফিগারেশন নির্বাচন করতে।

এখানে আপনি সেট আপ করতে পারেন এমন পরীক্ষার উদাহরণ রয়েছে:

  • আপনার মধ্যস্থতা গোষ্ঠীতে তাদের প্রভাব দেখতে বিজ্ঞাপন উত্সগুলি যোগ করা বা সরানো৷
  • বিজ্ঞাপন উত্সের ম্যানুয়াল eCPM মান পরিবর্তন করে একটি ভিন্ন জলপ্রপাতের ক্রম ব্যবহার করা
  • জলপ্রপাত বিজ্ঞাপন উত্সগুলিতে অপ্টিমাইজেশন সক্ষম বা অক্ষম করা৷
  • একটি বিজ্ঞাপন উৎস কতবার কল করা হয় তা পরিবর্তন করা

উদাহরণ

একটি বিদ্যমান মধ্যস্থতা গোষ্ঠীর সাথে শুরু করুন এবং কোন বৈকল্পিক, A বা B, ভাল পারফর্ম করে তা দেখতে এটির একটি বৈচিত্র তৈরি করুন৷ পরীক্ষাটি আপনার সরবরাহ করা শতাংশের (1%, 10%, বা 50%) উপর ভিত্তি করে আপনার বিদ্যমান মধ্যস্থতা গোষ্ঠী সেটআপ এবং পরিবর্তনের মধ্যে আপনার অ্যাপের ব্যবহারকারীদের বিভক্ত করে।

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

কার্ল ব্যবহার করে অনুরোধ

  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 UI-তে বা accounts.mediationGroups:list পদ্ধতি ব্যবহার করে পাওয়া যেতে পারে।

    আপনাকে treatmentMediationLines এবং treatmentTrafficPercentage নির্দিষ্ট করতে হবে, তবে, controlMediationLines পিতামাতার মধ্যস্থতা গোষ্ঠী থেকে উত্তরাধিকারসূত্রে প্রাপ্ত এবং নির্দিষ্ট করার প্রয়োজন নেই৷

    নিম্নলিখিত অনুরোধটি একটি মধ্যস্থতা A/B পরীক্ষা তৈরি করে যেখানে চিকিত্সা ভেরিয়েন্ট, যা ভেরিয়েন্ট B নামেও পরিচিত, LIVE মোড ব্যবহার করে AdMob নেটওয়ার্কের জন্য একটি একক মধ্যস্থতা লাইন রয়েছে৷

    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 কল করুন। আরও বিস্তারিত জানার জন্য মধ্যস্থতা গোষ্ঠী নির্দেশিকা দেখুন।

    mediationAbExperimentState সক্রিয় মধ্যস্থতা A/B পরীক্ষা-নিরীক্ষার জন্য 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 UI-তে বা accounts.mediationGroups:list পদ্ধতি ব্যবহার করে পাওয়া যেতে পারে।

    পরীক্ষাটি সম্পূর্ণ করতে, অনুরোধে বিজয়ী বৈকল্পিকটি নির্দিষ্ট করুন:

    • VARIANT_CHOICE_A : ভেরিয়েন্ট A থেকে মধ্যস্থতা লাইনগুলি ব্যবহার করুন এবং পরীক্ষাটি সম্পূর্ণ করুন৷ বৈকল্পিক A পরীক্ষা তৈরির আগে মূল পরিবেশন লাইন ধারণ করে।
    • VARIANT_CHOICE_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",
    }