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 di questo report deve specificare un timeRange. Puoi specificare una delle seguenti opzioni:
- startDate e endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp non è valido per gli eventi).
Estratto della richiesta
Invia un corpo della richiesta
Reports.request()
normale, ma specifica "reportType": "conversion"
.
{
...
"reportType": "conversion",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
Per ogni colonna che vuoi che venga restituita o filtrata nel report,
specifica il valore columnName
elencato nella tabella seguente.
Se vuoi, puoi anche specificare
headerText,
startDate e
endDate.
Tieni presente che alcune colonne non possono essere filtrate; fai riferimento a "Filtrabile" nella tabella di seguito.
columnName | Descrizione | Comportamento | Tipo | Filtrabile |
---|---|---|---|---|
status |
Lo stato della conversione: Active o Removed . |
attributo | Status |
Sì |
deviceSegment |
Il segmento di dispositivo 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 DS Floodlight. | attributo | ID |
Sì |
floodlightGroupTag |
Tag gruppo Floodlight. | attributo | String |
Sì |
floodlightActivity |
Nome dell'attività Floodlight. | attributo | String |
Sì |
floodlightActivityId |
ID attività Floodlight DS. | attributo | ID |
Sì |
floodlightActivityTag |
Tag attività Floodlight. | attributo | String |
Sì |
agency |
Nome dell'agenzia. | attributo | String |
Sì |
agencyId |
ID agenzia DS. | attributo | ID |
Sì |
advertiser |
Nome dell'inserzionista. | attributo | String |
Sì |
advertiserId |
ID inserzionista DS. | attributo | ID |
Sì |
account |
Nome dell'account motore. | attributo | String |
Sì |
accountId |
ID account motore 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 DS. | attributo | ID |
Sì |
productGroupId |
L'ID gruppo di prodotti associato a questa conversione. Solo le conversioni provenienti dalle campagne Shopping hanno ID gruppo di prodotti. Gli ID gruppo di prodotti non devono essere utilizzati per l'unione. | attributo | ID |
Sì |
ad |
Nome dell'annuncio. | attributo | String |
Sì |
adId |
ID annuncio DS. Un valore pari a 0 indica che l'annuncio non è 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 le metriche a un annuncio. | attributo | Boolean |
Sì |
inventoryAccountId |
L'ID account inventario 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 (in formato ISO 3166) registrato per il feed di inventario che contiene 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. che dovrebbe corrispondere agli ID negozio utilizzati nel tuo 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, corrisponde alla colonna conversionId o alla colonna 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 articoli registrati dalla conversione, come determinata dal parametro qty. L'inserzionista è responsabile della compilazione dinamica del parametro (ad esempio il numero di articoli venduti nella conversione), altrimenti il valore predefinito è 1. | attributo | Number |
Sì |
conversionDate |
La data in cui si è verificata la conversione nel fuso orario della rete Campaign Manager. Questa data viene utilizzata per l'aggregazione delle metriche sulle conversioni. Ad esempio, quando il 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 della 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 DS a cui è attribuita la conversione. | attributo | ID |
Sì |
conversionVisitTimestamp |
Il timestamp UTC della visita a cui è attribuita la conversione. | attributo | Timestamp |
Sì |
conversionVisitExternalClickId |
Una stringa univoca per la visita a cui è attribuita la conversione, che viene passata alla pagina di destinazione come parametro URL gclid. Attivato 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 delle modifiche alle istruzioni relative alla valuta Floodlight. | attributo | Money |
Sì |
floodlightEventRequestString |
La stringa di richiesta Floodlight della conversione. | attributo | String |
Sì |
floodlightReferrer |
Il sito web 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ì |