REST Resource: curators.reports

Resource: Report

Resource Report.

Representasi JSON
{
  "name": string,
  "reportId": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "displayName": string,
  "updateTime": string,
  "createTime": string,
  "locale": string
}
Kolom
name

string

ID. Nama resource laporan. Nama resource laporan memiliki format: curators/{accountId}/reports/{reportId}

reportId

string (int64 format)

Hanya output. ID Laporan.

reportDefinition

object (ReportDefinition)

Wajib. Definisi laporan dari laporan.

displayName

string

Opsional. Nama tampilan untuk laporan.

updateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

createTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

locale

string

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 (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "filters": [
    {
      object (Filter)
    }
  ],
  "timeZoneSource": enum (TimeZoneSource),
  "timeZone": string,
  "currencyCode": string,
  "dateRange": {
    object (DateRange)
  },
  "sorts": [
    {
      object (Sort)
    }
  ]
}
Kolom
dimensions[]

enum (Dimension)

Wajib. Daftar dimensi yang akan dilaporkan. Jika kosong, laporan tidak akan memiliki dimensi, dan metrik apa pun akan menjadi total.

metrics[]

enum (Metric)

Wajib. Daftar metrik yang akan dilaporkan. Jika kosong, laporan tidak akan memiliki metrik.

filters[]

object (Filter)

Opsional. Filter untuk laporan ini.

timeZoneSource

enum (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

string

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

string

Opsional. Kode mata uang ISO 4217 untuk laporan ini. Jika tidak ditentukan, setelan defaultnya adalah kode mata uang akun.

dateRange

object (DateRange)

Wajib. Rentang tanggal utama laporan ini.

sorts[]

object (Sort)

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 (FieldFilter)
  },
  "notFilter": {
    object (Filter)
  },
  "andFilter": {
    object (FilterList)
  },
  "orFilter": {
    object (FilterList)
  }
  // End of mutually exclusive fields.
}
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

object (FieldFilter)

Filter pada satu kolom.

notFilter

object (Filter)

Filter yang hasilnya dinegasikan.

andFilter

object (FilterList)

Daftar filter yang hasilnya digabungkan dengan AND.

orFilter

object (FilterList)

Daftar filter yang hasilnya di-OR-kan.

Akhir kolom yang saling eksklusif.

FieldFilter

Filter pada kolom tertentu.

Representasi JSON
{
  "field": {
    object (Field)
  },
  "operation": enum (Operation),
  "values": [
    {
      object (ReportValue)
    }
  ]
}
Kolom
field

object (Field)

Wajib. Kolom yang akan difilter.

operation

enum (Operation)

Wajib. Operasi filter ini.

values[]

object (ReportValue)

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 (Dimension),
  "metric": enum (Metric)
  // End of mutually exclusive fields.
}
Kolom
Dimensi atau metrik. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
dimension

enum (Dimension)

Dimensi yang diwakili kolom ini.

metric

enum (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 (IntList)
  },
  "stringListValue": {
    object (StringList)
  },
  "doubleListValue": {
    object (DoubleList)
  },
  "bytesValue": string
  // End of mutually exclusive fields.
}
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

string (int64 format)

Untuk nilai bilangan bulat.

doubleValue

number

Untuk nilai ganda.

stringValue

string

Untuk nilai string.

boolValue

boolean

Untuk nilai boolean.

intListValue

object (IntList)

Untuk daftar nilai bilangan bulat.

stringListValue

object (StringList)

Untuk daftar nilai string.

doubleListValue

object (DoubleList)

Untuk daftar nilai ganda.

bytesValue

string (bytes format)

Untuk nilai byte.

String berenkode base64.

Akhir kolom yang saling eksklusif.

IntList

Daftar nilai bilangan bulat.

Representasi JSON
{
  "values": [
    string
  ]
}
Kolom
values[]

string (int64 format)

Nilai

StringList

Daftar nilai string.

Representasi JSON
{
  "values": [
    string
  ]
}
Kolom
values[]

string

Nilai

DoubleList

Daftar nilai ganda.

Representasi JSON
{
  "values": [
    number
  ]
}
Kolom
values[]

number

Nilai

FilterList

Daftar filter.

Representasi JSON
{
  "filters": [
    {
      object (Filter)
    }
  ]
}
Kolom
filters[]

object (Filter)

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 (FixedDateRange)
  },
  "relative": enum (RelativeDateRange)
  // End of mutually exclusive fields.
}
Kolom
Rentang tanggal tetap atau relatif. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
fixed

object (FixedDateRange)

Rentang tanggal tetap.

relative

enum (RelativeDateRange)

Rentang tanggal relatif.

Akhir kolom yang saling eksklusif.

FixedDateRange

Rentang tanggal antara dua tanggal tetap (termasuk tanggal akhir).

Representasi JSON
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Kolom
startDate

object (Date)

Wajib. Tanggal mulai rentang tanggal ini.

endDate

object (Date)

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:

Representasi JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dari tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.

month

integer

Bulan dalam satu tahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.

day

integer

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 (Field)
  },
  "descending": boolean
}
Kolom
field

object (Field)

Wajib. Kolom (dimensi atau metrik) yang akan diurutkan.

descending

boolean

Opsional. Tata urutan. Jika benar, pengurutan akan menurun.

Metode

create

Membuat objek Report.

delete

Menghapus objek Report.

get

Mengambil objek Report.

list

Mencantumkan objek Report.

patch

Memperbarui objek Report.

run

Memulai eksekusi laporan yang ada secara asinkron.