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ì |