Tipo di report: visita

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ì