- Kaynak: Rapor
- ReportDefinition
- Boyut
- Metrik
- Filtre
- FieldFilter
- Alan
- İşlem
- ReportValue
- IntList
- StringList
- DoubleList
- FilterList
- TimeZoneSource
- DateRange
- FixedDateRange
- Tarih
- RelativeDateRange
- Sıralama
- Yöntemler
Kaynak: Rapor
Report kaynağı.
| JSON gösterimi |
|---|
{
"name": string,
"reportId": string,
"reportDefinition": {
object ( |
| Alanlar | |
|---|---|
name |
Tanımlayıcı. Raporun kaynak adı. Rapor kaynağı adı şu biçimdedir: |
reportId |
Yalnızca çıkış. Rapor kimliği. |
reportDefinition |
Zorunlu. Raporun rapor tanımı. |
displayName |
İsteğe bağlıdır. Raporun görünen adı. |
updateTime |
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: |
createTime |
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: |
locale |
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 ( |
| Alanlar | |
|---|---|
dimensions[] |
Zorunlu. Raporlanacak boyutların listesi. Boş bırakılırsa raporda boyut olmaz ve tüm metrikler toplam değerleri gösterir. |
metrics[] |
Zorunlu. Raporlanacak metriklerin listesi. Boş bırakılırsa raporda metrik olmaz. |
filters[] |
İsteğe bağlıdır. Bu raporun filtreleri. |
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 |
İ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 |
İ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 |
Zorunlu. Bu raporun birincil tarih aralığı. |
sorts[] |
İ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 ( |
| 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 |
Tek bir alandaki filtre. |
notFilter |
Sonucu olumsuz olan bir filtre. |
andFilter |
Sonuçları VE ile birleştirilen filtrelerin listesi. |
orFilter |
Sonuçları VEYA ile birleştirilen filtrelerin listesi. |
| Birbirini hariç tutan alanların sonu. | |
FieldFilter
Belirli bir alandaki filtre.
| JSON gösterimi |
|---|
{ "field": { object ( |
| Alanlar | |
|---|---|
field |
Zorunlu. Filtrelenecek alan. |
operation |
Zorunlu. Bu filtrenin işlemi. |
values[] |
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 ( |
| Alanlar | |
|---|---|
| Boyut veya metrik. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır: | |
dimension |
Bu alanın temsil ettiği boyut. |
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 ( |
| 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 |
Tam sayı değerleri için kullanılır. |
doubleValue |
Çift değerler için. |
stringValue |
Dize değerleri için. |
boolValue |
Boole değerleri için. |
intListValue |
Tam sayı değerleri listeleri için kullanılır. |
stringListValue |
Dize değerleri listeleri için. |
doubleListValue |
Çift değer listeleri için. |
bytesValue |
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[] |
Değerler |
StringList
Dize değerlerinin listesi.
| JSON gösterimi |
|---|
{ "values": [ string ] } |
| Alanlar | |
|---|---|
values[] |
Değerler |
DoubleList
Çift değerlerin listesi.
| JSON gösterimi |
|---|
{ "values": [ number ] } |
| Alanlar | |
|---|---|
values[] |
Değerler |
FilterList
Filtre listesi.
| JSON gösterimi |
|---|
{
"filters": [
{
object ( |
| Alanlar | |
|---|---|
filters[] |
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 ( |
| 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 |
Sabit bir tarih aralığı. |
relative |
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 ( |
| Alanlar | |
|---|---|
startDate |
Zorunlu. Bu tarih aralığının başlangıç tarihi. |
endDate |
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:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| JSON gösterimi |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Alanlar | |
|---|---|
year |
Tarihin yılı. 1 ile 9999 arasında bir sayı olmalı veya yıl belirtilmeyen bir tarih için 0 olmalıdır. |
month |
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 |
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 ( |
| Alanlar | |
|---|---|
field |
Zorunlu. Sıralama ölçütü olarak kullanılacak alan (boyut veya metrik). |
descending |
İsteğe bağlıdır. Sıralama ölçütü. True (doğru) ise sıralama azalan düzende olur. |
Yöntemler |
|
|---|---|
|
Report nesnesi oluşturur. |
|
Bir Report nesnesini siler. |
|
Report nesnesi alır. |
|
Report nesneyi listeler. |
|
Report nesnesini günceller. |
|
Mevcut bir raporun yürütülmesini eşzamansız olarak başlatır. |