REST Resource: curators.reports

Kaynak: Rapor

Report kaynağı.

JSON gösterimi
{
  "name": string,
  "reportId": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "displayName": string,
  "updateTime": string,
  "createTime": string,
  "locale": string
}
Alanlar
name

string

Tanımlayıcı. Raporun kaynak adı. Rapor kaynağı adı şu biçimdedir: curators/{accountId}/reports/{reportId}

reportId

string (int64 format)

Yalnızca çıkış. Rapor kimliği.

reportDefinition

object (ReportDefinition)

Zorunlu. Raporun rapor tanımı.

displayName

string

İsteğe bağlıdır. Raporun görünen adı.

updateTime

string (Timestamp format)

Yalnızca çıkış. Bu raporun en son değiştirildiği an.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

createTime

string (Timestamp format)

Yalnızca çıkış. Bu raporun oluşturulduğu an.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

locale

string

Yalnızca çıkış. Bu raporun yerel ayarı. Yerel ayar, istek sırasında kullanıcının yerel ayarından alınır. Yerel ayar değiştirilemez.

ReportDefinition

Bir raporun nasıl çalıştırılması gerektiğinin tanımı.

JSON gösterimi
{
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "filters": [
    {
      object (Filter)
    }
  ],
  "timeZoneSource": enum (TimeZoneSource),
  "timeZone": string,
  "currencyCode": string,
  "dateRange": {
    object (DateRange)
  },
  "sorts": [
    {
      object (Sort)
    }
  ]
}
Alanlar
dimensions[]

enum (Dimension)

Zorunlu. Raporlanacak boyutların listesi. Boş bırakılırsa raporda boyut olmaz ve tüm metrikler toplam değerleri gösterir.

metrics[]

enum (Metric)

Zorunlu. Raporlanacak metriklerin listesi. Boş bırakılırsa raporda metrik olmaz.

filters[]

object (Filter)

İsteğe bağlıdır. Bu raporun filtreleri.

timeZoneSource

enum (TimeZoneSource)

İsteğe bağlıdır. Bu raporun saat diliminin alınacağı yer. Varsayılan olarak Pasifik saat dilimi (PT) kullanılır. Kaynak PROVIDED ise rapor tanımındaki timeZone alanı da bir saat dilimi ayarlamalıdır.

timeZone

string

İsteğe bağlıdır. timeZoneSource, PROVIDED ise bu rapor için kullanılacak saat dilimidir. Diğer saat dilimi kaynakları için boş bırakın. IANA biçiminde saat dilimi. Örneğin, "America/New_York".

currencyCode

string

İsteğe bağlıdır. Bu rapor için ISO 4217 para birimi kodu. Belirtilmezse varsayılan olarak hesap para birimi kodu kullanılır.

dateRange

object (DateRange)

Zorunlu. Bu raporun birincil tarih aralığı.

sorts[]

object (Sort)

İsteğe bağlıdır. Bu rapora uygulanacak varsayılan sıralamalar.

Boyut

Raporlama boyutları.

Sıralamalar
DIMENSION_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
ADVERTISER_DOMAIN Reklamverenin alanı.
COUNTRY Bir ülkenin görünen adı.
CURATION_DATA_SEGMENT_ID Seçici tarafından oluşturulan veri segmentinin kimliği.
CURATION_DATA_SEGMENT_RESPONSE_STATUS Gerçek Zamanlı Analiz seçimindeki veri segmenti isteklerinin yanıt durumu. Ayrıntılar için https://developers.google.com/authorized-buyers/curation/get-started/start adresini ziyaret edin.
CURATION_DATA_SEGMENT_RESPONSE_STATUS_NAME Gerçek Zamanlı Analiz seçimindeki veri segmenti isteklerinin yanıt durumunun yerelleştirilmiş görünen adı. Ayrıntılar için https://developers.google.com/authorized-buyers/curation/get-started/start adresini ziyaret edin.
CURATOR_FEE_TYPE Seçim hizmetinin türü (ör. paketleme veya veri segmenti).
DATE Tarih.
DEAL_ID Anlaşma kimliği.
DEAL_NAME Anlaşma adı.
DETECTED_ADVERTISER_NAME Tespit edilen reklamverenin görünen adı.
DSP_NAME TTP'nin görünen adı.
DSP_SEAT_ID TTP lisans kimliği.
ENVIRONMENT Gösterimin kaynaklandığı kullanıcı cihazı ve kapsayıcı ortamı. "app" ve "web" desteklenen değerlerdir.
ENVIRONMENT_NAME Gösterimin kaynaklandığı kullanıcı cihazının ve kapsayıcı ortamının yerelleştirilmiş görünen adı. "app" ve "web" desteklenen değerlerdir.
HOLDING_COMPANY_NAME Ana şirketin görünen adı.
HOUR Saat.
MOBILE_APP_ID Mobil uygulama kimliği.
MOBILE_APP_NAME Mobil uygulama adı.
MOBILE_OS Mobil işletim sistemi.
MONTH Ay.
PACKAGE_FEE_VISIBILITY Paket ücretinin görünürlüğü (ör. açıklanmış veya açıklanmamış).
PLATFORM Platform (ör. "masaüstü" ve "mobil").
PUBLISHER_DOMAIN Yayıncı alanı.
PUBLISHER_ID Yayıncı tanımlayıcısı.
PUBLISHER_NAME Yayıncı adı.
WEEK Hafta.

