- Risorsa: Report
- ReportDefinition
- Dimensione
- Metrica
- Filtro
- FieldFilter
- Campo
- Operazione
- ReportValue
- IntList
- StringList
- DoubleList
- FilterList
- TimeZoneSource
- DateRange
- FixedDateRange
- Data
- RelativeDateRange
- Ordina
- Metodi
Risorsa: Report
La risorsa Report.
| Rappresentazione JSON |
|---|
{
"name": string,
"reportId": string,
"reportDefinition": {
object ( |
| Campi | |
|---|---|
name |
Identificatore. Il nome della risorsa del report. Il nome della risorsa del report ha il seguente formato: |
reportId |
Solo output. ID report. |
reportDefinition |
Obbligatorio. La definizione del report. |
displayName |
Facoltativo. Nome visualizzato del report. |
updateTime |
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: |
createTime |
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: |
locale |
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 ( |
| Campi | |
|---|---|
dimensions[] |
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[] |
Obbligatorio. L'elenco delle metriche per cui generare report. Se il campo è vuoto, il report non conterrà metriche. |
filters[] |
Facoltativo. I filtri per questo report. |
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 |
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 |
Facoltativo. Il codice valuta ISO 4217 per questo report. Se non specificato, il valore predefinito è il codice valuta dell'account. |
dateRange |
Obbligatorio. L'intervallo di date principale di questo report. |
sorts[] |
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 ( |
| 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 |
Un filtro su un singolo campo. |
notFilter |
Un filtro il cui risultato è negato. |
andFilter |
Un elenco di filtri i cui risultati vengono combinati con l'operatore AND. |
orFilter |
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 ( |
| Campi | |
|---|---|
field |
Obbligatorio. Il campo in base al quale applicare il filtro. |
operation |
Obbligatorio. L'operazione di questo filtro. |
values[] |
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 ( |
| 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 |
La dimensione rappresentata da questo campo. |
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 ( |
| 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 |
Per i valori interi. |
doubleValue |
Per i valori doppi. |
stringValue |
Per i valori di stringa. |
boolValue |
Per i valori booleani. |
intListValue |
Per gli elenchi di valori interi. |
stringListValue |
Per gli elenchi di valori di stringa. |
doubleListValue |
Per elenchi di valori double. |
bytesValue |
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[] |
I valori |
StringList
Un elenco di valori di stringa.
| Rappresentazione JSON |
|---|
{ "values": [ string ] } |
| Campi | |
|---|---|
values[] |
I valori |
DoubleList
Un elenco di valori double.
| Rappresentazione JSON |
|---|
{ "values": [ number ] } |
| Campi | |
|---|---|
values[] |
I valori |
FilterList
Un elenco di filtri.
| Rappresentazione JSON |
|---|
{
"filters": [
{
object ( |
| Campi | |
|---|---|
filters[] |
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 ( |
| 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 |
Un intervallo di date fisso. |
relative |
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 ( |
| Campi | |
|---|---|
startDate |
Obbligatorio. La data di inizio di questo intervallo di date. |
endDate |
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:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| Rappresentazione JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Campi | |
|---|---|
year |
Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno. |
month |
Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno. |
day |
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 ( |
| Campi | |
|---|---|
field |
Obbligatorio. Un campo (dimensione o metrica) in base al quale ordinare. |
descending |
Facoltativo. L'ordinamento. Se impostato su true, l'ordinamento sarà decrescente. |
Metodi |
|
|---|---|
|
Crea un oggetto Report. |
|
Elimina un oggetto Report. |
|
Recupera un oggetto Report. |
|
Elenca Report oggetti. |
|
Aggiorna un oggetto Report. |
|
Avvia l'esecuzione di un report esistente in modo asincrono. |