Halaman ini diterjemahkan oleh Cloud Translation API.

Grup mediasi

AdMob API memungkinkan Anda membuat, mencantumkan, dan memperbarui grup mediasi, termasuk:

Menentukan penargetan grup mediasi termasuk wilayah, format, platform, dan penargetan IDFA
Menambahkan baris grup mediasi baru ke grup mediasi yang ada
Melihat grup mediasi mana yang merupakan bagian dari eksperimen A/B mediasi dan apa baris grup mediasi milik setiap varian: A atau B

Contoh

Dengan kredensial OAuth 2.0 yang dibuat, Anda siap untuk mulai menggunakan AdMob API. Untuk meminta akses menggunakan OAuth 2.0, aplikasi Anda juga akan membutuhkan 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`	Lihat semua data AdMob. Ini dapat mencakup akun informasi, setelan inventaris dan mediasi, laporan, serta data lainnya. Data ini tidak mencakup data sensitif, seperti pembayaran atau detail kampanye.

Buat

Untuk membuat grup mediasi, Anda harus menentukan penargetan grup mediasi lebih lanjut, termasuk unit iklan yang relevan. Contoh berikut membuat grup mediasi untuk iklan interstisial Android untuk 2 unit iklan. Satu grup mediasi ditambahkan saat pembuatan untuk sumber iklan InMobi. Anda tidak perlu menyertakan jaringan AdMob karena akan ditambahkan pada waktu pembuatan secara {i>default<i}.

Pada cuplikan kode di bawah, ganti pub-XXXXXXXXXXXXXXXX dengan penayang Anda ID.

Kemudian, ganti YYYYYYYYYY dengan 10 digit terakhir unit iklan Anda ID, mematuhi menjadi format:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

Karena ada dua unit iklan dalam contoh ini, YYYYY11111 merujuk pada iklan pertama unit iklan dan WWWWW11111 ke pemetaan unit iklan pertama. YYYYY22222 dan WWWWW22222 merujuk pada pemetaan unit iklan dan unit iklan kedua.

curl (baris perintah)

Ganti WWWWWWWWWW dengan ID pemetaan unit iklan Anda. ID pemetaan unit iklan dapat ditemukan menggunakan accounts.adUnits.adUnitMappings.list .

 curl --http1.0 -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
  "displayName": "Test Mediation Group"
  "targeting": {
    "platform": "ANDROID",
    "format": "INTERSTITIAL"
    "adUnitIds":["ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222"}
  }
  "mediationGroupLines": {
    "-1": {
      "displayName": "test line",
      "adSourceId": "7681903010231960328",
      "cpmMode": "MANUAL",
      "cpmMicros": "150000",
      "state": "ENABLED",
      "adUnitMappings": {
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
      }
  }
}

Daftar

Ganti pub-XXXXXXXXXXXXXXXX dengan penayang Anda ID untuk melihat grup mediasi Anda.

curl (baris perintah)

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.monetization)"

Contoh respons:

{
"mediationGroups": [
  {
    "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ",
    "mediationGroupId": "ZZZZZZZZZZ",
    "displayName": "Test Mediation Group",
    "state": "ENABLED",
    "state": "NOT_RUNNING",
    "targeting": {
      "platform": "iOS",
      "format": "BANNER",
      "targetedRegionCodes": "[CA]",
      "adUnits": ["YYYYY11111", "YYYYY22222"]
    },
    "mediationGroupLines": {
      "11111111111111111": {
        "id": "11111111111111111",
        "displayName": "AdMob Network",
        "adSourceId": "5450213213286189855",
        "cpmMode": "LIVE",
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      },
      "22222222222222222": {
        "id": "22222222222222222",
        "displayName": "test line",
        "adSourceId": "7681903010231960328",
        "cpmMode": "MANUAL",
        "cpmMicros": "150000",
        "adUnitMappings": {
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
        },
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      }
    },
  }]
}

Patch

Berikut adalah daftar kolom masker untuk memperbarui grup mediasi. Pembaruan pada kolom berulang, seperti item dalam daftar, ganti sepenuhnya nilai yang ada dengan nilai baru. Update untuk masing-masing nilai dalam peta dapat dilakukan melalui pengindeksan berdasarkan kunci.

Mask kolom berikut didukung untuk pembaruan grup mediasi:

targeting.adUnitIds
mediationGroupLines[mediationGroupLineId]
mediationGroupLines[mediationGroupLineId].state
mediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]

Untuk memperbarui grup mediasi dengan baris grup mediasi baru, gunakan angka negatif untuk mediationGroupLineId. Untuk memperbarui mediasi yang ada baris grup, referensikan ID baris grup mediasi di update_mask dan payload seperti yang terlihat di bawah ini.

"updateMask" {
    paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}

"mediationGroup" {
  "mediationGroupLines": {
   "123": {
     "id": "123"
     "adUnitMappings": {
      "456": "newAdUnitMappingId"
     }
    }
  }
}

curl (baris perintah)

Contoh di bawah ini menambahkan 3 baris mediasi baru ke grup mediasi yang ada. updateMask menyertakan 3 baris grup mediasi dengan kata kunci negatif yang berbeda nilai sebagai placeholder:

updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]

Anda perlu menerjemahkan karakter khusus karena semua URL harus sesuai dengan sintaks yang ditentukan oleh spesifikasi {i>Uniform Resource Identifier (URI),<i} sehingga updateMask menjadi:

updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D

Untuk menjalankan contoh berikut, ganti pub-XXXXXXXXXXXXXXXX dengan ID penayang dan ZZZZZZZZZZ dengan ID grup mediasi Anda. Mediasi ID grup dapat ditemukan di UI AdMob atau dengan menggunakan accounts.mediationGroups:list .

Ganti YYYYYYYYYY dengan 10 digit terakhir unit iklan Anda ID, dengan mengikuti format:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Ganti WWWWWWWWWW dengan ID pemetaan unit iklan Anda. ID pemetaan unit iklan dapat ditemukan menggunakan accounts.adUnits.adUnitMappings.list .

curl --http1.0 -X PATCH https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ?
updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
"mediationGroupLines": {
  "-1": {
    "displayName": "test line 2",
    "adSourceId": "7681903010231960458",
    "cpmMode": "MANUAL",
    "cpmMicros": "150000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-2": {
    "displayName": "test line 3",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "120000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-3": {
    "displayName": "test line 4",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "130000",
    "state": "ENABLED",
    "adUnitMappings": {
     "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
  }
}
}
EOF

Grup mediasi Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Contoh

Buat

curl (baris perintah)

Daftar

curl (baris perintah)

Patch

curl (baris perintah)

Grup mediasi