Google Ad Manager menawarkan SOAP API untuk pelaporan dan memanipulasi entitas proses iklan, seperti LineItems.
Library klien tersedia dalam beberapa bahasa. Seperti AdX Seller API, Ad Manager API menggunakan OAuth2 untuk autentikasi.
Untuk memulai permintaan API pertama Anda, lihat Memulai.
Pelaporan di Ad Manager API
ReportService API Ad Manager menawarkan dua cara untuk menjalankan dan mendownload laporan:
- Membuat kueri di UI dan menjalankannya berdasarkan ID-nya.
- Membuat ReportQuery ad hoc.
Dengan salah satu opsi tersebut, alur kerja API terdiri dari empat langkah:
- Panggil runReportJob.
- Lakukan polling untuk status laporan menggunakan getReportJobStatus.
- Dapatkan URL ke laporan yang telah selesai menggunakan getReportDownloadUrlWithOptions.
- Download laporan dari URL yang ditampilkan.
Untuk detail selengkapnya, lihat panduan pelaporan.
Zona Waktu Pelaporan
Tidak seperti REST API Penjual Ad Exchange, di laporan Ad Manager API, setelan default-nya adalah zona waktu jaringan Anda. Untuk mengubahnya, tetapkan
kolom
TimeZoneType.
Pemetaan Metrik dan Dimensi AdX ke Ad Manager
Semua metrik dan dimensi REST API Penjual Ad Exchange yang didukung kini ada di Reporting API Ad Manager. Beberapa nama telah berubah dan beberapa tidak digunakan lagi. Lihat tabel di bawah untuk mengetahui detailnya.
Metrik / Kolom
Tabel ini memetakan Metrik AdX ke Kolom Ad Manager.
| Metrik AdX | Kolom Ad Manager | Nama Alat Kueri Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Tayangan yang mengaktifkan tampilan aktif |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Tayangan iklan terukur tampilan aktif |
| ACTIVE_VIEW_MEASURABLE_RATIO | (tidak digunakan lagi) | (tidak digunakan lagi) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Tayangan terlihat tampilan aktif |
| ACTIVE_VIEW_VIEWABLE_RATIO | (tidak digunakan lagi) | (tidak digunakan lagi) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Waktu terlihat rata-rata (detik) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Tayangan iklan |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | eCPM iklan |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | Permintaan iklan |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | Cakupan |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | CTR permintaan iklan |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | eCPM permintaan iklan |
| JUMLAH KLIK | AD_EXCHANGE_CLICKS | Klik |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Permintaan iklan transaksi |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Respons bid transaksi |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Rasio kecocokan transaksi |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Permintaan yang cocok untuk transaksi |
| PENGHASILAN | AD_EXCHANGE_ESTIMATED_REVENUE | Estimasi pendapatan |
| INDIVIDUAL_AD_IMPRESSIONS | (tidak digunakan lagi) | (tidak digunakan lagi) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | CTR Iklan |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (rekomendasi baru) AD_EXCHANGE_AD_ECPM | (rekomendasi baru) eCPM iklan |
| LIFT_RATE | AD_EXCHANGE_LIFT | Peningkatan |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Permintaan yang cocok |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | eCPM yang cocok |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | Rasio pengabaian video |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | Rasio berpaling video |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | Kuartil video 1 |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | Kuartil video 3 |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | Rasio skip video TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | Penayangan TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | RLT TrueView |
Dimensi
Tabel ini memetakan Dimensi AdX ke Dimensi Ad Manager .
| Dimensi AdX | Dimensi Ad Manager | Nama Alat Kueri Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Properti web |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Lokasi iklan |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | Tag |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (Tidak tersedia) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Ukuran inventaris |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Domain pengiklan |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | Pengiklan |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Vertikal pengiklan |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Agen |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (Tidak tersedia) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Merek |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (Tidak tersedia) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Jenis Branding |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (Tidak tersedia) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Jaringan pembeli |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (Tidak tersedia) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Negara |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Ukuran materi iklan |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (Tidak tersedia) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (Tidak tersedia) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Channel |
| DATE | AD_EXCHANGE_DATE | Hari |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | ID Penawaran |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Nama transaksi |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (Tidak tersedia) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | Unit Iklan DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Sumber permintaan |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Sites |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | DSP |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Jenis yang dapat diperluas |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | Kepemilikan inventaris |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | Nama partner jaringan |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | Nama aplikasi |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | Nama ekspedisi |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | Perangkat |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | Jenis inventaris |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | Sistem operasi |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Bandwidth |
| MONTH | AD_EXCHANGE_MONTH | Bulan |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Kategori perangkat |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (Tidak tersedia) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Produk |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (Tidak tersedia) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Jenis penargetan |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (Tidak tersedia) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | Jenis transaksi |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (Tidak tersedia) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (Tidak tersedia) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Durasi iklan video |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Jenis iklan video |
| WEEK | AD_EXCHANGE_WEEK | Minggu |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (Tidak tersedia) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Aturan penetapan harga |