Metrik

Raporlama metrikleri.

Sıralamalar
METRIC_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
ACTIVE_VIEW_MEASURABILITY_RATE Aktif Görüntüleme ölçülebilirlik oranı.
ACTIVE_VIEW_MEASURABLE Aktif Görüntüleme ölçülebilirliği.
ACTIVE_VIEW_VIEWABILITY_RATE Aktif Görüntüleme görüntülenebilirlik oranı.
ACTIVE_VIEW_VIEWABLE Aktif Görüntüleme görüntülenebilir gösterim sayısı
AUCTIONS_WON Kazanılan açık artırmalar.
BIDS Teklifler.
BIDS_IN_AUCTION Açık artırmadaki teklifler.
BID_REQUESTS Teklif istekleri.
CLICKS Clicks.
CURATION_PARTNER_FEE Seçim ücreti. Paketin görünürlüğü "açıklanmadı" olarak ayarlanırsa bu değer 0,00 olarak değiştirilir. Paket ücretinin açıklanıp açıklanmadığını kontrol etmek için PACKAGE_FEE_VISIBILITY boyutunu kullanın.
DATA_SEGMENT_REQUESTS Gerçek Zamanlı Analiz'de gönderilen veri segmenti isteklerinin sayısı.
IMPRESSIONS Gösterim sayısı.
SPEND İstekte belirtilen raporlama para birimi cinsinden harcama. Varsayılan olarak ABD doları kullanılır.

Filtre

Bir veya daha fazla alan için filtre.

JSON gösterimi
{

  // 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.
}
Alanlar
Tür, temel filtrelerin nasıl birleştirileceğini belirler. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
fieldFilter

object (FieldFilter)

Tek bir alandaki filtre.

notFilter

object (Filter)

Sonucu olumsuz olan bir filtre.

andFilter

object (FilterList)

Sonuçları VE ile birleştirilen filtrelerin listesi.

orFilter

object (FilterList)

Sonuçları VEYA ile birleştirilen filtrelerin listesi.

Birbirini hariç tutan alanların sonu.

FieldFilter

Belirli bir alandaki filtre.

JSON gösterimi
{
  "field": {
    object (Field)
  },
  "operation": enum (Operation),
  "values": [
    {
      object (ReportValue)
    }
  ]
}
Alanlar
field

object (Field)

Zorunlu. Filtrelenecek alan.

operation

enum (Operation)

Zorunlu. Bu filtrenin işlemi.

values[]

object (ReportValue)

Zorunlu. Filtrelenecek değerler.

Alan

Rapordaki bir boyut veya metrik.

JSON gösterimi
{

  // 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.
}
Alanlar
Boyut veya metrik. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
dimension

enum (Dimension)

Bu alanın temsil ettiği boyut.

metric

enum (Metric)

Bu alanın temsil ettiği metrik.

Birbirini hariç tutan alanların sonu.

İşlem

Desteklenen filtre işlemleri.

Sıralamalar
IN

Skaler işlenenler için işlenenin, sağlanan filtre değerleri kümesinde olup olmadığını kontrol eder.

Liste işlenenleri için işlenendeki herhangi bir öğenin, sağlanan filtre değerleri kümesinde olup olmadığını kontrol eder.

Varsayılan değer.

NOT_IN

Skaler işlenenler için işlenenin, sağlanan filtre değerleri kümesinde olmadığını kontrol eder.

Liste işlenenleri için işlenendeki öğelerin hiçbirinin sağlanan filtre değerleri grubunda olmadığını kontrol eder.

CONTAINS

Skaler dize işlenenleri için, işlenenin sağlanan filtre alt dizelerinden herhangi birini içerip içermediğini kontrol eder.

