Google Ad Manager menawarkan SOAP API untuk pelaporan dan manipulasi 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 Ad Manager API 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, 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 mengetahui detail selengkapnya, lihat panduan pelaporan.
Zona Waktu Pelaporan
Tidak seperti Ad Exchange Seller REST API, di Ad Manager API, laporan ditetapkan secara default ke zona waktu jaringan Anda. Untuk mengubahnya, tetapkan kolom
TimeZoneType.
Pemetaan Metrik dan Dimensi AdX ke Ad Manager
Semua metrik dan dimensi Ad Exchange Seller REST API yang didukung kini ada di API pelaporan Ad Manager. Beberapa nama telah berubah dan beberapa telah dihentikan penggunaannya. 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 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 | Panggilan 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 |
| KLIK | AD_EXCHANGE_CLICKS | Klik |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Panggilan iklan transaksi |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Respons bid transaksi |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Tingkat kecocokan transaksi |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Panggilan 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 berhenti untuk 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 | VTR 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 | Biro Iklan |
| 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 Transaksi |
| 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 operator |
| 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 |
| BULAN | 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 |
| MINGGU | 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 |