آزمایش میانجی‌گری A/B

«میانای برنامه‌سازی کاربردی AdMob» می‌تواند آزمایش‌های A/B واسطه‌گری ایجاد کند تا با آزمایش پیکربندی‌های مختلف، عملکرد آگهی‌هایتان را بیشینه کند. آزمون آ/ب به شما امکان می‌دهد دو گونه از گروه میانجی‌گری را ارزیابی کنید تا نتایج را در کنار هم مقایسه کنید و پیکربندی ترجیحی را انتخاب کنید.

در اینجا نمونه‌هایی از آزمایش‌هایی که می‌توانید راه‌اندازی کنید آورده شده است:

  • افزودن یا برداشتن منابع آگهی برای دیدن تأثیر آن‌ها بر گروه واسطه‌گری شما
  • استفاده از ترتیب آبشاری متفاوت با تغییر مقدار دستی «هزارظهوربهای مؤثر» منابع آگهی
  • فعال یا غیرفعال کردن بهینه‌سازی در منابع آگهی آبشاری
  • تغییر تعداد دفعاتی که منبع آگهی فراخوانده می‌شود

مثال‌ها

با گروه واسطه‌گری موجودی شروع کنید و گونه‌ای از آن را بسازید تا ببینید کدام گونه، A یا B، عملکرد بهتری دارد. آزمایش کاربران برنامه‌تان را براساس درصدی که ارائه می‌کنید (۱٪، ۱۰٪، یا ۵۰٪) بین تنظیم گروه میانجی‌گری موجود و تنوع تقسیم می‌کند.

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. آزمایش آ/ب میانجی‌گری ایجاد کنید.

    pub-XXXXXXXXXXXXXXXX را با شناسه ناشر و ZZZZZZZZZZ را با شناسه گروه واسطه‌گری جایگزین کنید. شناسه گروه واسطه‌گری را می‌توانید در «واسط کاربر AdMob» یا بااستفاده از روش accounts.mediationGroups:list پیدا کنید.

    باید treatmentMediationLines و treatmentTrafficPercentage را مشخص کنید، اما controlMediationLines از گروه میانجی‌گری والد به ارث می‌رسند و نیازی به مشخص کردن آن‌ها نیست.

    درخواست زیر آزمایش آ/ب واسطه‌گری ایجاد می‌کند که در آن گونه درمان، که به آن گونه 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 نشان‌دهنده ۱۰ رقم آخر شناسه واحد آگهی شما است و از قالب زیر پیروی می‌کند: 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 میانجی‌گری برای آن گروه میانجی‌گری، 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. آزمایش آ/ب واسطه‌گری را متوقف کنید و گونه‌ای را انتخاب کنید.

    pub-XXXXXXXXXXXXXXXX را با شناسه ناشر و ZZZZZZZZZZ را با شناسه گروه واسطه‌گری جایگزین کنید. شناسه گروه واسطه‌گری را می‌توانید در «واسط کاربر AdMob» یا بااستفاده از روش accounts.mediationGroups:list پیدا کنید.

    برای تکمیل آزمایش، متغیر برنده را در درخواست مشخص کنید:

    • VARIANT_CHOICE_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",
    }