Dize listesi işlenenleri için, işlenendeki herhangi bir dizenin sağlanan filtre alt dizelerinden herhangi birini içerip içermediğini kontrol eder.

NOT_CONTAINS

Skaler dize işlenenleri için işlenenin, sağlanan filtre alt dizelerinden hiçbirini içermediğini kontrol eder.

Dize listesi işlenenleri için, işlenendeki dizelerin hiçbirinin sağlanan filtre alt dizelerinden hiçbirini içermediğini kontrol eder.

LESS_THAN İşlenen, sağlanan filtre değerinden küçüktür.
LESS_THAN_EQUALS İşlenen, sağlanan filtre değerinden küçük veya bu değere eşit.
GREATER_THAN İşlenen, sağlanan filtre değerinden büyük.
GREATER_THAN_EQUALS İşlenen, sağlanan filtre değerinden büyük veya bu değere eşit.
BETWEEN İşlenen, sağlanan filtre değerleri arasındadır.
MATCHES İşlenen, bir normal ifade veya normal ifade grubuyla eşleşir (biri eşleşmelidir).
NOT_MATCHES İşlenen, bir normal ifade veya normal ifade grubuyla negatif eşleşir (hiçbiri eşleşmemelidir).

ReportValue

Rapordaki tek bir değeri temsil eder.

JSON gösterimi
{

  // 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.
}
Alanlar
Alanın değeri, alanın veri biçimine bağlıdır. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
intValue

string (int64 format)

Tam sayı değerleri için kullanılır.

doubleValue

number

Çift değerler için.

stringValue

string

Dize değerleri için.

boolValue

boolean

Boole değerleri için.

intListValue

object (IntList)

Tam sayı değerleri listeleri için kullanılır.

stringListValue

object (StringList)

Dize değerleri listeleri için.

doubleListValue

object (DoubleList)

Çift değer listeleri için.

bytesValue

string (bytes format)

Bayt değerleri için kullanılır.

Base64 ile kodlanmış bir dize.

Birbirini hariç tutan alanların sonu.

IntList

Tam sayı değerlerinin listesi.

JSON gösterimi
{
  "values": [
    string
  ]
}
Alanlar
values[]

string (int64 format)

Değerler

StringList

Dize değerlerinin listesi.

JSON gösterimi
{
  "values": [
    string
  ]
}
Alanlar
values[]

string

Değerler

DoubleList

Çift değerlerin listesi.

JSON gösterimi
{
  "values": [
    number
  ]
}
Alanlar
values[]

number

Değerler

FilterList

Filtre listesi.

JSON gösterimi
{
  "filters": [
    {
      object (Filter)
    }
  ]
}
Alanlar
filters[]

object (Filter)

Zorunlu. Filtre listesi.

TimeZoneSource

Raporun saat dilimini belirleyen kaynak.

Sıralamalar
TIME_ZONE_SOURCE_UNSPECIFIED Belirtilmemiş varsayılan değer.
AD_EXCHANGE Pasifik saat dilimini(PT) kullanın.
UTC UTC saat dilimini kullanın.
PROVIDED ReportDefinition.time_zone alanında sağlanan saat dilimini kullanın. Tarihler istek sırasında dinamik olarak hesaplandığından raporların çalıştırılması daha uzun sürebilir.
CURATOR Seçici hesabının ayarlarındaki saat dilimini kullanın.

DateRange

Raporun tarih aralığı.

JSON gösterimi
{

  // 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.
}
Alanlar
Sabit veya göreli tarih aralığı. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
fixed

object (FixedDateRange)

Sabit bir tarih aralığı.

relative

enum (RelativeDateRange)

Göreli tarih aralığı.

Birbirini hariç tutan alanların sonu.

FixedDateRange

İki sabit tarih arasındaki tarih aralığı (bitiş tarihi dahil).

JSON gösterimi
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Alanlar
startDate

object (Date)

Zorunlu. Bu tarih aralığının başlangıç tarihi.

endDate

object (Date)

Zorunlu. Bu tarih aralığının bitiş tarihi (dahil).

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini temsil eder. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerlerini içeren tam bir tarih.
  • Yılın sıfır olduğu bir ay ve gün (örneğin, yıl dönümü).
  • Ay ve günün sıfır olduğu, yalnızca yılın belirtildiği tarih.
  • Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartının son kullanma tarihi).

İlgili türler:

JSON gösterimi
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında bir sayı olmalı veya yıl belirtilmeyen bir tarih için 0 olmalıdır.

