REST Resource: curators.reports

Risorsa: Report

La risorsa Report.

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

string

Identificatore. Il nome della risorsa del report. Il nome della risorsa del report ha il seguente formato: curators/{accountId}/reports/{reportId}

reportId

string (int64 format)

Solo output. ID report.

reportDefinition

object (ReportDefinition)

Obbligatorio. La definizione del report.

displayName

string

Facoltativo. Nome visualizzato del report.

updateTime

string (Timestamp format)

Solo output. L'istante dell'ultima modifica del report.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

createTime

string (Timestamp format)

Solo output. L'istante in cui è stato creato questo report.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

locale

string

Solo output. Le impostazioni internazionali di questo report. Le impostazioni internazionali vengono impostate in base alle impostazioni internazionali dell'utente al momento della richiesta. Le impostazioni internazionali non possono essere modificate.

ReportDefinition

La definizione di come deve essere eseguito un report.

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

enum (Dimension)

Obbligatorio. L'elenco delle dimensioni in base alle quali generare il report. Se questo campo è vuoto, il report non avrà dimensioni e le metriche saranno totali.

metrics[]

enum (Metric)

Obbligatorio. L'elenco delle metriche per cui generare report. Se il campo è vuoto, il report non conterrà metriche.

filters[]

object (Filter)

Facoltativo. I filtri per questo report.

timeZoneSource

enum (TimeZoneSource)

Facoltativo. Dove trovare il fuso orario per questo report. Per impostazione predefinita, viene utilizzato il fuso orario del Pacifico (PT). Se l'origine è PROVIDED, anche il campo timeZone nella definizione del report deve impostare un fuso orario.

timeZone

string

Facoltativo. Se timeZoneSource è PROVIDED, questo è il fuso orario da utilizzare per questo report. Lascia vuoto per qualsiasi altra origine del fuso orario. Fuso orario in formato IANA. Ad esempio, "America/New_York".

currencyCode

string

Facoltativo. Il codice valuta ISO 4217 per questo report. Se non specificato, il valore predefinito è il codice valuta dell'account.

dateRange

object (DateRange)

Obbligatorio. L'intervallo di date principale di questo report.

sorts[]

object (Sort)

Facoltativo. Ordinamenti predefiniti da applicare a questo report.

Dimensione

Dimensioni dei report.

Enum
DIMENSION_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
ADVERTISER_DOMAIN Il dominio dell'inserzionista.
COUNTRY Nome visualizzato di un paese.
CURATION_DATA_SEGMENT_ID L'ID del segmento di dati creato da un curatore.
CURATION_DATA_SEGMENT_RESPONSE_STATUS Lo stato della risposta delle richieste di segmenti di dati nella selezione in tempo reale. Per maggiori dettagli, consulta la pagina https://developers.google.com/authorized-buyers/curation/get-started/start.
CURATION_DATA_SEGMENT_RESPONSE_STATUS_NAME Il nome visualizzato localizzato dello stato della risposta delle richieste di segmenti di dati nella selezione in tempo reale. Per maggiori dettagli, consulta la pagina https://developers.google.com/authorized-buyers/curation/get-started/start.
CURATOR_FEE_TYPE Il tipo di servizio di selezione (ad es. pacchetto o segmento di dati).
DATE Data.
DEAL_ID ID deal.
DEAL_NAME Nome deal.
DETECTED_ADVERTISER_NAME Il nome visualizzato dell'inserzionista rilevato.
DSP_NAME Nome visualizzato della DSP.
DSP_SEAT_ID ID seat DSP.
ENVIRONMENT Il dispositivo dell'utente e l'ambiente del container da cui ha origine l'impressione. I valori supportati sono "app" e "web".
ENVIRONMENT_NAME Il nome visualizzato localizzato del dispositivo dell'utente e dell'ambiente container da cui proviene l'impressione. I valori supportati sono "app" e "web".
HOLDING_COMPANY_NAME Nome visualizzato della holding.
HOUR Ora.
MOBILE_APP_ID ID app mobile.
MOBILE_APP_NAME Nome app mobile.
MOBILE_OS Sistema operativo mobile.
MONTH Mese.
PACKAGE_FEE_VISIBILITY La visibilità della tariffa del pacchetto (ad es. divulgata o non divulgata).
PLATFORM Piattaforma, ad esempio "computer" e "dispositivo mobile".
PUBLISHER_DOMAIN Dominio del publisher.
PUBLISHER_ID Identificatore del publisher.
PUBLISHER_NAME Nome del publisher.
WEEK Settimana.

