Dati non elaborati sugli eventi relativi alle visite. Ogni volta che un utente fa clic su un annuncio e viene reindirizzato a una pagina di destinazione, si verifica una visita.
Questo report può essere restituito solo da una richiesta asincrona (ovvero, tramite Reports.request()).
Poiché gli eventi si verificano in date specifiche, una richiesta per questo report deve specificare un timeRange. Puoi specificare uno dei seguenti elementi:
- startDate ed endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp non è valido per gli eventi).
Richiedi estratto
Invia un normale messaggio di errore
Reports.request()
corpo della richiesta, ma specifica "reportType": "visit"
.
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Per ogni colonna che vuoi venga restituita o filtrata nel report,
specificare columnName
nella tabella seguente.
Puoi anche specificare
headerText,
startDate,
ed endDate.
Tieni presente che alcune colonne non possono essere filtrate. consulta "Filtrabile" nella tabella seguente.
columnName | Descrizione | Comportamento | Tipo | Filtrabile |
---|---|---|---|---|
status |
Lo stato della visita. Le visite sono immutabili, pertanto il valore è sempre Active . |
attributo | Status |
Sì |
deviceSegment |
Il segmento di dispositivi a cui è attribuita la visita: Desktop , Mobile , Tablet o Other . |
attributo | Device segment |
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 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 di DS. Il valore 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 visita. Solo le visite provenienti da campagne Shopping hanno ID gruppo di prodotti. Gli ID gruppo di prodotti non devono essere utilizzati per l'unione. | attributo | ID |
Sì |
ad |
Nome annuncio. | attributo | String |
Sì |
adId |
ID annuncio DS. Il valore 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 metriche a un annuncio. | attributo | Boolean |
Sì |
inventoryAccountId |
L'ID account inventario DS contenente il prodotto su cui è stato fatto clic. DS genera questo ID quando colleghi un account spazio pubblicitario in DS. | attributo | ID |
Sì |
productId |
L'ID del prodotto su cui è stato fatto clic. | attributo | String |
Sì |
productCountry |
Il paese (formato ISO 3166) registrato per il feed di inventario contenente 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. che dovrebbe corrispondere agli ID negozio utilizzati nel tuo feed dei prodotti locali. | attributo | String |
Sì |
productChannel |
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, espressa 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 il 1° maggio, conteggia tutte le visite il cui visitDate corrisponde al 1° maggio. |
attributo | Date |
Sì |
visitTimestamp |
Il timestamp UTC del momento 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 del referrer della visita. | attributo | String |
Sì |
visitExternalClickId |
Una stringa univoca per ogni visita passata alla pagina di destinazione come parametro URL gclid. Abilitata solo per gli inserzionisti che hanno integrato l'API Conversion o Google Analytics. | attributo | String |
Sì |
feedItemId |
L'ID della riga dell'elemento del feed associata 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ì |