Domande frequenti (FAQ) sulla segnalazione

La nuova API Search Ads 360 Reporting è ora disponibile. La nuova API fornisce Maggiore flessibilità per la creazione di report personalizzati e l'integrazione dei dati nelle applicazioni di generazione dei report e processi. Scopri di più sulla migrazione e sull'utilizzo dei nuovi report di Search Ads 360 tramite Google Cloud.

Quale deve essere l'ambito del mio report?

Per la maggior parte dei report, ti consigliamo di impostare Reports.reportScope a uno specifico account motore o inserzionista. Per modelli report, ad esempio report sulle parole chiave, sulle conversioni dettagliati, consigliamo di limitare l'ambito a una un account motore specifico. L'API potrebbe restituire errori per report di dimensioni superiori a 10 milioni di righe.

Perché ricevo un errore Forbidden (403)?

Molto probabilmente dovrai ottenere un token OAuth di aggiornamento.

Come faccio a trovare gli ID per agenzie e inserzionisti?

Se non disponi già degli ID delle agenzie e degli inserzionisti, di visualizzare, richiedere un'autorizzazione advertiser il report con le colonne agencyId e advertiserId ma non specificare il reportScope. Search Ads 360 restituirà un elenco di tutti gli ID agenzia e inserzionista che il tuo L'Account Google è autorizzato a visualizzare.

Ecco un esempio di richiesta:

POST  https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
  "reportType": "advertiser",
  "columns": [
    { "columnName": "agency" },
    { "columnName": "agencyId" },
    { "columnName": "advertiser" },
    { "columnName": "advertiserId" }
  ],
  "statisticsCurrency": "usd"
}
        
.
.

Frequenza di aggiornamento dei dati nei report

Alcune metriche sono più aggiornate di altre. Per maggiori dettagli, consulta la sezione Frequenza di aggiornamento dei dati dei report in Search Ads 360?

Per verificare che i report contengano tutte le metriche disponibili, ti consigliamo di attendere circa 4 ore dopo la mezzanotte (fuso orario dell'account motore) prima di richiedere report relativi al giorno precedente metrics; il report conversion, ti consigliamo di attendere 12 ore dopo la mezzanotte (fuso orario dell'inserzionista Campaign Manager). Se utilizzi l'API per caricare i dati sulle conversioni, consulta insert.operation per informazioni dettagliate sulla disponibilità dei dati caricati.

Anche dopo diversi giorni, una metrica può comunque cambiare a causa dei filtri antispam del motore oppure della modalità offline conversioni caricate tramite l'API. Per scaricarli in modo incrementale modifiche, richiesta di report sui dati che sono cambiati dall'ultimo download. Se scarichi dati incrementali modifiche, ti consigliamo di richiedere di tanto in tanto un report completo. Ad esempio: potresti scaricare modifiche incrementali a intervalli di alcuni giorni e poi richiedere un report completo una volta un mese.

Quando verranno visualizzate le modifiche degli attributi nei report?

Ci vuole circa un minuto prima che le modifiche agli attributi apportate da un utente in Search Ads 360 vengano visualizzate in i report scaricati tramite l'API. Le modifiche vengono apportate direttamente sul motore esterno (non tramite Search Ads 360) dovranno essere importati in Search Ads 360 utilizzando la sincronizzazione in entrata.

Ti consigliamo di restituire solo i dati che sono cambiati per determinare quali entità presentano modifiche agli attributi.

Che cosa sono gli annunci e le parole chiave non attribuiti?

A volte Search Ads 360 non può attribuire metriche a un annuncio specifico. Ad esempio, un annuncio con un formato non supportato o un URL clickserver con un errore possono impedire a Search Ads 360 di attribuire metriche a un annuncio. Per ogni gruppo di annunci, Search Ads 360 segnala qualsiasi metrica non attribuita come appartenente a un "annuncio non attribuito". Per richiedere queste metriche in un report, imposta includeRemovedEntities a true. Per semplificare la visualizzazione di quali annunci non sono attribuiti, includi la classe isUnattributedAd nella richiesta.

Analogamente, talvolta Search Ads 360 non può attribuire metriche a una parola chiave specifica. Questo accade quando si verificano discrepanze nei report. In questi casi, La colonna keywordId per le parole chiave non attribuite è impostata su 0.

I report includono conversioni in scala?

In alcuni casi è difficile misurare le conversioni, ad esempio quando i cookie del sito web che memorizzano le informazioni sui clic sugli annunci non sono disponibili a causa di vari fattori, tra cui le impostazioni del browser. In questi casi, Floodlight utilizza la scalabilità per tenere conto dei dati sulle conversioni che non possono essere misurate direttamente. In altre parole, Floodlight applica il machine learning ai dati storici per modellare Numero di conversioni e importo delle entrate derivanti dalle conversioni che non possono essere misurati. Floodlight può poi aggiungi la stima risultante alle metriche di conversione per fornire un quadro più completo in che modo la tua pubblicità genera conversioni.

Floodlight applica sempre la scalabilità alle seguenti colonne dei report:

  • dfaActions
  • dfaRevenue
  • dfaTransactions
  • dfaWeightedActions
  • Colonne salvate generare report sulle attività Floodlight

La conversion non include le conversioni in scala. Mostra solo le conversioni misurate strato Add. Il numero di conversioni e l'importo delle entrate in un report conversion non si prevede che corrispondano alle conversioni e alle entrate riportate nelle colonne sopra elencate.

Perché le conversioni non elaborate non vengono sommate alla metrica aggregata X?

Nel raro caso in cui le metriche aggregate non siano d'accordo con gli eventi non elaborati in Search Ads 360, considera metrica aggregata. Durante il calcolo degli aggregati di metriche, Search Ads 360 tenta di sanificare i dati da fonti rimuovendo le conversioni che sospetta siano duplicati.

Cosa succede se la mia domanda non ha una risposta in questo articolo?

Se c'è un problema che non riesci a risolvere dopo aver letto le risorse di questo sito, contattare l'assistenza e chiedere le seguenti informazioni:

  • ID agenzia e ID inserzionista Search Ads 360 a cui stai tentando di accedere

  • Numero del progetto dalla console API di Google

  • Il nome utente dell'Account Google che utilizzi per accedere all'API.
    Questo è l'account a cui è stato assegnato per accedere a Search Ads 360, che è lo stesso account che utilizzi configurare l'autorizzazione.

  • Snippet di codice della richiesta

  • Risposta JSON
    Se la risposta è un errore, assicurati di includere il messaggio di errore e non solo un codice di errore numerico.