Metrica

Metriche dei report.

Enum
METRIC_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
ACTIVE_VIEW_MEASURABILITY_RATE Tasso di misurabilità con Visualizzazione attiva.
ACTIVE_VIEW_MEASURABLE Misurabilità con Visualizzazione attiva.
ACTIVE_VIEW_VIEWABILITY_RATE Tasso di visibilità con Visualizzazione attiva.
ACTIVE_VIEW_VIEWABLE Impr. visibili con Visualizzazione attiva
AUCTIONS_WON Aste vinte.
BIDS Offerte.
BIDS_IN_AUCTION Offerte nell'asta.
BID_REQUESTS Richieste di offerta.
CLICKS Clic.
CURATION_PARTNER_FEE Commissione del curatore. Questo valore verrà oscurato e impostato su 0,00 se la visibilità del pacchetto è impostata su non divulgata. Utilizza la dimensione PACKAGE_FEE_VISIBILITY per verificare se la tariffa del pacchetto è visibile.
DATA_SEGMENT_REQUESTS Numero di richieste di segmenti di dati inviate nella selezione in tempo reale.
IMPRESSIONS Impressioni.
SPEND Spesa nella valuta dei report specificata nella richiesta. Il valore predefinito è USD.

Filtro

Un filtro su uno o più campi.

Rappresentazione 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.
}
Campi
Il tipo determina il modo in cui vengono combinati i filtri sottostanti. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
fieldFilter

object (FieldFilter)

Un filtro su un singolo campo.

notFilter

object (Filter)

Un filtro il cui risultato è negato.

andFilter

object (FilterList)

Un elenco di filtri i cui risultati vengono combinati con l'operatore AND.

orFilter

object (FilterList)

Un elenco di filtri i cui risultati sono combinati con l'operatore OR.

Fine dei campi che si escludono a vicenda.

FieldFilter

Un filtro su un campo specifico.

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

object (Field)

Obbligatorio. Il campo in base al quale applicare il filtro.

operation

enum (Operation)

Obbligatorio. L'operazione di questo filtro.

values[]

object (ReportValue)

Obbligatorio. Valori in base ai quali applicare il filtro.

Campo

Una dimensione o una metrica in un report.

Rappresentazione 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.
}
Campi
Una dimensione o una metrica. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
dimension

enum (Dimension)

La dimensione rappresentata da questo campo.

metric

enum (Metric)

La metrica rappresentata da questo campo.

Fine dei campi che si escludono a vicenda.

Operazione

Operazioni di filtro supportate.

Enum
IN

Per gli operandi scalari, verifica se l'operando è presente nell'insieme di valori di filtro forniti.

Per gli operandi di elenco, controlla se un elemento dell'operando è presente nell'insieme di valori di filtro forniti.

Valore predefinito.

NOT_IN

Per gli operandi scalari, verifica che l'operando non sia presente nell'insieme di valori di filtro forniti.

Per gli operandi di elenco, verifica che nessuno degli elementi nell'operando sia presente nell'insieme di valori di filtro forniti.

CONTAINS

Per gli operandi di stringa scalari, verifica se l'operando contiene una delle sottostringhe di filtro fornite.

Per gli operandi di elenchi di stringhe, verifica se una stringa nell'operando contiene una delle sottostringhe di filtro fornite.

