Eksperimen A/B mediasi

AdMob API dapat membuat eksperimen A/B mediasi untuk memaksimalkan iklan Anda performa aplikasi dengan menguji berbagai konfigurasi. Pengujian A/B memungkinkan Anda mengevaluasi dua variasi grup mediasi untuk membandingkan hasilnya secara berdampingan dan memilih konfigurasi yang disukai.

Berikut adalah contoh eksperimen yang dapat Anda siapkan:

  • Menambahkan atau menghapus sumber iklan untuk melihat dampaknya pada grup mediasi Anda
  • Menggunakan urutan waterfall yang berbeda dengan mengubah nilai eCPM manual iklan sumber
  • Mengaktifkan atau menonaktifkan pengoptimalan pada sumber iklan waterfall
  • Mengubah frekuensi sumber iklan dipanggil

Contoh

Mulai dengan grup mediasi yang ada dan buat variasinya untuk melihat varian mana, A atau B, yang performanya lebih baik. Pengujian ini memisahkan pengguna aplikasi Anda antara penyiapan grup mediasi yang ada dan variasinya, berdasarkan persentase (1%, 10%, atau 50%) yang Anda berikan.

curl (baris perintah)

Permintaan yang menggunakan curl

  1. Muat file secret klien dan buat otorisasi kredensial yang berbeda.

    Saat pertama kali melakukan langkah ini, Anda akan diminta menyetujui prompt otorisasi di browser Anda. Sebelum menerima, pastikan Anda login dengan Akun Google yang memiliki akses ke AdMob API. Nama aplikasi akan diberi otorisasi untuk mengakses data atas nama akun mana pun yang saat ini sedang login.

    Untuk otentikasi dan otorisasi, sebaiknya gunakan oauth2l, alat command line sederhana untuk bekerja dengan Google OAuth 2.0. Instal oauth2l dan jalankan perintah di bawah ini, mengganti path_to_credentials_json dengan jalur ke File credentials.json yang Anda download saat mendaftarkan cloud Anda . Untuk pengoperasian pertama, perintah tersebut akan memandu Anda melalui OAuth 2.0 alur otorisasi. Operasi berikutnya akan memperbarui token secara otomatis.

    oauth2l header --json path_to_credentials_json --scope admob.monetization,admob.readonly

  2. Buat eksperimen A/B mediasi.

    Ganti pub-XXXXXXXXXXXXXXXX dengan penayang Anda ID dan ZZZZZZZZZZ kepada Anda ID grup mediasi. ID grup mediasi dapat ditemukan di UI AdMob atau menggunakan accounts.mediationGroups:list .

    Anda perlu menentukan treatmentMediationLines dan treatmentTrafficPercentage, Namun, controlMediationLines diwarisi dari grup mediasi induk dan tidak harus yang ditentukan.

    Permintaan berikut membuat eksperimen A/B mediasi dengan varian perlakuan, juga dikenal sebagai varian B, berisi satu mediasi baris untuk jaringan AdMob menggunakan Mode 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

    Lihat contoh respons di bawah dengan SSSSSSSSSSSSSSSSSSSSSS yang mewakili ID eksperimen A/B mediasi yang dibuat dan YYYYYYYYYY mewakili 10 digit terakhir unit iklan Anda ID, yang mematuhi format: 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. Pastikan eksperimen A/B mediasi berjalan.

    Telepon accounts.mediationGroups:list untuk mendapatkan status eksperimen A/B mediasi untuk grup mediasi tersebut. Lihat grup mediasi untuk informasi selengkapnya spesifikasi pendukung.

    Tujuan mediationAbExperimentState ditetapkan ke RUNNING untuk eksperimen A/B mediasi aktif dan NOT_RUNNING jika tidak ada eksperimen yang berjalan di grup mediasi.

    Contoh permintaan:

     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. Hentikan eksperimen A/B mediasi dan pilih varian.

    Ganti pub-XXXXXXXXXXXXXXXX dengan penayang Anda ID dan ZZZZZZZZZZ kepada Anda ID grup mediasi. ID grup mediasi dapat ditemukan di UI AdMob atau menggunakan accounts.mediationGroups:list .

    Untuk menyelesaikan eksperimen, tentukan varian yang unggul dalam permintaan:

    • VARIANT_CHOICE_A: Gunakan baris mediasi dari Varian A dan selesaikan melakukan eksperimen. Varian A berisi baris penayangan asli sebelum pembuatan eksperimen.
    • VARIANT_CHOICE_B: Gunakan garis mediasi dari formulir Varian B dan selesaikan melakukan eksperimen. Varian B berisi baris penayangan yang baru ditambahkan.

    Contoh permintaan:

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

    Contoh respons:

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