- Resource: Report
- ReportDefinition
- Dimensi
- Metrik
- Filter
- FieldFilter
- Kolom
- Operasi
- ReportValue
- IntList
- StringList
- DoubleList
- FilterList
- TimeZoneSource
- DateRange
- FixedDateRange
- Tanggal
- RelativeDateRange
- Urutkan
- Metode
Resource: Report
Resource Report.
| Representasi JSON |
|---|
{
"name": string,
"reportId": string,
"reportDefinition": {
object ( |
| Kolom | |
|---|---|
name |
ID. Nama resource laporan. Nama resource laporan memiliki format: |
reportId |
Hanya output. ID Laporan. |
reportDefinition |
Wajib. Definisi laporan dari laporan. |
displayName |
Opsional. Nama tampilan untuk laporan. |
updateTime |
Hanya output. Waktu saat laporan ini terakhir diubah. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
createTime |
Hanya output. Waktu pembuatan laporan ini. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
locale |
Hanya output. Lokalitas laporan ini. Lokalitas ditetapkan dari lokalitas pengguna pada saat permintaan. Lokalitas tidak dapat diubah. |
ReportDefinition
Definisi cara menjalankan laporan.
| Representasi JSON |
|---|
{ "dimensions": [ enum ( |
| Kolom | |
|---|---|
dimensions[] |
Wajib. Daftar dimensi yang akan dilaporkan. Jika kosong, laporan tidak akan memiliki dimensi, dan metrik apa pun akan menjadi total. |
metrics[] |
Wajib. Daftar metrik yang akan dilaporkan. Jika kosong, laporan tidak akan memiliki metrik. |
filters[] |
Opsional. Filter untuk laporan ini. |
timeZoneSource |
Opsional. Tempat untuk mendapatkan zona waktu untuk laporan ini. Secara default, menggunakan zona waktu Pasifik (PT). Jika sumbernya adalah PROVIDED, kolom timeZone dalam definisi laporan juga harus menetapkan zona waktu. |
timeZone |
Opsional. Jika timeZoneSource adalah PROVIDED, ini adalah zona waktu yang akan digunakan untuk laporan ini. Biarkan kosong untuk sumber zona waktu lainnya. Zona waktu dalam format IANA. Misalnya, "America/New_York". |
currencyCode |
Opsional. Kode mata uang ISO 4217 untuk laporan ini. Jika tidak ditentukan, setelan defaultnya adalah kode mata uang akun. |
dateRange |
Wajib. Rentang tanggal utama laporan ini. |
sorts[] |
Opsional. Pengurutan default yang akan diterapkan ke laporan ini. |
Dimensi
Dimensi pelaporan.
| Enum | |
|---|---|
DIMENSION_UNSPECIFIED |
Nilai default. Nilai ini tidak digunakan. |
ADVERTISER_DOMAIN |
Domain pengiklan. |
COUNTRY |
Nama tampilan negara. |
CURATION_DATA_SEGMENT_ID |
ID segmen data yang dibuat oleh kurator. |
CURATION_DATA_SEGMENT_RESPONSE_STATUS |
Status respons permintaan segmen data dalam Pengelolaan real-time. Lihat https://developers.google.com/authorized-buyers/curation/get-started/start untuk mengetahui detailnya. |
CURATION_DATA_SEGMENT_RESPONSE_STATUS_NAME |
Nama tampilan yang dilokalkan dari status respons permintaan segmen data di Pengelolaan real-time. Lihat https://developers.google.com/authorized-buyers/curation/get-started/start untuk mengetahui detailnya. |
CURATOR_FEE_TYPE |
Jenis layanan seleksi (misalnya, pengemasan atau segmen data). |
DATE |
Tanggal. |
DEAL_ID |
ID transaksi. |
DEAL_NAME |
Nama transaksi. |
DETECTED_ADVERTISER_NAME |
Nama tampilan pengiklan yang terdeteksi. |
DSP_NAME |
Nama tampilan DSP. |
DSP_SEAT_ID |
ID Slot DSP. |
ENVIRONMENT |
Perangkat pengguna dan lingkungan penampung tempat tayangan iklan berasal. Nilai yang didukung adalah "app" dan "web". |
ENVIRONMENT_NAME |
Nama tampilan yang dilokalkan untuk perangkat pengguna dan lingkungan penampung tempat tayangan iklan berasal. Nilai yang didukung adalah "app" dan "web". |
HOLDING_COMPANY_NAME |
Nama tampilan perusahaan induk. |
HOUR |
Jam. |
MOBILE_APP_ID |
ID Aplikasi Seluler. |
MOBILE_APP_NAME |
Nama Aplikasi Seluler. |
MOBILE_OS |
Sistem operasi seluler. |
MONTH |
Bulan. |
PACKAGE_FEE_VISIBILITY |
Visibilitas biaya paket (misalnya, diungkapkan atau tidak diungkapkan). |
PLATFORM |
Platform, misalnya "desktop" vs. "seluler". |
PUBLISHER_DOMAIN |
Domain penayang. |
PUBLISHER_ID |
ID penayang. |
PUBLISHER_NAME |
Nama penayang. |
WEEK |
Minggu. |
Metrik
Metrik pelaporan.
| Enum | |
|---|---|
METRIC_UNSPECIFIED |
Nilai default. Nilai ini tidak digunakan. |
ACTIVE_VIEW_MEASURABILITY_RATE |
Rasio keterukuran Tampilan Aktif. |
ACTIVE_VIEW_MEASURABLE |
Tampilan Aktif terukur. |
ACTIVE_VIEW_VIEWABILITY_RATE |
Rasio visibilitas Tampilan Aktif. |
ACTIVE_VIEW_VIEWABLE |
Ty. iklan terlihat Tampilan Aktif |
AUCTIONS_WON |
Lelang yang dimenangkan. |
BIDS |
Bid. |
BIDS_IN_AUCTION |
Bid di lelang. |
BID_REQUESTS |
Permintaan bid. |
CLICKS |
Klik. |
CURATION_PARTNER_FEE |
Biaya kurator. Nilai ini akan diredaksi menjadi 0,00 jika visibilitas paket ditetapkan ke tidak diungkapkan. Gunakan dimensi PACKAGE_FEE_VISIBILITY untuk memeriksa apakah biaya paket diungkapkan. |
DATA_SEGMENT_REQUESTS |
Jumlah permintaan segmen data yang dikirim dalam Pengelolaan real-time. |
IMPRESSIONS |
Tayangan Iklan. |
SPEND |
Pembelanjaan dalam mata uang pelaporan yang ditentukan dalam permintaan. Setelan defaultnya adalah USD. |
Filter
Filter pada satu atau beberapa kolom.
| Representasi JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "fieldFilter": { object ( |
| Kolom | |
|---|---|
| Jenis ini menentukan cara filter yang mendasarinya digabungkan. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons: | |
fieldFilter |
Filter pada satu kolom. |
notFilter |
Filter yang hasilnya dinegasikan. |
andFilter |
Daftar filter yang hasilnya digabungkan dengan AND. |
orFilter |
Daftar filter yang hasilnya di-OR-kan. |
| Akhir kolom yang saling eksklusif. | |
FieldFilter
Filter pada kolom tertentu.
| Representasi JSON |
|---|
{ "field": { object ( |
| Kolom | |
|---|---|
field |
Wajib. Kolom yang akan difilter. |
operation |
Wajib. Operasi filter ini. |
values[] |
Wajib. Nilai yang akan difilter. |
Kolom
Dimensi atau metrik dalam laporan.
| Representasi JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "dimension": enum ( |
| Kolom | |
|---|---|
| Dimensi atau metrik. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons: | |
dimension |
Dimensi yang diwakili kolom ini. |
metric |
Metrik yang diwakili oleh kolom ini. |
| Akhir kolom yang saling eksklusif. | |
Operasi
Operasi filter yang didukung.
| Enum | |
|---|---|
IN |
Untuk operand skalar, memeriksa apakah operand berada dalam kumpulan nilai filter yang disediakan. Untuk operand daftar, memeriksa apakah ada elemen dalam operand yang berada dalam kumpulan nilai filter yang diberikan. Nilai default. |
NOT_IN |
Untuk operand skalar, memeriksa apakah operand tidak ada dalam kumpulan nilai filter yang diberikan. Untuk operand daftar, memeriksa apakah tidak ada elemen dalam operand yang ada dalam kumpulan nilai filter yang diberikan. |
CONTAINS |
Untuk operand string skalar, memeriksa apakah operand berisi salah satu substring filter yang disediakan. Untuk operand daftar string, memeriksa apakah ada string dalam operand yang berisi substring filter yang disediakan. |
NOT_CONTAINS |
Untuk operand string skalar, memeriksa apakah operand tidak berisi substring filter yang disediakan. Untuk operand daftar string, memeriksa apakah tidak ada string dalam operand yang berisi substring filter yang disediakan. |
LESS_THAN |
Operand kurang dari nilai filter yang diberikan. |
LESS_THAN_EQUALS |
Operand kurang dari atau sama dengan nilai filter yang diberikan. |
GREATER_THAN |
Operand lebih besar dari nilai filter yang diberikan. |
GREATER_THAN_EQUALS |
Operand lebih besar dari atau sama dengan nilai filter yang diberikan. |
BETWEEN |
Operand berada di antara nilai filter yang diberikan. |
MATCHES |
Operand cocok dengan ekspresi reguler atau kumpulan ekspresi reguler (salah satunya harus cocok). |
NOT_MATCHES |
Operand negatif cocok dengan ekspresi reguler atau kumpulan ekspresi reguler (tidak boleh ada yang cocok). |
ReportValue
Mewakili satu nilai dalam laporan.
| Representasi JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "intValue": string, "doubleValue": number, "stringValue": string, "boolValue": boolean, "intListValue": { object ( |
| Kolom | |
|---|---|
| Nilai kolom, bergantung pada format data kolom. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons: | |
intValue |
Untuk nilai bilangan bulat. |
doubleValue |
Untuk nilai ganda. |
stringValue |
Untuk nilai string. |
boolValue |
Untuk nilai boolean. |
intListValue |
Untuk daftar nilai bilangan bulat. |
stringListValue |
Untuk daftar nilai string. |
doubleListValue |
Untuk daftar nilai ganda. |
bytesValue |
Untuk nilai byte. String berenkode base64. |
| Akhir kolom yang saling eksklusif. | |
IntList
Daftar nilai bilangan bulat.
| Representasi JSON |
|---|
{ "values": [ string ] } |
| Kolom | |
|---|---|
values[] |
Nilai |
StringList
Daftar nilai string.
| Representasi JSON |
|---|
{ "values": [ string ] } |
| Kolom | |
|---|---|
values[] |
Nilai |
DoubleList
Daftar nilai ganda.
| Representasi JSON |
|---|
{ "values": [ number ] } |
| Kolom | |
|---|---|
values[] |
Nilai |
FilterList
Daftar filter.
| Representasi JSON |
|---|
{
"filters": [
{
object ( |
| Kolom | |
|---|---|
filters[] |
Wajib. Daftar filter. |
TimeZoneSource
Sumber untuk menentukan zona waktu laporan.
| Enum | |
|---|---|
TIME_ZONE_SOURCE_UNSPECIFIED |
Nilai default yang tidak ditentukan. |
AD_EXCHANGE |
Gunakan zona waktu Pasifik(PT). |
UTC |
Gunakan zona waktu UTC. |
PROVIDED |
Gunakan zona waktu yang diberikan di kolom ReportDefinition.time_zone. Laporan mungkin memerlukan waktu lebih lama untuk dijalankan karena tanggal dihitung secara dinamis pada waktu permintaan. |
CURATOR |
Gunakan zona waktu dari setelan akun kurator. |
DateRange
Rentang tanggal untuk laporan.
| Representasi JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "fixed": { object ( |
| Kolom | |
|---|---|
| Rentang tanggal tetap atau relatif. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons: | |
fixed |
Rentang tanggal tetap. |
relative |
Rentang tanggal relatif. |
| Akhir kolom yang saling eksklusif. | |
FixedDateRange
Rentang tanggal antara dua tanggal tetap (termasuk tanggal akhir).
| Representasi JSON |
|---|
{ "startDate": { object ( |
| Kolom | |
|---|---|
startDate |
Wajib. Tanggal mulai rentang tanggal ini. |
endDate |
Wajib. Tanggal akhir (inklusif) rentang tanggal ini. |
Tanggal
Merepresentasikan tanggal kalender lengkap atau sebagian, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggalnya relatif terhadap Kalender Gregorian. Hal ini dapat mewakili salah satu dari hal berikut:
- Tanggal lengkap, dengan nilai tahun, bulan, dan hari selain nol.
- Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
- Tahun saja, dengan bulan nol dan hari nol.
- Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).
Jenis terkait:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| Representasi JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Kolom | |
|---|---|
year |
Tahun dari tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun. |
month |
Bulan dalam satu tahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari. |
day |
Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan. |
RelativeDateRange
Opsi untuk rentang tanggal relatif.
| Enum | |
|---|---|
RELATIVE_DATE_RANGE_UNSPECIFIED |
Nilai default. Nilai ini tidak digunakan. |
TODAY |
Tanggal laporan dijalankan. |
YESTERDAY |
Tanggal sehari sebelum tanggal laporan dijalankan. |
THIS_WEEK_TO_DATE |
Dari awal minggu kalender hingga dan termasuk hari saat laporan dijalankan. |
THIS_WEEK_TO_YESTERDAY |
Dari awal minggu kalender saat laporan dijalankan, hingga dan termasuk hari sebelum laporan dijalankan. |
THIS_MONTH_TO_DATE |
Dari awal bulan kalender saat laporan dijalankan, hingga dan termasuk hari laporan dijalankan. |
THIS_MONTH_TO_YESTERDAY |
Dari awal bulan kalender saat laporan dijalankan, hingga dan termasuk hari sebelum laporan dijalankan. |
THIS_QUARTER_TO_DATE |
Dari awal kuartal kalender saat laporan dijalankan, hingga dan termasuk hari laporan dijalankan. |
THIS_QUARTER_TO_YESTERDAY |
Dari awal kuartal kalender saat laporan dijalankan, hingga dan termasuk hari sebelum laporan dijalankan. |
THIS_YEAR_TO_DATE |
Dari awal tahun kalender saat laporan dijalankan, hingga dan termasuk hari laporan dijalankan. |
THIS_YEAR_TO_YESTERDAY |
Dari awal tahun kalender saat laporan dijalankan, hingga dan termasuk hari sebelum laporan dijalankan. |
LAST_WEEK |
Seluruh minggu kalender sebelumnya, Senin hingga Minggu (inklusif), sebelum minggu kalender saat laporan dijalankan. |
LAST_WEEK_STARTING_SUNDAY |
Seluruh minggu kalender sebelumnya, Minggu hingga Sabtu (inklusif), sebelum minggu kalender saat laporan dijalankan. |
LAST_MONTH |
Seluruh bulan kalender sebelumnya yang mendahului bulan kalender saat laporan dijalankan. |
LAST_QUARTER |
Seluruh kuartal kalender sebelumnya yang mendahului kuartal kalender saat laporan dijalankan. |
LAST_YEAR |
Seluruh tahun kalender sebelumnya yang mendahului tahun kalender saat laporan dijalankan. |
LAST_7_DAYS |
7 hari sebelum hari eksekusi laporan. |
LAST_30_DAYS |
30 hari sebelum hari eksekusi laporan. |
LAST_60_DAYS |
60 hari sebelum hari eksekusi laporan. |
LAST_90_DAYS |
90 hari sebelum hari eksekusi laporan. |
LAST_93_DAYS |
93 hari sebelum hari eksekusi laporan. |
LAST_180_DAYS |
180 hari sebelum hari eksekusi laporan. |
LAST_360_DAYS |
360 hari sebelum hari eksekusi laporan. |
LAST_365_DAYS |
365 hari sebelum hari eksekusi laporan. |
LAST_3_MONTHS |
Seluruh 3 bulan kalender sebelumnya sebelum bulan kalender saat laporan dijalankan. |
LAST_6_MONTHS |
Seluruh 6 bulan kalender sebelumnya sebelum bulan kalender saat laporan dijalankan. |
LAST_12_MONTHS |
Seluruh 12 bulan kalender sebelumnya yang mendahului bulan kalender saat laporan dijalankan. |
ALL_AVAILABLE |
Dari 3 tahun sebelum laporan dijalankan, hingga sehari sebelum laporan dijalankan, inklusif. |
Urutkan
Menampilkan pengurutan dalam laporan.
| Representasi JSON |
|---|
{
"field": {
object ( |
| Kolom | |
|---|---|
field |
Wajib. Kolom (dimensi atau metrik) yang akan diurutkan. |
descending |
Opsional. Tata urutan. Jika benar, pengurutan akan menurun. |
Metode |
|
|---|---|
|
Membuat objek Report. |
|
Menghapus objek Report. |
|
Mengambil objek Report. |
|
Mencantumkan objek Report. |
|
Memperbarui objek Report. |
|
Memulai eksekusi laporan yang ada secara asinkron. |