Method: accounts.networkReport.generate

Genera un report sulla rete AdMob basato sulla specifica del report fornita. Restituisce il risultato di una RPC per il flusso lato server. Il risultato viene restituito in una sequenza di risposte.

Richiesta HTTP

POST https://admob.googleapis.com/v1/{parent=accounts/*}/networkReport:generate

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Nome risorsa dell'account per cui generare il report. Esempio: accounts/pub-9876543210987654

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "reportSpec": {
    object (NetworkReportSpec)
  }
}
Campi
reportSpec

object (NetworkReportSpec)

Specifica del report di rete.

Corpo della risposta

La risposta dinamica per il report sulla Rete AdMob in cui la prima risposta contiene l'intestazione del report, un flusso di risposte di riga e infine un piè di pagina come ultimo messaggio di risposta.

Ad esempio:

[{
  "header": {
    "dateRange": {
      "startDate": {"year": 2018, "month": 9, "day": 1},
      "endDate": {"year": 2018, "month": 9, "day": 1}
    },
    "localizationSettings": {
      "currencyCode": "USD",
      "languageCode": "en-US"
    }
  }
},
{
  "row": {
    "dimensionValues": {
      "DATE": {"value": "20180918"},
      "APP": {
        "value": "ca-app-pub-8123415297019784~1001342552",
         displayLabel: "My app name!"
      }
    },
    "metricValues": {
      "ESTIMATED_EARNINGS": {"microsValue": 6500000}
    }
  }
},
{
  "footer": {"matchingRowCount": 1}
}]

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{

  // Union field payload can be only one of the following:
  "header": {
    object (ReportHeader)
  },
  "row": {
    object (ReportRow)
  },
  "footer": {
    object (ReportFooter)
  }
  // End of list of possible types for union field payload.
}
Campi
Campo di unione payload. Ogni messaggio di risposta in modalità flusso contiene un tipo di payload. payload può essere solo uno dei seguenti:
header

object (ReportHeader)

Impostazioni di generazione di report che descrivono i contenuti del report, ad esempio le impostazioni di localizzazione e l'intervallo di date del report.
row

object (ReportRow)

Dati effettivi del report.
footer

object (ReportFooter)

Informazioni aggiuntive sul report generato, come avvisi sui dati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

NetworkReportSpec

La specifica per la generazione di un report sulla rete AdMob. Ad esempio, la specifica per ottenere clic ed entrate stimate solo per i paesi "US" e "CN" può avere il seguente esempio:

{
  'dateRange': {
    'startDate': {'year': 2021, 'month': 9, 'day': 1},
    'endDate': {'year': 2021, 'month': 9, 'day': 30}
  },
  'dimensions': ['DATE', 'APP', 'COUNTRY'],
  'metrics': ['CLICKS', 'ESTIMATED_EARNINGS'],
  'dimensionFilters': [
    {
      'dimension': 'COUNTRY',
      'matchesAny': {'values': [{'value': 'US', 'value': 'CN'}]}
    }
  ],
  'sortConditions': [
    {'dimension':'APP', order: 'ASCENDING'},
    {'metric':'CLICKS', order: 'DESCENDING'}
  ],
  'localizationSettings': {
    'currencyCode': 'USD',
    'languageCode': 'en-US'
  }
}

Per una migliore comprensione, puoi trattare la specifica precedente come il seguente pseudo SQL:

SELECT DATE, APP, COUNTRY, CLICKS, ESTIMATED_EARNINGS
FROM NETWORK_REPORT
WHERE DATE >= '2021-09-01' AND DATE <= '2021-09-30'
    AND COUNTRY IN ('US', 'CN')
GROUP BY DATE, APP, COUNTRY
ORDER BY APP ASC, CLICKS DESC;
Rappresentazione JSON 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "dimensionFilters": [
    {
      object (DimensionFilter)
    }
  ],
  "sortConditions": [
    {
      object (SortCondition)
    }
  ],
  "localizationSettings": {
    object (LocalizationSettings)
  },
  "maxReportRows": integer,
  "timeZone": string
}
Campi
dateRange

object (DateRange)

L'intervallo di date per il quale viene generato il report.
dimensions[]

enum (Dimension)

Elenco delle dimensioni del report. La combinazione di valori di queste dimensioni determina la riga del report. Se non vengono specificate dimensioni, il report restituisce una singola riga di metriche richieste per l'intero account.
metrics[]

enum (Metric)

Elenco delle metriche del report. Un report deve specificare almeno una metrica.
dimensionFilters[]

object (DimensionFilter)

Descrive a quali righe del report trovare una corrispondenza in base ai relativi valori delle dimensioni.
sortConditions[]

object (SortCondition)

Descrive l'ordinamento delle righe del report. L'ordine della condizione nell'elenco definisce la sua precedenza; prima è la condizione, maggiore è la sua precedenza. Se non vengono specificate condizioni di ordinamento, l'ordinamento delle righe non è definito.
localizationSettings

object (LocalizationSettings)

Impostazioni di localizzazione del report.
maxReportRows

integer

Numero massimo di righe di dati del report da restituire. Se il valore non è impostato, l'API restituisce il maggior numero possibile di righe, fino a un massimo di 100.000. I valori accettati sono compresi tra 1 e 100.000 inclusi. Valori superiori a 100.000 restituiscono un errore.
timeZone

string

Il fuso orario di un report. Accetta i valori del nome IANA TZ, come "America/Los_Angeles". Se non viene definito alcun fuso orario, viene applicata l'impostazione predefinita dell'account. Controlla il valore predefinito mediante l'azione get account.

Attenzione: al momento "America/Los_Angeles" è l'unico valore supportato.

Dimensione

