Datos sin procesar sobre eventos sobre las visitas Una visita se produce cada vez que un consumidor hace clic en un anuncio y se lo redirecciona a una página de destino.
Este informe solo se puede mostrar mediante una solicitud asíncrona (es decir, a través del método Reports.request()).
Debido a que los eventos ocurren en fechas específicas, una solicitud para este informe debe especificar un timeRange. Puedes especificar cualquiera de las siguientes opciones:
- startDate y endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp no es válido para los eventos).
Solicitar extracto
Envía un cuerpo de solicitud Reports.request() normal, pero especifica "reportType": "visit"
.
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Para cada columna que desees mostrar o filtrar en el informe, especifica la columnName
que aparece en la siguiente tabla.
De manera opcional, también puedes especificar headerText, startDate y endDate.
Tenga en cuenta que no se pueden filtrar algunas columnas. Consulte la sección “Filtrable” en la tabla a continuación.
columnName | Descripción | Comportamiento | Tipo | Filtrable |
---|---|---|---|---|
status |
Es 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 |
ID de agencia de DS. | atributo | ID |
Sí |
advertiser |
Nombre del anunciante | atributo | String |
Sí |
advertiserId |
ID del anunciante de DS. | atributo | ID |
Sí |
account |
Nombre de la cuenta de motor. | atributo | String |
Sí |
accountId |
ID de cuenta de motor de DS. | atributo | ID |
Sí |
accountEngineId |
ID de la cuenta en la cuenta de motor externo. | 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 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 un atributo. | atributo | ID |
Sí |
keywordMatchType |
Tipo de concordancia de palabras clave: Broad , Exact , Phrase o Content . |
atributo | Match type |
Sí |
keywordText |
Texto de la 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 ID de grupos de productos. No se deben usar ID de grupos de productos para unirse. | atributo | ID |
Sí |
ad |
Nombre del anuncio. | atributo | String |
Sí |
adId |
ID del anuncio de DS. El valor 0 indica que el anuncio no tiene atribución. | 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 compatible o con una URL de clickserve errónea puede evitar que DS atribuya métricas a un anuncio. | atributo | Boolean |
Sí |
inventoryAccountId |
El ID de la cuenta de inventario de DS que contiene el producto en el que se hizo clic. DS genera este ID cuando se 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 |
Indica el país (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 configuró para el feed de Merchant Center que contiene datos sobre el producto. | atributo | String |
Sí |
productStoreId |
Indica la tienda en la que se hizo clic en el anuncio del inventario local. Debe coincidir con los ID de tienda que se utilizan en su 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 |
ID de visita de DS. | atributo | ID |
Sí |
visitSearchQuery |
La búsqueda que generó esta visita. | atributo | String |
Sí |
visitDate |
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 reúne visitas del 1 de mayo, se cuentan todas las visitas cuyo visitDate es el 1 de mayo. |
atributo | Date |
Sí |
visitTimestamp |
Es la marca de tiempo UTC cuando se realizó la visita. | atributo | Timestamp |
Sí |
visitNetworkType |
Es 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 string única para cada visita que se pasa a la página de destino como el parámetro de URL gclid. Solo está habilitada para anunciantes con integración de la API de conversiones o de Google Analytics. | atributo | String |
Sí |
feedItemId |
Es el ID de la fila de elementos del feed asociada con esta visita. | atributo | ID |
Sí |
feedId |
Es el ID de la tabla de feed asociada con esta visita. | atributo | ID |
Sí |
feedType |
Es el tipo de feed asociado con esta visita. | atributo | Feed type |
Sí |