Dati non elaborati sugli eventi relativi alle visite. Una visita si verifica ogni volta che un consumatore fa clic su un annuncio e viene reindirizzato a una pagina di destinazione.
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": "visit"
.
{ ... "reportType": "visit", "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 visita. Le visite sono immutabili, quindi sono sempre Active . |
attributo | Status |
Sì |
deviceSegment |
Il segmento dispositivo a cui è attribuita la visita: Desktop , Mobile , Tablet o Other . |
attributo | Device segment |
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 visita. Solo le visite provenienti dalle campagne Shopping hanno gli 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 su cui è stato fatto clic. DS genera questo ID quando colleghi un account inventario in DS. | attributo | ID |
Sì |
productId |
L'ID del prodotto selezionato. | attributo | String |
Sì |
productCountry |
Il paese (formato ISO 3166) registrato per il feed di inventario che contiene il prodotto su cui è stato fatto clic. | attributo | String |
Sì |
productLanguage |
La lingua (ISO 639-1) impostata per il feed di Merchant Center contenente i dati sul prodotto. | attributo | String |
Sì |
productStoreId |
Il negozio nell'annuncio di inventario locale su cui è stato fatto clic. Deve corrispondere agli ID negozio utilizzati nel feed dei prodotti locali. | attributo | String |
Sì |
productChannel |
Il canale di vendita del prodotto su cui è stato fatto clic: Online o Local . |
attributo | Product channel |
Sì |
visitId |
ID visita DS. | attributo | ID |
Sì |
visitSearchQuery |
La query di ricerca che ha generato questa visita. | attributo | String |
Sì |
visitDate |
La data, nel fuso orario dell'account motore, in cui si è verificata la visita. Questa data viene utilizzata per l'aggregazione delle visite. Ad esempio, quando DS aggrega le visite per il 1° maggio, conteggia tutte le visite il cui visitDate è il 1° maggio. |
attributo | Date |
Sì |
visitTimestamp |
Il timestamp UTC in cui si è verificata la visita. | attributo | Timestamp |
Sì |
visitNetworkType |
La rete pubblicitaria che ha generato questa visita: Content , Search o Other . |
attributo | Network type |
Sì |
visitReferrer |
L'URL referrer della visita. | attributo | String |
Sì |
visitExternalClickId |
Una stringa univoca per ogni visita 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ì |
feedItemId |
L'ID della riga dell'elemento del feed associato a questa visita. | attributo | ID |
Sì |
feedId |
L'ID della tabella del feed associata a questa visita. | attributo | ID |
Sì |
feedType |
Il tipo di feed associato a questa visita. | attributo | Feed type |
Sì |