Grup mediasi

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

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

Contoh

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

Berikut 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. Hal ini dapat mencakup informasi akun, setelan inventaris dan mediasi, laporan, dan data lainnya. Data ini tidak mencakup data sensitif, seperti pembayaran atau detail kampanye.

Buat

Untuk membuat grup mediasi, Anda harus menentukan informasi penargetan grup mediasi, termasuk unit iklan yang relevan. Contoh berikut membuat grup mediasi baru untuk iklan interstisial Android untuk 2 unit iklan. Satu baris grup mediasi ditambahkan saat pembuatan untuk sumber iklan InMobi. Anda tidak perlu menyertakan jaringan AdMob karena jaringan ini akan ditambahkan secara default pada saat pembuatan.

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

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

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

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

curl (command line)

Ganti WWWWWWWWWW dengan ID pemetaan unit iklan Anda. ID pemetaan unit iklan dapat ditemukan menggunakan metode 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 ID penayang Anda untuk melihat grup mediasi Anda.

curl (command line)

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 masker kolom untuk memperbarui grup mediasi. Perubahan pada kolom berulang, seperti item dalam daftar, sepenuhnya menggantikan nilai yang ada dengan nilai baru. Pembaruan pada setiap nilai dalam peta dapat dilakukan melalui pengindeksan menurut kunci.

Mask kolom berikut didukung untuk update 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 yang berbeda untuk mediationGroupLineId. Untuk memperbarui baris grup mediasi yang ada, lihat ID baris grup mediasi di update_mask dan payload seperti yang terlihat di bawah.

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

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

curl (command line)

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

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

Anda harus menerjemahkan karakter khusus karena semua URL harus sesuai dengan sintaksis yang ditentukan oleh spesifikasi Uniform Resource Identifier (URI), 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. ID grup mediasi dapat ditemukan di UI AdMob atau menggunakan metode accounts.mediationGroups:list.

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

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Ganti WWWWWWWWWW dengan ID pemetaan unit iklan Anda. ID pemetaan unit iklan dapat ditemukan menggunakan metode 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