Pemetaan unit iklan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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
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
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",
}
]
}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"
}]
}]
}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
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",
}
}
}
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-31 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-31 UTC."],[[["\u003cp\u003eAd unit mappings link your AdMob ad units to third-party ad networks, allowing them to request ads from those networks.\u003c/p\u003e\n"],["\u003cp\u003eThese mappings are crucial for mediation groups, directing specific ad units to make requests from external ad sources.\u003c/p\u003e\n"],["\u003cp\u003eUnlike the AdMob UI, you must create and manage ad unit mappings separately through the AdMob API.\u003c/p\u003e\n"],["\u003cp\u003eOnce created, you can utilize these mappings when establishing or modifying mediation group lines.\u003c/p\u003e\n"],["\u003cp\u003eYou can get started with AdMob API by creating OAuth 2.0 credentials and generating authorization credentials using your client secret file.\u003c/p\u003e\n"]]],["Ad unit mappings are configured settings for third-party ad networks. They are created independently of mediation groups and their lines, and are used as parameters within those lines to facilitate ad requests. To use, first generate OAuth 2.0 credentials. Then, list ad sources and adapters, obtain the ad unit ID fragment, and create the ad unit mapping via a POST request. Finally, list the newly created mapping via a GET request.\n"],null,["# Ad unit mappings are third-party configuration settings that map to an AdMob ad\nunit and enable it to make an ad request to a third-party ad network.\n\nWhen creating a mediation group, ad unit mappings are used as a parameter for\neach [mediation group line](/admob/api/reference/rest/v1beta/accounts.mediationGroups)\nas settings for the specified ad unit to make third-party ad network requests.\nUnlike on the AdMob UI, ad unit mappings need to be [created](/admob/api/reference/rest/v1beta/accounts.adUnits.adUnitMappings/create)\nindependently outside of mediation groups and mediation group lines.\nAfter creation, you can [list](/admob/api/reference/rest/v1beta/accounts.adUnits.adUnitMappings/list)\nall ad unit mappings and use them as a parameter when creating or updating\nmediation group lines with new ad unit mappings.\n\nExamples\n--------\n\nWith [OAuth 2.0 credentials created](/admob/api/v1/getting-started#credentials),\nyou're ready to start using the AdMob API. To request access using OAuth\n2.0, your application will also need the scope information.\n\nHere's the OAuth 2.0 scope information:\n\n\u003cbr /\u003e\n\n| Scope | Meaning |\n|------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `https://www.googleapis.com/auth/admob.monetization` | See, create, and edit your AdMob monetization settings. |\n| `https://www.googleapis.com/auth/admob.readonly` | See all AdMob data. This may include account information, inventory and mediation settings, reports, and other data. This doesn't include sensitive data, such as payments or campaign details. |\n\n\u003cbr /\u003e\n\nGet started on creating your first ad unit mapping: \n\n### curl (command line)\n\n### Requests using curl\n\n1. Load the [client secrets file](https://console.cloud.google.com/apis/credentials) and generate authorization credentials.\n\n The first time you perform this step you'll be asked to accept an\n authorization prompt in your browser. Before accepting, make sure you're\n signed in with a Google Account that has access to the AdMob API. Your\n application will be authorized to access data on behalf of whichever\n account is currently logged in.\n\n For authentication and authorization, we recommend using\n [oauth2l](//github.com/google/oauth2l), a simple command-line tool for\n working with Google OAuth 2.0. Install oauth2l and run the\n command below, replacing \u003cvar translate=\"no\"\u003epath_to_credentials_json\u003c/var\u003e with a path\n to a `credentials.json` file that you download when registering your\n cloud application. For the first run, the command walks you through the\n OAuth 2.0 authorization flow. Subsequent runs refresh the token\n automatically. \n\n ```\n oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization\n ```\n2. List ad sources.\n\n Get AdMob ad source information by replacing \u003cvar translate=\"no\"\u003epub-XXXXXXXXXXXXXXXX\u003c/var\u003e\n with your publisher ID. See the\n [instructions](//support.google.com/admob/answer/2784578) on how to find\n your publisher ID. \n\n ```\n curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \\\n -H \"$(oauth2l header --json path_to_credentials_json --scope admob.readonly)\"\n ```\n\n Sample response: \n\n ```text\n {\n \"adSources\": [\n {\n \"name\": \"accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855\",\n \"adSourceId\": \"5450213213286189855\",\n \"title\": \"AdMob Network\",\n }\n ]\n }\n ```\n3. List the adapters.\n\n Replace \u003cvar translate=\"no\"\u003eSSSSSSSSSSSSSSSSSSSS\u003c/var\u003e with the ad source ID for the\n adapters of interest.\n\n Use the following command to get a list of adapters: \n\n ```\n curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \\\n -H \"$(oauth2l header --json path_to_credentials_json --scope admob.readonly)\"\n ```\n\n Sample response for the AdMob Network ad source with ID\n `5450213213286189855`: \n\n ```scdoc\n {\n \"adapters\": [\n {\n \"name\": \"accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1\",\n \"adapterId\": \"1\",\n \"title\": \"AdMob Network Android SDK\",\n \"platform\": \"ANDROID\",\n \"formats\": [\"BANNER\", \"INTERSTITIAL\",\n \"REWARDED\", \"NATIVE\", \"REWARDED_INTERSTITIAL\", \"APP_OPEN\"],\n \"adapterConfigMetadata\": [{\n \"adapterConfigMetadataId\": \"118\",\n \"adapterConfigMetadataLabel\": \"Ad unit ID\"\n }]\n },\n {\n \"name\": \"accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2\",\n \"adapterId\": \"2\",\n \"title\": \"AdMob Network iOS SDK\",\n \"platform\": \"ANDROID\",\n \"formats\": [\"BANNER\", \"INTERSTITIAL\",\n \"REWARDED\", \"NATIVE\", \"REWARDED_INTERSTITIAL\", \"APP_OPEN\"],\n \"adapterConfigMetadata\": [{\n \"adapterConfigMetadataId\": \"119\",\n \"adapterConfigMetadataLabel\": \"Ad unit ID\"\n }]\n }]\n }\n ```\n4. Create an ad unit mapping.\n\n Replace \u003cvar translate=\"no\"\u003eYYYYYYYYYY\u003c/var\u003e with your ad unit ID fragment. The ad unit\n ID fragment is the last 10 digits of your ad unit ID which follows\n the format \"ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY\". See instructions to\n [find your ad unit ID](//support.google.com/admob/answer/7356431). \n\n ```\n curl --http1.0 -X POST \\\n https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \\\n -H \"$(oauth2l header --json path_to_credentials_json --scope admob.monetization)\" \\\n -H \"Content-Type: application/json\" --data @- \u003c\u003c EOF\n {\n \"name\": \"InMobi ad unit mapping\",\n \"adapterId\": \"8\",\n \"adUnitConfigurations\": {\n \"174\": \"inMobiAccountId\",\n \"176\": \"inMobiPlacementId\"\n }\n }\n EOF\n ```\n5. List all ad unit mappings.\n\n Replace \u003cvar translate=\"no\"\u003eYYYYYYYYYY\u003c/var\u003e with your ad unit ID fragment. The ad unit\n ID fragment is the last 10 digits of your ad unit ID from\n the format \"ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY\". See instructions to\n [find your ad unit ID](//support.google.com/admob/answer/7356431). \n\n ```\n curl --http1.0 -X GET \\\n https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \\\n -H \"$(oauth2l header --json path_to_credentials_json --scope admob.readonly)\"\n ``` \n\n ```text\n {\n \"adUnitMappingName\":\n \"accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ\"\n {\n \"adapterId\": \"1\",\n \"state\": \"ENABLED\",\n \"adUnitConfigurations\": {\n \"adUnitMappingConfigurationKey\": \"adUnitId\",\n \"adUnitMappingConfigurationValue\": \"118\",\n }\n }\n }\n ```"]]
