Dados brutos de eventos sobre visitas. Uma visita ocorre sempre que um consumidor clica em um anúncio e é redirecionado para uma página de destino.
Esse relatório só pode ser retornado por uma solicitação assíncrona (ou seja, por meio do método Reports.request()).
Como os eventos ocorrem em datas específicas, uma solicitação para esse relatório deve especificar um timeRange. É possível especificar uma das seguintes opções:
- startDate e endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp não é válido para eventos).
Trecho da solicitação
Envie uma
Reports.request()
corpo da solicitação, 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 Active. |
atributo | Status |
Sim |
deviceSegment |
O segmento de dispositivo a que a visita é atribuída: 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 na conta de mecanismo externo. | 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 |
O status da campanha que contém esse 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 |
O 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 essa visita. Somente as visitas de campanhas do Shopping têm IDs de grupos de produtos. Os IDs de grupos de produtos não devem ser usados para agrupamento. | 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 foi atribuído. | atributo | ID |
Sim |
isUnattributedAd |
Indica se as métricas nessa linha não podem ser atribuídas a um anúncio específico. Por exemplo, um anúncio com formato não compatí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 no feed de inventário que contém o produto clicado. | atributo | String |
Sim |
productLanguage |
O idioma (ISO 639-1) definido para o feed do Merchant Center que contém os dados sobre o produto. | atributo | String |
Sim |
productStoreId |
A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no 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 de visita do DS. | atributo | ID |
Sim |
visitSearchQuery |
A consulta de pesquisa que gerou esta visita. | atributo | String |
Sim |
visitDate |
A data, no fuso horário da conta de mecanismo, em que a visita ocorreu. Essa data é usada para agregar 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 em UTC de quando a visita ocorreu. | atributo | Timestamp |
Sim |
visitNetworkType |
A rede de publicidade que gerou esta visita: Content, Search ou Other. |
atributo | Network type |
Sim |
visitReferrer |
O URL referenciador da visita. | atributo | String |
Sim |
visitExternalClickId |
Uma string exclusiva para cada visita transmitida à página de destino como o parâmetro de URL gclid. Ativado apenas para anunciantes com integração da API Conversion ou do Google Analytics. | atributo | String |
Sim |
feedItemId |
O ID da linha do item do feed associado a essa visita. | atributo | ID |
Sim |
feedId |
O ID da tabela do feed associada a essa visita. | atributo | ID |
Sim |
feedType |
O tipo de feed associado a essa visita. | atributo | Feed type |
Sim |