- Ressource: Bericht
- ReportDefinition
- Dimension
- Messwert
- Filter
- FieldFilter
- Field
- Vorgang
- ReportValue
- IntList
- StringList
- DoubleList
- FilterList
- TimeZoneSource
- DateRange
- FixedDateRange
- Datum
- RelativeDateRange
- Sortieren
- Methoden
Ressource: Bericht
Die Report-Ressource.
| JSON-Darstellung |
|---|
{
"name": string,
"reportId": string,
"reportDefinition": {
object ( |
| Felder | |
|---|---|
name |
ID. Der Ressourcenname des Berichts. Der Name der Berichtsressource hat das folgende Format: |
reportId |
Nur Ausgabe. Berichts-ID. |
reportDefinition |
Erforderlich. Die Berichtsdefinition des Berichts. |
displayName |
Optional. Anzeigename für den Bericht. |
updateTime |
Nur Ausgabe. Der Zeitpunkt, zu dem dieser Bericht zuletzt geändert wurde. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
createTime |
Nur Ausgabe. Der Zeitpunkt, zu dem dieser Bericht erstellt wurde. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
locale |
Nur Ausgabe. Das Gebietsschema dieses Berichts. Die Sprache wird zum Zeitpunkt der Anfrage anhand der Sprache des Nutzers festgelegt. Die Sprache kann nicht geändert werden. |
ReportDefinition
Die Definition, wie ein Bericht ausgeführt werden soll.
| JSON-Darstellung |
|---|
{ "dimensions": [ enum ( |
| Felder | |
|---|---|
dimensions[] |
Erforderlich. Die Liste der Dimensionen, für die Berichte erstellt werden sollen. Wenn das Feld leer ist, enthält der Bericht keine Dimensionen und alle Messwerte sind Gesamtsummen. |
metrics[] |
Erforderlich. Die Liste der Messwerte, für die Berichte erstellt werden sollen. Wenn das Feld leer ist, enthält der Bericht keine Messwerte. |
filters[] |
Optional. Die Filter für diesen Bericht. |
timeZoneSource |
Optional. Wo Sie die Zeitzone für diesen Bericht finden. Standardmäßig wird die Zeitzone Pacific Time (PT) verwendet. Wenn die Quelle PROVIDED ist, muss im Feld „timeZone“ in der Berichtsdefinition auch eine Zeitzone festgelegt werden. |
timeZone |
Optional. Wenn „timeZoneSource“ den Wert „PROVIDED“ hat, ist dies die Zeitzone, die für diesen Bericht verwendet werden soll. Lassen Sie das Feld leer, wenn Sie eine andere Zeitzonenquelle verwenden. Zeitzone im IANA-Format. Beispiel: „America/New_York“. |
currencyCode |
Optional. Der ISO 4217-Währungscode für diesen Bericht. Wenn keine Angabe gemacht wird, wird standardmäßig der Währungscode des Kontos verwendet. |
dateRange |
Erforderlich. Der primäre Zeitraum dieses Berichts. |
sorts[] |
Optional. Standardsortierungen, die auf diesen Bericht angewendet werden sollen. |
Dimension
Berichtsdimensionen
| Enums | |
|---|---|
DIMENSION_UNSPECIFIED |
Standardwert. Dieser Wert wird nicht verwendet. |
ADVERTISER_DOMAIN |
Die Domain des Werbetreibenden. |
COUNTRY |
Anzeigename eines Landes. |
CURATION_DATA_SEGMENT_ID |
Die ID des Datensegments, das von einem Kurator erstellt wurde. |
CURATION_DATA_SEGMENT_RESPONSE_STATUS |
Der Antwortstatus der Datensegmentanfragen in der Echtzeit-Kuration. Weitere Informationen finden Sie unter https://developers.google.com/authorized-buyers/curation/get-started/start. |
CURATION_DATA_SEGMENT_RESPONSE_STATUS_NAME |
Der lokalisierte Anzeigename des Antwortstatus der Datensegmentanfragen in der Echtzeit-Kuration. Weitere Informationen finden Sie unter https://developers.google.com/authorized-buyers/curation/get-started/start. |
CURATOR_FEE_TYPE |
Die Art des Kuratierungsdienstes (z.B. Paket oder Datensegment). |
DATE |
Datum. |
DEAL_ID |
Deal-ID. |
DEAL_NAME |
Name des Deals. |
DETECTED_ADVERTISER_NAME |
Anzeigename des erkannten Werbetreibenden. |
DSP_NAME |
Anzeigename der DSP. |
DSP_SEAT_ID |
DSP-Sitz-ID. |
ENVIRONMENT |
Das Nutzergerät und die Containerumgebung, von der die Impression stammt. Unterstützte Werte sind „app“ und „web“. |
ENVIRONMENT_NAME |
Der lokalisierte Anzeigename des Nutzergeräts und der Containerumgebung, von der die Impression stammt. Unterstützte Werte sind „app“ und „web“. |
HOLDING_COMPANY_NAME |
Anzeigename der Holdinggesellschaft. |
HOUR |
Stunde. |
MOBILE_APP_ID |
ID der mobilen App. |
MOBILE_APP_NAME |
Name der mobilen App. |
MOBILE_OS |
Mobiles Betriebssystem |
MONTH |
Month. |
PACKAGE_FEE_VISIBILITY |
Die Sichtbarkeit der Paketgebühr (z.B. offengelegt oder nicht offengelegt). |
PLATFORM |
Plattform, z. B. „Desktop“ oder „Mobil“ |
PUBLISHER_DOMAIN |
Publisher-Domain. |
PUBLISHER_ID |
Publisher-ID. |
PUBLISHER_NAME |
Publisher-Name. |
WEEK |
Woche. |
Messwert
Berichtsmesswerte
| Enums | |
|---|---|
METRIC_UNSPECIFIED |
Standardwert. Dieser Wert wird nicht verwendet. |
ACTIVE_VIEW_MEASURABILITY_RATE |
Rate der mit Active View messbaren Impressionen. |
ACTIVE_VIEW_MEASURABLE |
Mit Active View messbar. |
ACTIVE_VIEW_VIEWABILITY_RATE |
Active View-Sichtbarkeitsrate |
ACTIVE_VIEW_VIEWABLE |
Sichtbare Impressionen (Active View) |
AUCTIONS_WON |
Gewonnene Auktionen. |
BIDS |
Gebote: |
BIDS_IN_AUCTION |
Gebote in der Auktion |
BID_REQUESTS |
Gebotsanfragen. |
CLICKS |
Klicks: |
CURATION_PARTNER_FEE |
Kuratierungsgebühr. Dieser Wert wird auf 0,00 gekürzt, wenn die Sichtbarkeit des Pakets auf „Nicht offengelegt“ festgelegt ist. Verwenden Sie die Dimension PACKAGE_FEE_VISIBILITY, um zu prüfen, ob die Gebühr des Pakets offengelegt wird. |
DATA_SEGMENT_REQUESTS |
Anzahl der Datensegmentanfragen, die im Rahmen der Echtzeit-Kuration gesendet wurden. |
IMPRESSIONS |
Impressionen: |
SPEND |
Ausgaben in der in der Anfrage angegebenen Berichtswährung. Die Standardeinstellung ist USD. |
Filter
Ein Filter für ein oder mehrere Felder.
| JSON-Darstellung |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "fieldFilter": { object ( |
| Felder | |
|---|---|
| Der Typ bestimmt, wie die zugrunde liegenden Filter kombiniert werden. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: | |
fieldFilter |
Ein Filter für ein einzelnes Feld. |
notFilter |
Ein Filter, dessen Ergebnis negiert wird. |
andFilter |
Eine Liste von Filtern, deren Ergebnisse mit UND verknüpft sind. |
orFilter |
Eine Liste von Filtern, deren Ergebnisse mit ODER verknüpft sind. |
| Ende der sich gegenseitig ausschließenden Felder. | |
FieldFilter
Ein Filter für ein bestimmtes Feld.
| JSON-Darstellung |
|---|
{ "field": { object ( |
| Felder | |
|---|---|
field |
Pflichtangabe. Das Feld, nach dem gefiltert werden soll. |
operation |
Erforderlich. Der Vorgang dieses Filters. |
values[] |
Erforderlich. Werte, nach denen gefiltert werden soll. |
Feld
Eine Dimension oder ein Messwert in einem Bericht.
| JSON-Darstellung |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "dimension": enum ( |
| Felder | |
|---|---|
| Entweder eine Dimension oder ein Messwert. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: | |
dimension |
Die Dimension, die dieses Feld darstellt. |
metric |
Der Messwert, den dieses Feld darstellt. |
| Ende der sich gegenseitig ausschließenden Felder. | |
Vorgang
Unterstützte Filtervorgänge.
| Enums | |
|---|---|
IN |
Prüft bei skalaren Operanden, ob der Operand in der Menge der angegebenen Filterwerte enthalten ist. Bei Listenoperanden wird geprüft, ob ein Element im Operanden in der Gruppe der angegebenen Filterwerte enthalten ist. Standardwert. |
NOT_IN |
Prüft bei skalaren Operanden, ob der Operand nicht in der Menge der angegebenen Filterwerte enthalten ist. Bei Listenoperanden wird geprüft, ob keines der Elemente im Operanden in der Gruppe der angegebenen Filterwerte enthalten ist. |
CONTAINS |
Prüft bei skalaren Stringoperanden, ob der Operand einen der angegebenen Filterteilstrings enthält. Bei Stringlistenoperanden wird geprüft, ob ein String im Operanden einen der angegebenen Filterteilstrings enthält. |
NOT_CONTAINS |
Prüft bei skalaren Stringoperanden, ob der Operand keinen der angegebenen Filter-Teilstrings enthält. Bei Stringlistenoperanden wird geprüft, ob keiner der Strings im Operanden einen der angegebenen Filterteilstrings enthält. |
LESS_THAN |
Der Operand ist kleiner als der angegebene Filterwert. |
LESS_THAN_EQUALS |
Der Operand ist kleiner oder gleich dem angegebenen Filterwert. |
GREATER_THAN |
Der Operand ist größer als der angegebene Filterwert. |
GREATER_THAN_EQUALS |
Der Operand ist größer als der angegebene Filterwert oder stimmt genau mit ihm überein. |
BETWEEN |
Der Operand liegt zwischen den angegebenen Filterwerten. |
MATCHES |
Der Operand stimmt mit einem regulären Ausdruck oder einer Gruppe regulärer Ausdrücke überein (mindestens einer muss übereinstimmen). |
NOT_MATCHES |
Der Operand stimmt nicht mit einem regulären Ausdruck oder einer Gruppe regulärer Ausdrücke überein (keiner darf übereinstimmen). |
ReportValue
Stellt einen einzelnen Wert in einem Bericht dar.
| JSON-Darstellung |
|---|
{ // 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 ( |
| Felder | |
|---|---|
| Der Wert des Felds hängt vom Datenformat des Felds ab. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: | |
intValue |
Für Ganzzahlwerte. |
doubleValue |
Für Double-Werte. |
stringValue |
Für Stringwerte. |
boolValue |
Für boolesche Werte. |
intListValue |
Für Listen mit Ganzzahlwerten. |
stringListValue |
Für Listen mit Stringwerten. |
doubleListValue |
Für Listen mit doppelten Werten. |
bytesValue |
Für Byte-Werte. Ein base64-codierter String. |
| Ende der sich gegenseitig ausschließenden Felder. | |
IntList
Eine Liste von Ganzzahlwerten.
| JSON-Darstellung |
|---|
{ "values": [ string ] } |
| Felder | |
|---|---|
values[] |
Die Werte |
StringList
Eine Liste von Stringwerten.
| JSON-Darstellung |
|---|
{ "values": [ string ] } |
| Felder | |
|---|---|
values[] |
Die Werte |
DoubleList
Eine Liste mit Double-Werten.
| JSON-Darstellung |
|---|
{ "values": [ number ] } |
| Felder | |
|---|---|
values[] |
Die Werte |
FilterList
Eine Liste von Filtern.
| JSON-Darstellung |
|---|
{
"filters": [
{
object ( |
| Felder | |
|---|---|
filters[] |
Erforderlich. Eine Liste von Filtern. |
TimeZoneSource
Die Quelle, anhand der die Zeitzone für den Bericht bestimmt wird.
| Enums | |
|---|---|
TIME_ZONE_SOURCE_UNSPECIFIED |
Nicht angegebener Standardwert. |
AD_EXCHANGE |
Verwenden Sie die Zeitzone Pacific Time(PT). |
UTC |
Verwenden Sie die UTC-Zeitzone. |
PROVIDED |
Verwenden Sie die im Feld „ReportDefinition.time_zone“ angegebene Zeitzone. Die Ausführung von Berichten kann länger dauern, da die Datumsangaben zum Zeitpunkt der Anfrage dynamisch berechnet werden. |
CURATOR |
Verwenden Sie die Zeitzone aus den Kontoeinstellungen des Kurators. |
DateRange
Ein Zeitraum für einen Bericht.
| JSON-Darstellung |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "fixed": { object ( |
| Felder | |
|---|---|
| Entweder ein fester oder ein relativer Zeitraum. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: | |
fixed |
Ein fester Zeitraum. |
relative |
Ein relativer Zeitraum. |
| Ende der sich gegenseitig ausschließenden Felder. | |
FixedDateRange
Ein Zeitraum zwischen zwei festen Datumsangaben (einschließlich Enddatum).
| JSON-Darstellung |
|---|
{ "startDate": { object ( |
| Felder | |
|---|---|
startDate |
Erforderlich. Das Startdatum dieses Zeitraums. |
endDate |
Erforderlich. Das Enddatum (einschließlich) dieses Zeitraums. |
Datum
Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:
- Ein ganzes Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind
- Einen Monat und einen Tag mit einem Jahr von 0 (z. B. einen Jahrestag)
- Ein Jahr für sich allein, also mit einem Monat und einem Tag von 0
- Ein Jahr und einen Monat mit einem Tag von 0 (z. B. ein Ablaufdatum der Kreditkarte)
Ähnliche Typen:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| JSON-Darstellung |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Felder | |
|---|---|
year |
Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahreszahl angegeben wird. |
month |
Monat eines Jahres. Der Wert muss zwischen 1 und 12 liegen. Er kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird. |
day |
Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Er kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht relevant ist. |
RelativeDateRange
Optionen für relative Zeiträume.
| Enums | |
|---|---|
RELATIVE_DATE_RANGE_UNSPECIFIED |
Standardwert. Dieser Wert wird nicht verwendet. |
TODAY |
Das Datum, an dem der Bericht erstellt wurde. |
YESTERDAY |
Der Tag vor dem Datum, an dem der Bericht erstellt wird. |
THIS_WEEK_TO_DATE |
Vom Beginn der Kalenderwoche bis einschließlich des Tages, an dem der Bericht erstellt wird. |
THIS_WEEK_TO_YESTERDAY |
Vom Beginn der Kalenderwoche, in der der Bericht ausgeführt wird, bis einschließlich des Tages vor der Ausführung des Berichts. |
THIS_MONTH_TO_DATE |
Vom Beginn des Kalendermonats, in dem der Bericht ausgeführt wird, bis einschließlich des Tages, an dem der Bericht ausgeführt wird. |
THIS_MONTH_TO_YESTERDAY |
Vom Beginn des Kalendermonats, in dem der Bericht ausgeführt wird, bis einschließlich des Tages vor der Ausführung des Berichts. |
THIS_QUARTER_TO_DATE |
Vom Beginn des Kalendervierteljahres, in dem der Bericht erstellt wird, bis einschließlich des Tages, an dem der Bericht erstellt wird. |
THIS_QUARTER_TO_YESTERDAY |
Vom Beginn des Kalenderquartals, in dem der Bericht erstellt wird, bis einschließlich des Tages vor der Erstellung des Berichts. |
THIS_YEAR_TO_DATE |
Vom Beginn des Kalenderjahres, in dem der Bericht erstellt wird, bis einschließlich des Tages, an dem der Bericht erstellt wird. |
THIS_YEAR_TO_YESTERDAY |
Vom Beginn des Kalenderjahres, in dem der Bericht erstellt wird, bis einschließlich des Tages vor der Erstellung des Berichts. |
LAST_WEEK |
Die gesamte vorherige Kalenderwoche, Montag bis Sonntag (einschließlich), vor der Kalenderwoche, in der der Bericht ausgeführt wird. |
LAST_WEEK_STARTING_SUNDAY |
Die gesamte vorherige Kalenderwoche, Sonntag bis Samstag (einschließlich), vor der Kalenderwoche, in der der Bericht ausgeführt wird. |
LAST_MONTH |
Der gesamte Kalendermonat vor dem Kalendermonat, in dem der Bericht erstellt wird. |
LAST_QUARTER |
Das gesamte vorherige Kalendervierteljahr, das dem Kalendervierteljahr vorausgeht, in dem der Bericht ausgeführt wird. |
LAST_YEAR |
Das gesamte Kalenderjahr vor dem Kalenderjahr, in dem der Bericht erstellt wird. |
LAST_7_DAYS |
Die 7 Tage vor dem Tag, an dem der Bericht erstellt wird. |
LAST_30_DAYS |
Die 30 Tage vor dem Tag, an dem der Bericht erstellt wird. |
LAST_60_DAYS |
Die 60 Tage vor dem Tag, an dem der Bericht erstellt wird. |
LAST_90_DAYS |
Die 90 Tage vor dem Tag, an dem der Bericht erstellt wird. |
LAST_93_DAYS |
Die 93 Tage vor dem Tag, an dem der Bericht erstellt wird. |
LAST_180_DAYS |
Die 180 Tage vor dem Tag, an dem der Bericht erstellt wird. |
LAST_360_DAYS |
Die 360 Tage vor dem Tag, an dem der Bericht erstellt wird. |
LAST_365_DAYS |
Die 365 Tage vor dem Tag, an dem der Bericht erstellt wird. |
LAST_3_MONTHS |
Die gesamten drei Kalendermonate vor dem Kalendermonat, in dem der Bericht erstellt wird. |
LAST_6_MONTHS |
Die gesamten sechs Kalendermonate vor dem Kalendermonat, in dem der Bericht erstellt wird. |
LAST_12_MONTHS |
Die gesamten 12 Kalendermonate vor dem Kalendermonat, in dem der Bericht erstellt wird. |
ALL_AVAILABLE |
Von 3 Jahren vor der Berichterstellung bis zum Tag vor der Berichterstellung (einschließlich). |
Sortieren
Stellt eine Sortierung in einem Bericht dar.
| JSON-Darstellung |
|---|
{
"field": {
object ( |
| Felder | |
|---|---|
field |
Erforderlich. Ein Feld (Dimension oder Messwert), nach dem sortiert werden soll. |
descending |
Optional. Die Sortierreihenfolge. Bei „true“ wird absteigend sortiert. |
Methoden |
|
|---|---|
|
Erstellt ein Report-Objekt. |
|
Löscht ein Report-Objekt. |
|
Ruft ein Report-Objekt ab. |
|
Listet Report-Objekte auf. |
|
Aktualisiert ein Report-Objekt. |
|
Initiiert die asynchrone Ausführung eines vorhandenen Berichts. |