NOT_CONTAINS

Per gli operandi di stringa scalari, verifica che l'operando non contenga nessuna delle sottostringhe di filtro fornite.

Per gli operandi di elenchi di stringhe, verifica che nessuna delle stringhe nell'operando contenga nessuna delle sottostringhe di filtro fornite.

LESS_THAN L'operando è inferiore al valore del filtro fornito.
LESS_THAN_EQUALS L'operando è minore o uguale al valore del filtro fornito.
GREATER_THAN L'operando è maggiore del valore del filtro fornito.
GREATER_THAN_EQUALS L'operando è maggiore o uguale al valore del filtro fornito.
BETWEEN L'operando è compreso tra i valori di filtro forniti.
MATCHES L'operando corrisponde a un'espressione regolare o a un insieme di espressioni regolari (una deve corrispondere).
NOT_MATCHES L'operando non corrisponde a un'espressione regolare o a un insieme di espressioni regolari (nessuna deve corrispondere).

ReportValue

Rappresenta un singolo valore in un report.

Rappresentazione 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.
}
Campi
Il valore del campo dipende dal formato dei dati del campo. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
intValue

string (int64 format)

Per i valori interi.

doubleValue

number

Per i valori doppi.

stringValue

string

Per i valori di stringa.

boolValue

boolean

Per i valori booleani.

intListValue

object (IntList)

Per gli elenchi di valori interi.

stringListValue

object (StringList)

Per gli elenchi di valori di stringa.

doubleListValue

object (DoubleList)

Per elenchi di valori double.

bytesValue

string (bytes format)

Per i valori di byte.

Una stringa con codifica in base64.

Fine dei campi che si escludono a vicenda.

IntList

Un elenco di valori interi.

Rappresentazione JSON
{
  "values": [
    string
  ]
}
Campi
values[]

string (int64 format)

I valori

StringList

Un elenco di valori di stringa.

Rappresentazione JSON
{
  "values": [
    string
  ]
}
Campi
values[]

string

I valori

DoubleList

Un elenco di valori double.

Rappresentazione JSON
{
  "values": [
    number
  ]
}
Campi
values[]

number

I valori

FilterList

Un elenco di filtri.

Rappresentazione JSON
{
  "filters": [
    {
      object (Filter)
    }
  ]
}
Campi
filters[]

object (Filter)

Obbligatorio. Un elenco di filtri.

TimeZoneSource

L'origine per determinare il fuso orario del report.

Enum
TIME_ZONE_SOURCE_UNSPECIFIED Valore predefinito non specificato.
AD_EXCHANGE Utilizza il fuso orario del Pacifico(PT).
UTC Utilizza il fuso orario UTC.
PROVIDED Utilizza il fuso orario fornito nel campo ReportDefinition.time_zone. L'esecuzione dei report potrebbe richiedere più tempo, poiché le date vengono calcolate dinamicamente al momento della richiesta.
CURATOR Utilizza il fuso orario delle impostazioni dell'account del curatore.

DateRange

Un intervallo di date per un report.

Rappresentazione 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.
}
Campi
Un intervallo di date fisso o relativo. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
fixed

object (FixedDateRange)

Un intervallo di date fisso.

relative

enum (RelativeDateRange)

Un intervallo di date relativo.

Fine dei campi che si escludono a vicenda.

FixedDateRange

Un intervallo di date compreso tra due date fisse (inclusa la data di fine).

Rappresentazione JSON
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Campi
startDate

object (Date)

Obbligatorio. La data di inizio di questo intervallo di date.

endDate

object (Date)

Obbligatorio. La data di fine (inclusa) di questo intervallo di date.

Data

Rappresenta una data di calendario completa o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno, con un anno zero (ad esempio, un anniversario).
  • Un anno da solo, con un mese pari a zero e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

RelativeDateRange

Opzioni per gli intervalli di date relativi.

