Pemetaan unit iklan

Pemetaan unit iklan adalah setelan konfigurasi pihak ketiga yang dipetakan ke unit iklan AdMob dan memungkinkannya membuat permintaan iklan ke jaringan iklan pihak ketiga.

Saat membuat grup mediasi, pemetaan unit iklan digunakan sebagai parameter untuk setiap baris grup mediasi sebagai setelan untuk unit iklan yang ditentukan guna membuat permintaan jaringan iklan pihak ketiga. Tidak seperti di UI AdMob, pemetaan unit iklan harus dibuat secara independen di luar grup mediasi dan baris grup mediasi. Setelah pembuatan, Anda dapat mencantumkan semua pemetaan unit iklan dan menggunakannya sebagai parameter saat membuat atau memperbarui baris grup mediasi dengan pemetaan unit iklan baru.

Contoh

Setelah kredensial OAuth 2.0 dibuat, Anda siap untuk mulai menggunakan AdMob API. Untuk meminta akses menggunakan OAuth 2.0, aplikasi Anda juga memerlukan informasi cakupan.

Berikut adalah informasi cakupan OAuth 2.0:

Cakupan Arti
https://www.googleapis.com/auth/admob.monetization Melihat, membuat, dan mengedit setelan monetisasi AdMob Anda.
https://www.googleapis.com/auth/admob.readonly Melihat semua data AdMob. Data ini dapat mencakup informasi akun, setelan inventaris dan mediasi, laporan, serta data lainnya. Data ini tidak mencakup data sensitif, seperti pembayaran atau detail kampanye.

Mulai buat pemetaan unit iklan pertama Anda:

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 diberi otorisasi untuk mengakses data atas nama akun mana pun yang saat ini login.

    Untuk autentikasi dan otorisasi, sebaiknya gunakan oauth2l, alat command line sederhana untuk bekerja dengan Google OAuth 2.0. Instal oauth2l dan jalankan perintah di bawah, ganti path_to_credentials_json dengan jalur ke file credentials.json yang Anda download saat mendaftarkan aplikasi cloud. Untuk peluncuran pertama, perintah ini akan memandu Anda melalui alur otorisasi OAuth 2.0. Pengoperasian berikutnya akan memperbarui token secara otomatis.

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization
    
  2. Mencantumkan sumber iklan.

    Dapatkan informasi sumber iklan AdMob dengan mengganti pub-XXXXXXXXXXXXXXXX dengan ID penayang Anda. Lihat petunjuk tentang cara menemukan ID penayang Anda.

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \
     -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"
    

    Contoh respons:

    {
     "adSources": [
       {
         "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
         "adSourceId": "5450213213286189855",
         "title": "AdMob Network",
       }
     ]
    }
  3. Cantumkan adaptor.

    Ganti SSSSSSSSSSSSSSSSSSSS dengan ID sumber iklan untuk adaptor yang diinginkan.

    Gunakan perintah berikut untuk mendapatkan daftar adaptor:

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
     -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"
    

    Contoh respons untuk sumber iklan Jaringan AdMob dengan ID 5450213213286189855:

    {
     "adapters": [
      {
         "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
         "adapterId": "1",
         "title": "AdMob Network Android SDK",
         "platform": "ANDROID",
         "formats": ["BANNER", "INTERSTITIAL",
           "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
         "adapterConfigMetadata": [{
           "adapterConfigMetadataId": "118",
           "adapterConfigMetadataLabel": "Ad unit ID"
         }]
      },
      {
         "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
         "adapterId": "2",
         "title": "AdMob Network iOS SDK",
         "platform": "ANDROID",
         "formats": ["BANNER", "INTERSTITIAL",
           "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
         "adapterConfigMetadata": [{
           "adapterConfigMetadataId": "119",
           "adapterConfigMetadataLabel": "Ad unit ID"
         }]
      }]
    }
  4. Buat pemetaan unit iklan.

    Ganti YYYYYYYYYY dengan fragmen ID unit iklan Anda. Fragmen ID unit iklan adalah 10 digit terakhir ID unit iklan Anda yang mengikuti format "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Lihat petunjuk untuk menemukan ID unit iklan Anda.

    curl --http1.0 -X POST \
     https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
     -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
     -H "Content-Type: application/json" --data @- << EOF
    {
       "name": "InMobi ad unit mapping",
       "adapterId": "8",
       "adUnitConfigurations": {
         "174": "inMobiAccountId",
         "176": "inMobiPlacementId"
       }
    }
    EOF
    
  5. Menampilkan daftar semua pemetaan unit iklan.

    Ganti YYYYYYYYYY dengan fragmen ID unit iklan Anda. Fragmen ID unit iklan adalah 10 digit terakhir ID unit iklan Anda dari format "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Lihat petunjuk untuk menemukan ID unit iklan Anda.

     curl --http1.0 -X GET \
     https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
     -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"
    
    {
     "adUnitMappingName":
     "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
       {
         "adapterId": "1",
         "state": "ENABLED",
         "adUnitConfigurations": {
           "adUnitMappingConfigurationKey": "adUnitId",
           "adUnitMappingConfigurationValue": "118",
         }
       }
    }