Dados brutos de eventos sobre visitas. Uma visita ocorre sempre que um consumidor clica em um anúncio e é redirecionado à página de destino.
Esse relatório só pode ser retornado por uma solicitação assíncrona (ou seja, pelo método Reports.request()).
Como os eventos ocorrem em datas específicas, uma solicitação para esse relatório precisa especificar um timeRange. É possível especificar uma das seguintes opções:
- startDate e endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp não é válido para eventos)
Trecho de solicitação
Envie um corpo de solicitação Reports.request(), mas especifique "reportType": "visit".
{
...
"reportType": "visit",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
Para cada coluna que você quer retornar ou filtrar no relatório,
especifique o columnName listado na tabela abaixo.
Também é possível especificar
headerText,
startDate e
endDate.
Algumas colunas não podem ser filtradas. Consulte "Filtrável" na tabela abaixo.
columnName | Descrição | Comportamento | Tipo | Filtrável |
|---|---|---|---|---|
status |
O status da visita. As visitas são imutáveis. Portanto, sempre será Active. |
atributo | Status |
Sim |
deviceSegment |
É o segmento do dispositivo atribuído a uma visita: Desktop, Mobile, Tablet ou Other. |
atributo | Device segment |
Sim |
agency |
Nome da agência. | atributo | String |
Sim |
agencyId |
ID da agência do DS. | atributo | ID |
Sim |
advertiser |
Nome do anunciante. | atributo | String |
Sim |
advertiserId |
ID do anunciante do DS. | atributo | ID |
Sim |
account |
Nome da conta de mecanismo. | atributo | String |
Sim |
accountId |
ID da conta de mecanismo do DS. | atributo | ID |
Sim |
accountEngineId |
ID da conta externa. | atributo | String |
Sim |
accountType |
Tipo de conta de mecanismo: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu ou Comparison Shopping. |
atributo | Engine type |
Sim |
campaign |
Nome da campanha. | atributo | String |
Sim |
campaignId |
ID da campanha do DS. | atributo | ID |
Sim |
campaignStatus |
Status da campanha que contém este item. | atributo | Status |
Sim |
adGroup |
Nome do grupo de anúncios. | atributo | String |
Sim |
adGroupId |
ID do grupo de anúncios do DS. | atributo | ID |
Sim |
adGroupStatus |
Status do grupo de anúncios que contém esse item. | atributo | Status |
Sim |
keywordId |
ID de palavra-chave do DS Um valor de 0 indica que a palavra-chave não está atribuída. | atributo | ID |
Sim |
keywordMatchType |
Tipo de correspondência de palavra-chave: Broad, Exact, Phrase ou Content. |
atributo | Match type |
Sim |
keywordText |
O texto da palavra-chave. | atributo | String |
Sim |
productTargetId |
ID do destino de produto do DS. | atributo | ID |
Sim |
productGroupId |
O ID do grupo de produtos associado a esta visita. Somente visitas de campanhas do Shopping têm IDs de grupo de produtos. Os IDs dos grupos de produtos não devem ser usados para mesclagem. | atributo | ID |
Sim |
ad |
Nome do anúncio. | atributo | String |
Sim |
adId |
ID do anúncio do DS. Um valor de 0 indica que o anúncio não está atribuído. | atributo | ID |
Sim |
isUnattributedAd |
Indica se as métricas nessa linha não são atribuíveis a um anúncio específico. Por exemplo, um anúncio com um formato incompatível ou um URL do servidor de cliques incorreto pode impedir que o DS atribua métricas a um anúncio. | atributo | Boolean |
Sim |
inventoryAccountId |
O ID da conta de inventário do DS que contém o produto que recebeu o clique. O DS gera esse código quando você vincula uma conta de inventário no DS. | atributo | ID |
Sim |
productId |
O ID do produto clicado. | atributo | String |
Sim |
productCountry |
O país (formato ISO 3166) registrado para o feed de inventário que contém o produto clicado. | atributo | String |
Sim |
productLanguage |
O idioma (ISO 639-1) que foi definido para o feed do Google Merchant Center que contém dados sobre o produto. | atributo | String |
Sim |
productStoreId |
A loja no anúncio de inventário local que recebeu o clique. Ele deve corresponder aos IDs de loja usados no seu feed de produtos locais. | atributo | String |
Sim |
productChannel |
O canal de vendas do produto que foi clicado: Online ou Local. |
atributo | Product channel |
Sim |
visitId |
ID da visita do DS. | atributo | ID |
Sim |
visitSearchQuery |
A consulta de pesquisa que gerou essa visita. | atributo | String |
Sim |
visitDate |
A data, no fuso horário da conta de mecanismo, em que a visita ocorreu. Essa data é usada para agregação de visitas. Por exemplo, quando o DS agrega visitas para 1o de maio, ele conta todas as visitas com visitDate como 1o de maio. |
atributo | Date |
Sim |
visitTimestamp |
O carimbo de data/hora UTC quando a visita ocorreu. | atributo | Timestamp |
Sim |
visitNetworkType |
A rede de publicidade que gerou a visita: Content, Search ou Other. |
atributo | Network type |
Sim |
visitReferrer |
O URL referenciador da visita. | atributo | String |
Sim |
visitExternalClickId |
Uma string única para cada visita que é transmitida para a página de destino como o parâmetro de URL gclid. Ativada somente para anunciantes com integração da API Conversion ou do Google Analytics. | atributo | String |
Sim |
feedItemId |
O código da linha do item do feed associada a esta visita. | atributo | ID |
Sim |
feedId |
O ID da tabela de feed associada a esta visita. | atributo | ID |
Sim |
feedType |
O tipo de feed associado a esta visita. | atributo | Feed type |
Sim |