Enum
RELATIVE_DATE_RANGE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
TODAY La data di esecuzione del report.
YESTERDAY La data del giorno precedente a quella di esecuzione del report.
THIS_WEEK_TO_DATE Dall'inizio della settimana di calendario fino al giorno di esecuzione del report incluso.
THIS_WEEK_TO_YESTERDAY Dall'inizio della settimana di calendario in cui viene generato il report fino al giorno precedente alla generazione del report incluso.
THIS_MONTH_TO_DATE Dall'inizio del mese di calendario in cui viene eseguito il report fino al giorno in cui viene eseguito il report incluso.
THIS_MONTH_TO_YESTERDAY Dall'inizio del mese di calendario in cui viene eseguito il report fino al giorno precedente l'esecuzione del report incluso.
THIS_QUARTER_TO_DATE Dall'inizio del trimestre di calendario in cui viene eseguito il report fino al giorno in cui viene eseguito il report incluso.
THIS_QUARTER_TO_YESTERDAY Dall'inizio del trimestre di calendario in cui viene eseguito il report fino al giorno precedente l'esecuzione del report incluso.
THIS_YEAR_TO_DATE Dall'inizio dell'anno di calendario in cui viene eseguito il report fino al giorno in cui viene eseguito il report incluso.
THIS_YEAR_TO_YESTERDAY Dall'inizio dell'anno di calendario in cui viene eseguito il report fino al giorno precedente l'esecuzione del report incluso.
LAST_WEEK L'intera settimana di calendario precedente, da lunedì a domenica (inclusi), che precede la settimana di calendario in cui viene eseguito il report.
LAST_WEEK_STARTING_SUNDAY L'intera settimana di calendario precedente, da domenica a sabato (inclusi), che precede la settimana di calendario in cui viene eseguito il report.
LAST_MONTH L'intero mese di calendario precedente a quello in cui viene eseguito il report.
LAST_QUARTER L'intero trimestre di calendario precedente a quello in cui viene eseguito il report.
LAST_YEAR L'intero anno di calendario precedente all'anno di calendario in cui viene eseguito il report.
LAST_7_DAYS I 7 giorni precedenti al giorno di esecuzione del report.
LAST_30_DAYS I 30 giorni precedenti al giorno di esecuzione del report.
LAST_60_DAYS I 60 giorni precedenti al giorno di esecuzione del report.
LAST_90_DAYS I 90 giorni precedenti al giorno di esecuzione del report.
LAST_93_DAYS I 93 giorni precedenti al giorno di esecuzione del report.
LAST_180_DAYS I 180 giorni precedenti al giorno di esecuzione del report.
LAST_360_DAYS I 360 giorni precedenti al giorno di esecuzione del report.
LAST_365_DAYS I 365 giorni precedenti al giorno di esecuzione del report.
LAST_3_MONTHS Gli ultimi 3 mesi di calendario precedenti al mese di calendario in cui viene eseguito il report.
LAST_6_MONTHS Gli ultimi 6 mesi di calendario precedenti al mese di calendario in cui viene eseguito il report.
LAST_12_MONTHS Gli ultimi 12 mesi di calendario precedenti al mese di calendario in cui viene eseguito il report.
ALL_AVAILABLE Da 3 anni prima dell'esecuzione del report al giorno precedente all'esecuzione del report, inclusi.

Ordina

Rappresenta un ordinamento in un report.

Rappresentazione JSON
{
  "field": {
    object (Field)
  },
  "descending": boolean
}
Campi
field

object (Field)

Obbligatorio. Un campo (dimensione o metrica) in base al quale ordinare.

descending

boolean

Facoltativo. L'ordinamento. Se impostato su true, l'ordinamento sarà decrescente.

Metodi

create

Crea un oggetto Report.

delete

Elimina un oggetto Report.

get

Recupera un oggetto Report.

list

Elenca Report oggetti.

patch

Aggiorna un oggetto Report.

run

Avvia l'esecuzione di un report esistente in modo asincrono.