Eksperimen A/B mediasi

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

Berikut 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 sumber iklan
  • 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 berperforma lebih baik. Pengujian ini membagi pengguna aplikasi Anda antara konfigurasi grup mediasi yang ada dan variasinya, berdasarkan persentase (1%, 10%, atau 50%) yang Anda berikan.

curl (command line)

Permintaan menggunakan curl

  1. Muat file rahasia klien dan buat kredensial otorisasi.

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

    Untuk autentikasi dan otorisasi, sebaiknya gunakan oauth2l, alat command line sederhana untuk menggunakan Google OAuth 2.0. Instal oauth2l dan jalankan perintah di bawah, dengan mengganti path_to_credentials_json dengan jalur ke file credentials.json yang Anda download saat mendaftarkan aplikasi cloud Anda. Untuk menjalankan pertama kali, perintah ini akan memandu Anda melalui alur otorisasi OAuth 2.0. Penayangan 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 ID penayang dan ZZZZZZZZZZ dengan ID grup mediasi Anda. ID grup mediasi dapat ditemukan di UI AdMob atau dengan menggunakan metode accounts.mediationGroups:list.

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

    Permintaan berikut membuat eksperimen A/B mediasi dengan varian perlakuan, yang juga dikenal sebagai varian B, berisi satu baris mediasi 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 yang menunjukkan SSSSSSSSSSSSSSSSSSSSSS mewakili ID eksperimen A/B mediasi yang dibuat dan YYYYYYYYYY mewakili 10 digit terakhir ID unit iklan Anda, sesuai dengan 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 sedang berjalan.

    Panggil accounts.mediationGroups:list untuk mendapatkan status eksperimen A/B mediasi untuk grup mediasi tersebut. Lihat panduan grup mediasi untuk mengetahui detail selengkapnya.

    mediationAbExperimentState disetel ke RUNNING untuk eksperimen A/B mediasi yang 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 ID penayang dan ZZZZZZZZZZ dengan ID grup mediasi Anda. ID grup mediasi dapat ditemukan di UI AdMob atau dengan menggunakan metode accounts.mediationGroups:list.

    Untuk menyelesaikan eksperimen, tentukan varian pemenang dalam permintaan:

    • VARIANT_CHOICE_A: Gunakan jalur mediasi dari Varian A dan selesaikan eksperimen. Varian A berisi jalur penayangan asli sebelum pembuatan eksperimen.
    • VARIANT_CHOICE_B: Gunakan formulir lini mediasi Varian B dan selesaikan 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",
}