Dopo aver configurato l'app client come descritto in La mia prima app, puoi utilizzare l'API Search Ads 360 per richiedere e scaricare i report. Puoi effettuare uno dei seguenti tipi di richieste:
- Sincrono
Richiede una sola richiesta e restituisce il report in una risposta in formato JSON. Richieste sincrone:
- Può restituire solo report su inserzionista e account motore
- Blocca il cliente finché Search Ads 360 non genera il report
Se richiedi report su inserzionisti o account motore di grandi dimensioni, ti consigliamo l'approccio asincrono.
- Asincrono
Richiede l'invio di una richiesta iniziale in cui sono specificati i dati che vuoi inserire nel report. Dopodiché, invia richieste aggiuntive per eseguire il sondaggio in Search Ads 360. Quando Search Ads 360 termina di generare il report, invii le richieste per scaricare il report come uno o più file. Richieste asincrone:
- Può restituire qualsiasi tipo di report
- Esegue lo sharding dei report di grandi dimensioni in più file
- Report sui formati come CSV o TSV
Modello dei dati: righe e colonne
Search Ads 360 organizza i dati in un report in righe e colonne. Il tipo di report richiesto determina le righe che vengono restituite. Ad esempio, se richiedi un report sulle parole chiave, ogni riga conterrà dati relativi a una singola parola chiave. Consulta il riferimento Tipi di report per un elenco di tutti i tipi di report. Specifica le colonne da inserire nel report assegnando un nome a ciascuna colonna nella richiesta di report. Consulta il riferimento Tipi di report per visualizzare l'elenco delle colonne che è possibile restituire per ogni tipo di report.
Comportamenti delle colonne
Il comportamento di una colonna dipende dal tipo di dati contenuti nella colonna (il riferimento Tipi di report mostra il comportamento di ciascuna colonna):
Colonne degli attributi: Una colonna di attributi contiene dati che configurano o identificano un'entità in una campagna, ad esempio il nome della campagna o un'offerta per parola chiave. L'API Search Ads 360 restituisce sempre il valore corrente per una colonna degli attributi, indipendentemente dalla data o dall'intervallo di date specificato in una richiesta. Ad esempio, se ieri hai modificato l'offerta per una parola chiave da 2,00 a 1,50 e poi richiedi un report con i dati del mese scorso, il report restituirà un valore pari a 1,50 per l'offerta per parola chiave.
Colonne delle metriche. Una colonna di metriche contiene dati sul rendimento della tua campagna, come il numero di clic su un annuncio, il numero di visite registrate da un tag Floodlight o le entrate. A meno che non specifichi un intervallo di tempo di un singolo giorno, l'API restituisce un valore aggregato per le colonne delle metriche. Ad esempio, se richiedi un report con i dati del mese scorso, l'API restituirà il numero totale di clic per l'ultimo mese.
Segmenta le colonne: Una colonna di segmenti suddivide i dati in righe separate. Ad esempio,
date
è una colonna di segmento che puoi specificare per molti tipi di report. Se specifichi la colonnadate
in un report sulle parole chiave con un intervallo di date compreso tra il 2013-01-01 e il 2013-01-07, l'API restituirebbe sette righe per ogni parola chiave, ciascuna corrispondente a un giorno e mostrerà le metriche per quel giorno. Consulta Report segmentati.
Valute
La tua richiesta di report deve specificare la valuta dei dati monetari (entrambi gli attributi come dailyBudget
e metriche come
cost
). Puoi specificare una delle seguenti opzioni:
- La valuta dell'agenzia, se il report ha come ambito un'agenzia, un inserzionista o un account motore.
- La valuta dell'inserzionista, se l'ambito del report è un inserzionista o un account motore.
- La valuta dell'account motore, se l'ambito del report è un account motore.
- €
Utilizza la proprietà della richiesta Reports.request.statisticsCurrency
per specificare una valuta.
Il report indicherà la valuta nella proprietà Reports.statisticsCurrencyCode
.
Fuso orario
Le metriche di Search Ads 360 vengono memorizzate in date senza fusi orari. Queste date corrispondono al fuso orario dell'account motore per le metriche del motore (come clic, impressioni e visite) e al fuso orario della rete Campaign Manager per le metriche di conversione (come azioni, transazioni ed entrate). Se ogni metrica di un report proviene dallo stesso fuso orario,
tale fuso orario verrà restituito nella richiesta. In caso contrario, non verrà restituito alcun fuso orario.
Le tue richieste possono impostare Reports.request.verifySingleTimeZone: true
in modo che non vengano generati report in cui sono presenti metriche relative a più fusi orari.
Se tutte le metriche presenti in un report provengono da un fuso orario, questo
viene restituito in Reports.statisticsTimeZoneReports
.