Datos de eventos sin procesar sobre las visitas. Se produce una visita cada vez que un consumidor hace clic en un anuncio y se lo redirecciona a una página de destino.
Este informe solo puede mostrarse a través de una solicitud asíncrona (es decir, mediante el Reports.request()).
Debido a que los eventos ocurren en fechas específicas, la solicitud de este informe debe especificar una timeRange. Puedes especificar cualquiera de las siguientes opciones:
- startDate y endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp no es válida para los eventos).
Solicitar extracto
Enviar un
Reports.request()
de la solicitud, pero especifica "reportType": "visit"
.
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Para cada columna que quieras que se muestre o se filtre en el informe,
especifica los columnName
que se indican en la siguiente tabla.
También puedes especificar
headerText
startDate,
y endDate.
Ten en cuenta que algunas columnas no se pueden filtrar. consulta "Filtrable" en la siguiente tabla.
columnName | Descripción | Comportamiento | Tipo | Filtrable |
---|---|---|---|---|
status |
El estado de la visita. Las visitas son inmutables, por lo que siempre es Active . |
atributo | Status |
Sí |
deviceSegment |
El segmento de dispositivo al que se atribuye la visita: Desktop , Mobile , Tablet o Other . |
atributo | Device segment |
Sí |
agency |
Nombre de la agencia. | atributo | String |
Sí |
agencyId |
Es el ID de la agencia de DS. | atributo | ID |
Sí |
advertiser |
Es el nombre del anunciante. | atributo | String |
Sí |
advertiserId |
ID del anunciante de DS. | atributo | ID |
Sí |
account |
Nombre de la cuenta de buscador. | atributo | String |
Sí |
accountId |
ID de la cuenta de motor de DS. | atributo | ID |
Sí |
accountEngineId |
ID de la cuenta de la cuenta de motor externa. | atributo | String |
Sí |
accountType |
Tipo de cuenta de motor: Google AdWords , Bing Ads , Yahoo Japan Listing Ads , Yahoo Search Marketing , Yahoo Gemini , Baidu o Comparison Shopping . |
atributo | Engine type |
Sí |
campaign |
Nombre de la campaña. | atributo | String |
Sí |
campaignId |
ID de la campaña de DS. | atributo | ID |
Sí |
campaignStatus |
El estado de la campaña que contiene este elemento. | atributo | Status |
Sí |
adGroup |
Nombre del grupo de anuncios. | atributo | String |
Sí |
adGroupId |
ID del grupo de anuncios de DS. | atributo | ID |
Sí |
adGroupStatus |
El estado del grupo de anuncios que contiene este elemento. | atributo | Status |
Sí |
keywordId |
ID de palabra clave de DS. El valor 0 indica que la palabra clave no tiene atribución. | atributo | ID |
Sí |
keywordMatchType |
Tipo de concordancia de palabras clave: Broad , Exact , Phrase o Content . |
atributo | Match type |
Sí |
keywordText |
Texto de palabra clave | atributo | String |
Sí |
productTargetId |
ID de la orientación de producto de DS. | atributo | ID |
Sí |
productGroupId |
Es el ID del grupo de productos asociado con esta visita. Solo las visitas de las campañas de Shopping tienen IDs de grupos de productos. Los IDs de grupos de productos no deben usarse para unirse. | atributo | ID |
Sí |
ad |
Nombre del anuncio. | atributo | String |
Sí |
adId |
ID del anuncio de DS. Un valor de 0 indica que el anuncio no se atribuye. | atributo | ID |
Sí |
isUnattributedAd |
Indica si las métricas de esta fila no se pueden atribuir a un anuncio específico. Por ejemplo, un anuncio con un formato no admitido o una URL de servidor de clics errónea puede impedir que DS atribuya métricas a un anuncio. | atributo | Boolean |
Sí |
inventoryAccountId |
Es el ID de la cuenta de inventario de DS que contiene el producto en el que se hizo clic. DS genera este ID cuando vincula una cuenta de inventario en DS. | atributo | ID |
Sí |
productId |
El ID del producto en el que se hizo clic. | atributo | String |
Sí |
productCountry |
Es el país (en formato ISO 3166) registrado para el feed de inventario que contiene el producto en el que se hizo clic. | atributo | String |
Sí |
productLanguage |
El idioma (ISO 639-1) que se estableció para el feed de Merchant Center que contiene datos sobre el producto. | atributo | String |
Sí |
productStoreId |
Indica la tienda del anuncio del inventario local en el que se hizo clic. Debe coincidir con los IDs de tienda que se usan en el feed de productos locales. | atributo | String |
Sí |
productChannel |
El canal de ventas del producto en el que se hizo clic: Online o Local . |
atributo | Product channel |
Sí |
visitId |
Es el ID de visita de DS. | atributo | ID |
Sí |
visitSearchQuery |
La búsqueda que generó esta visita. | atributo | String |
Sí |
visitDate |
Es la fecha, en la zona horaria de la cuenta de motor, en la que se produjo la visita. Esta fecha se usa para la agregación de visitas. Por ejemplo, cuando DS agrega las visitas del 1 de mayo, cuenta todas las visitas cuyo visitDate es el 1 de mayo. |
atributo | Date |
Sí |
visitTimestamp |
Es la marca de tiempo UTC del momento en que ocurrió la visita. | atributo | Timestamp |
Sí |
visitNetworkType |
La red de publicidad que generó esta visita: Content , Search o Other . |
atributo | Network type |
Sí |
visitReferrer |
La URL de referencia de la visita. | atributo | String |
Sí |
visitExternalClickId |
Una cadena única para cada visita que se pasa a la página de destino como el parámetro de URL gclid. Solo se habilita para los anunciantes con integración de la API de conversiones o de Google Analytics. | atributo | String |
Sí |
feedItemId |
Es el ID de la fila del elemento del feed asociado con esta visita. | atributo | ID |
Sí |
feedId |
El ID de la tabla del feed asociada con esta visita. | atributo | ID |
Sí |
feedType |
Es el tipo de feed asociado con esta visita. | atributo | Feed type |
Sí |