month

integer

Yılın ayı. 1 ile 12 arasında bir değer olmalıdır. Ay ve gün olmadan bir yıl belirtmek için 0 değerini kullanın.

day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yılı tek başına veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

RelativeDateRange

Göreli tarih aralıkları için seçenekler.

Sıralamalar
RELATIVE_DATE_RANGE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
TODAY Raporun çalıştırıldığı tarih.
YESTERDAY Raporun çalıştırıldığı tarihten bir gün önceki tarih.
THIS_WEEK_TO_DATE Raporun çalıştırıldığı gün de dahil olmak üzere takvim haftasının başından itibaren.
THIS_WEEK_TO_YESTERDAY Raporun çalıştırıldığı takvim haftasının başından, raporun çalıştırıldığı günden önceki güne kadar (bu gün dahil).
THIS_MONTH_TO_DATE Raporun çalıştırıldığı takvim ayının başından raporun çalıştırıldığı güne kadar (bu gün dahil).
THIS_MONTH_TO_YESTERDAY Raporun çalıştırıldığı takvim ayının başından, raporun çalıştırıldığı günden önceki güne kadar (bu gün dahil).
THIS_QUARTER_TO_DATE Raporun çalıştırıldığı takvim çeyreğinin başından raporun çalıştırıldığı güne kadar (bu gün dahil).
THIS_QUARTER_TO_YESTERDAY Raporun çalıştırıldığı takvim çeyreğinin başından, raporun çalıştırıldığı günden önceki güne kadar (bu gün dahil).
THIS_YEAR_TO_DATE Raporun çalıştırıldığı takvim yılının başından, raporun çalıştırıldığı güne kadar (bu gün dahil).
THIS_YEAR_TO_YESTERDAY Raporun çalıştırıldığı takvim yılının başından, raporun çalıştırıldığı günden önceki güne kadar (bu gün dahil).
LAST_WEEK Raporun çalıştırıldığı takvim haftasından önceki takvim haftasının tamamı (pazartesiden pazara kadar, pazar dahil).
LAST_WEEK_STARTING_SUNDAY Raporun çalıştırıldığı takvim haftasından önceki takvim haftasının tamamı (pazar-cumartesi, dahil).
LAST_MONTH Raporun çalıştırıldığı takvim ayından önceki takvim ayının tamamı.
LAST_QUARTER Raporun çalıştırıldığı takvim çeyreğinden önceki takvim çeyreğinin tamamı.
LAST_YEAR Raporun çalıştırıldığı takvim yılından önceki takvim yılının tamamı.
LAST_7_DAYS Raporun çalıştırıldığı günden önceki 7 gün.
LAST_30_DAYS Raporun çalıştırıldığı günden önceki 30 gün.
LAST_60_DAYS Raporun çalıştırıldığı günden önceki 60 gün.
LAST_90_DAYS Raporun çalıştırıldığı günden önceki 90 gün.
LAST_93_DAYS Raporun çalıştırıldığı günden önceki 93 gün.
LAST_180_DAYS Raporun çalıştırıldığı günden önceki 180 gün.
LAST_360_DAYS Raporun çalıştırıldığı günden önceki 360 gün.
LAST_365_DAYS Raporun çalıştırıldığı günden önceki 365 gün.
LAST_3_MONTHS Raporun çalıştırıldığı takvim ayından önceki 3 takvim ayının tamamı.
LAST_6_MONTHS Raporun çalıştırıldığı takvim ayından önceki 6 takvim ayının tamamı.
LAST_12_MONTHS Raporun çalıştırıldığı takvim ayından önceki 12 takvim ayının tamamı.
ALL_AVAILABLE Raporun çalıştırılmasından 3 yıl öncesinden raporun çalıştırılmasından önceki güne kadar (dahil).

Sırala

Bir rapordaki sıralamayı temsil eder.

JSON gösterimi
{
  "field": {
    object (Field)
  },
  "descending": boolean
}
Alanlar
field

object (Field)

Zorunlu. Sıralama ölçütü olarak kullanılacak alan (boyut veya metrik).

descending

boolean

İsteğe bağlıdır. Sıralama ölçütü. True (doğru) ise sıralama azalan düzende olur.

Yöntemler

create

Report nesnesi oluşturur.

delete

Bir Report nesnesini siler.

get

Report nesnesi alır.

list

Report nesneyi listeler.

patch

Report nesnesini günceller.

run

Mevcut bir raporun yürütülmesini eşzamansız olarak başlatır.