Tipo di report: conversione

Dati non elaborati sugli eventi relativi alle conversioni.

Questo report può essere restituito solo da una richiesta asincrona (ovvero, tramite il metodo Reports.request()).

Poiché gli eventi si verificano in date specifiche, una richiesta per questo report deve specificare un valore timeRange. Puoi specificare una delle seguenti opzioni:

• startDate e endDate.
• changedMetricsFromTimestamp (changedAttributesFromTimestamp non è valido per gli eventi).

Richiedi estratto

Invia un corpo di richiesta Reports.request() standard, ma specifica "reportType": "conversion".

{
...
  "reportType": "conversion",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Per ogni colonna da restituire o filtrare nel report, specifica il valore columnName elencato nella tabella seguente. Facoltativamente, puoi specificare headerText, startDate ed endDate. Tieni presente che alcune colonne non possono essere filtrate; fai riferimento a "Filtrabile" nella tabella seguente.

columnName	Descrizione	Comportamento	Tipo	Filtrabile
status	Lo stato della conversione: Active o Removed.	attributo	Status	Sì
deviceSegment	Il segmento di dispositivi a cui è attribuita la conversione: Desktop, Mobile, Tablet o Other.	attributo	Device segment	Sì
floodlightGroup	Nome del gruppo Floodlight.	attributo	String	Sì
floodlightGroupConversionType	Il tipo di conversioni generate dalle attività Floodlight in questo gruppo: Action o Transaction.	attributo	Conversion type	Sì
floodlightGroupId	ID gruppo Floodlight di DS.	attributo	ID	Sì
floodlightGroupTag	Tag gruppo Floodlight.	attributo	String	Sì
floodlightActivity	Nome attività Floodlight.	attributo	String	Sì
floodlightActivityId	ID attività Floodlight di DS.	attributo	ID	Sì
floodlightActivityTag	Tag attività Floodlight.	attributo	String	Sì
agency	Nome agenzia.	attributo	String	Sì
agencyId	ID agenzia DS.	attributo	ID	Sì
advertiser	Nome inserzionista.	attributo	String	Sì
advertiserId	ID inserzionista DS.	attributo	ID	Sì
account	Nome account motore.	attributo	String	Sì
accountId	ID account motore di DS.	attributo	ID	Sì
accountEngineId	ID dell'account nell'account motore esterno.	attributo	String	Sì
accountType	Tipo di account motore: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu o Comparison Shopping.	attributo	Engine type	Sì
campaign	Nome campagna.	attributo	String	Sì
campaignId	ID campagna DS.	attributo	ID	Sì
campaignStatus	Lo stato della campagna che contiene questo elemento.	attributo	Status	Sì
adGroup	Nome gruppo di annunci.	attributo	String	Sì
adGroupId	ID gruppo di annunci DS.	attributo	ID	Sì
adGroupStatus	Lo stato del gruppo di annunci che contiene questo elemento.	attributo	Status	Sì
keywordId	ID parola chiave DS. Un valore pari a 0 indica che la parola chiave non è attribuita.	attributo	ID	Sì
keywordMatchType	Tipo di corrispondenza delle parole chiave: Broad, Exact, Phrase o Content.	attributo	Match type	Sì
keywordText	Testo della parola chiave.	attributo	String	Sì
productTargetId	ID target di prodotto di DS.	attributo	ID	Sì
productGroupId	L'ID gruppo di prodotti associato a questa conversione. Solo le conversioni generate dalle campagne Shopping sono dotate di ID gruppo di prodotti. Gli ID dei gruppi di prodotti non devono essere utilizzati per partecipare.	attributo	ID	Sì
ad	Nome annuncio.	attributo	String	Sì
adId	ID annuncio DS. Un valore pari a 0 indica che l'annuncio non è stato attribuito.	attributo	ID	Sì
isUnattributedAd	Indica se le metriche in questa riga non sono attribuibili a un annuncio specifico. Ad esempio, un annuncio con un formato non supportato o un URL clickserver errato può impedire a DS di attribuire metriche a un annuncio.	attributo	Boolean	Sì
inventoryAccountId	L'ID account inventario di DS contenente il prodotto associato alla conversione. DS genera questo ID quando colleghi un account inventario in DS.	attributo	ID	Sì
productId	L'ID del prodotto associato a questa conversione.	attributo	String	Sì
productCountry	Il paese (formato ISO 3166) registrato per il feed di inventario contenente il prodotto associato a questa conversione.	attributo	String	Sì
productLanguage	La lingua (ISO 639-1) del prodotto associato a questa conversione.	attributo	String	Sì
productStoreId	Il negozio nell'annuncio di inventario locale associato alla conversione. Deve corrispondere agli ID negozio utilizzati nel feed dei prodotti locali.	attributo	String	Sì
productChannel	Il canale di vendita del prodotto associato alla conversione: Online o Local.	attributo	Product channel	Sì
conversionId	ID generato da Search Ads 360 per ogni conversione.	attributo	ID	Sì
advertiserConversionId	Per le conversioni offline, si tratta di un ID fornito dagli inserzionisti. Se un inserzionista non specifica un ID di questo tipo, Search Ads 360 ne genera uno. Per le conversioni online, questo valore corrisponde alla colonna conversionId o a FloodlightOrderId, a seconda delle istruzioni Floodlight dell'inserzionista.	attributo	String	Sì
conversionType	Il tipo di conversione: Action o Transaction.	attributo	Conversion type	Sì
conversionRevenue	L'importo totale in dollari della conversione.	attributo	Money	Sì
conversionQuantity	La quantità di elementi registrati dalla conversione, determinata dal parametro qty. L'inserzionista è responsabile del completamento dinamico del parametro (ad es. il numero di articoli venduti nella conversione), altrimenti viene impostato su 1 come valore predefinito.	attributo	Number	Sì
conversionDate	La data, nel fuso orario della rete Campaign Manager, in cui si è verificata la conversione. Questa data viene utilizzata per l'aggregazione delle metriche di conversione. Ad esempio, quando DS aggrega le azioni per il 1° maggio, conteggia tutte le conversioni di azioni il cui conversionDate è il 1° maggio.	attributo	Date	Sì
conversionTimestamp	Il timestamp UTC in cui si è verificata la conversione.	attributo	Timestamp	Sì
conversionLastModifiedTimestamp	Il timestamp UTC della modifica più recente della conversione.	attributo	Timestamp	Sì
conversionAttributionType	A cosa viene attribuita la conversione: Visit o Keyword+Ad.	attributo	Conversion attribution type	Sì
conversionVisitId	L'ID visita di DS a cui è attribuita la conversione.	attributo	ID	Sì
conversionVisitTimestamp	Il timestamp UTC della visita a cui viene attribuita la conversione.	attributo	Timestamp	Sì
conversionVisitExternalClickId	Una stringa univoca, per la visita a cui viene attribuita la conversione, che viene trasmessa alla pagina di destinazione come parametro URL gclid. Abilitato solo per gli inserzionisti con integrazione dell'API Conversion o di Google Analytics.	attributo	String	Sì
conversionSearchTerm	Il termine di ricerca che ha generato la conversione.	attributo	String	Sì
floodlightOriginalRevenue	Le entrate originali non modificate associate all'evento Floodlight (nella valuta del report corrente), prima della modifica delle istruzioni della valuta Floodlight.	attributo	Money	Sì
floodlightEventRequestString	La stringa della richiesta Floodlight della conversione.	attributo	String	Sì
floodlightReferrer	Il sito web del referrer Floodlight della conversione.	attributo	String	Sì
floodlightOrderId	L'ID ordine Floodlight fornito dall'inserzionista per la conversione.	attributo	String	Sì
feedItemId	L'ID della riga dell'elemento del feed associato a questa conversione.	attributo	ID	Sì
feedId	L'ID della tabella del feed associata a questa conversione.	attributo	ID	Sì
feedType	Il tipo di feed associato a questa conversione.	attributo	Feed type	Sì