Le dimensioni del report sulla rete. Le dimensioni sono attributi dei dati che consentono di suddividere o perfezionare le misurazioni quantitative (metriche) in base a determinati attributi, come il formato dell'annuncio o la piattaforma su cui è stato visualizzato un annuncio.

Enum
DIMENSION_UNSPECIFIED Valore predefinito per un campo non impostato. Non utilizzare.
DATE Una data nel formato AAAAMMGG (ad es. "20210701"). Nelle richieste è possibile specificare al massimo una dimensione temporale.
MONTH Un mese nel formato AAAAMM (ad es. "202107"). Nelle richieste è possibile specificare al massimo una dimensione temporale.
WEEK La data del primo giorno della settimana nel formato AAAAMMGG (ad es. "20210701"). Nelle richieste è possibile specificare al massimo una dimensione temporale.
AD_UNIT L'ID univoco dell'unità pubblicitaria (ad esempio "ca-app-pub-1234/1234"). Se viene specificata la dimensione AD_UNIT, APP viene inclusa automaticamente.
APP L'ID univoco dell'applicazione per dispositivi mobili (ad esempio "ca-app-pub-1234~1234").
AD_TYPE

Il tipo di annuncio (ad esempio "testo" o "immagine"), una dimensione di pubblicazione dell'annuncio.

Avviso: la dimensione non è compatibile con le metriche AD_REQUESTS, MATCH_RATE e IMPRESSION_RPM.
COUNTRY Il codice paese CLDR del luogo in cui si verificano le visualizzazioni o i clic dell'annuncio (ad es. "US" o "FR"). Questa è una dimensione geografica.
FORMAT Formato dell'unità pubblicitaria (ad esempio "banner", "nativo"), una dimensione di pubblicazione degli annunci.
PLATFORM La piattaforma del sistema operativo per dispositivi mobili dell'app (ad es. "Android" o "iOS").
MOBILE_OS_VERSION Versione del sistema operativo mobile, ad esempio "iOS 13.5.1".
GMA_SDK_VERSION Versione dell'SDK GMA, ad esempio "iOS 7.62.0".
APP_VERSION_NAME Per Android, il nome della versione dell'app si trova in versionName in PackageInfo. Per iOS, il nome della versione dell'app si trova in CFBundleShortVersionString.
SERVING_RESTRICTION Modalità di restrizione per la pubblicazione di annunci (ad es. "Annunci non personalizzati").

Metrica

Le metriche del report di rete. Le metriche sono misurazioni quantitative che indicano l'andamento dell'attività del publisher. Vengono aggregati dai singoli eventi annuncio e raggruppati in base alle dimensioni del report. Il valore della metrica è un numero intero o decimale (senza arrotondamento).

Enum
METRIC_UNSPECIFIED Valore predefinito per un campo non impostato. Non utilizzare.
AD_REQUESTS

Il numero di richieste di annunci. Il valore è un numero intero.

Avviso: la metrica non è compatibile con la dimensione AD_TYPE.
CLICKS Numero di volte in cui un utente fa clic su un annuncio. Il valore è un numero intero.
ESTIMATED_EARNINGS Gli utili stimati del publisher AdMob. L'unità di valuta (USD, EUR o altro) delle metriche relative agli utili è determinata dall'impostazione di localizzazione per la valuta. L'importo è espresso in micro. Ad esempio, 6,50 $ viene rappresentato come 6500000.
IMPRESSIONS Il numero totale di annunci mostrati agli utenti. Il valore è un numero intero.
IMPRESSION_CTR Il rapporto tra clic e impressioni. Il valore è un valore decimale a precisione doppia (approssimativa).
IMPRESSION_RPM

Gli utili stimati per mille impressioni dell'annuncio. Il valore è espresso in micro. Ad esempio, $1,03 viene rappresentato come 1030000. Equivale all'eCPM nell'interfaccia utente di AdMob.

Avviso: la metrica non è compatibile con la dimensione AD_TYPE.
MATCHED_REQUESTS Il numero di volte in cui gli annunci vengono restituiti in risposta a una richiesta. Il valore è un numero intero.
MATCH_RATE

Il rapporto tra le richieste di annunci con corrispondenza e il totale delle richieste di annunci. Il valore è un valore decimale a precisione doppia (approssimativa).

Avviso: la metrica non è compatibile con la dimensione AD_TYPE.
SHOW_RATE Il rapporto tra annunci visualizzati e annunci restituiti, definito come impressioni / richieste con corrispondenza. Il valore è un valore decimale a precisione doppia (approssimativa).

DimensionFilter

Descrive a quali righe del report trovare una corrispondenza in base ai relativi valori delle dimensioni.

Rappresentazione JSON 
{
  "dimension": enum (Dimension),

  // Union field operator can be only one of the following:
  "matchesAny": {
    object (StringList)
  }
  // End of list of possible types for union field operator.
}
Campi
dimension

enum (Dimension)

Applica il criterio di filtro alla dimensione specificata.
Campo di unione operator. Operatore di filtro da applicare. operator può essere solo uno dei seguenti:
matchesAny

object (StringList)

Corrisponde a una riga se il valore per la dimensione specificata è in uno dei valori specificati in questa condizione.

SortCondition

Direzione di ordinamento da applicare a una dimensione o a una metrica.

Rappresentazione JSON 
{
  "order": enum (SortOrder),

  // Union field sort_on can be only one of the following:
  "dimension": enum (Dimension),
  "metric": enum (Metric)
  // End of list of possible types for union field sort_on.
}
Campi
order

enum (SortOrder)

Ordinamento della dimensione o della metrica.
Campo di unione sort_on. Identifica i valori da ordinare. sort_on può essere solo uno dei seguenti:
dimension

enum (Dimension)

Ordina in base alla dimensione specificata.
metric

enum (Metric)

Ordina in base alla metrica specificata.