Datos de eventos sin procesar sobre las conversiones
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 de 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 un extracto
Envía un cuerpo de solicitud Reports.request() normal, pero especifica "reportType": "conversion"
.
{ ... "reportType": "conversion", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Para cada columna que quieras que se muestre o filtre en el informe, especifica el columnName
que se indica en la siguiente tabla.
De manera opcional, también puedes especificar
headerText,
startDate y
endDate.
Ten en cuenta que no se pueden filtrar algunas columnas. Consulta "Filtrable" en la siguiente tabla.
columnName | Descripción | Comportamiento | Tipo | Filtrable |
---|---|---|---|---|
status |
Es el estado de la conversión: Active o Removed . |
atributo | Status |
Sí |
deviceSegment |
Es el segmento de dispositivos al que se atribuye la conversión: Desktop , Mobile , Tablet o Other . |
atributo | Device segment |
Sí |
floodlightGroup |
Es el nombre del grupo de Floodlight. | atributo | String |
Sí |
floodlightGroupConversionType |
Es el tipo de conversiones que generan las actividades de Floodlight en este grupo: Action o Transaction . |
atributo | Conversion type |
Sí |
floodlightGroupId |
ID del grupo de Floodlight de DS. | atributo | ID |
Sí |
floodlightGroupTag |
Etiqueta del grupo de Floodlight. | atributo | String |
Sí |
floodlightActivity |
Es el nombre de la actividad de Floodlight. | atributo | String |
Sí |
floodlightActivityId |
ID de la actividad de Floodlight de DS. | atributo | ID |
Sí |
floodlightActivityTag |
Etiqueta de actividad de Floodlight | atributo | String |
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 |
Es el nombre de la cuenta de motor. | atributo | String |
Sí |
accountId |
ID de la cuenta del 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 |
Es el estado de la campaña que contiene este artículo. | atributo | Status |
Sí |
adGroup |
Nombre del grupo de anuncios. | atributo | String |
Sí |
adGroupId |
ID del grupo de anuncios de DS. | atributo | ID |
Sí |
adGroupStatus |
Es el estado del grupo de anuncios que contiene este elemento. | atributo | Status |
Sí |
keywordId |
ID de palabra clave de DS. Un valor de 0 indica que la palabra clave no tiene 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 segmentación del producto de DS. | atributo | ID |
Sí |
productGroupId |
Es el ID del grupo de productos asociado con esta conversión. Solo las conversiones de las campañas de Shopping tienen IDs de grupo de productos. No se deben usar los IDs de grupos de productos para unir productos. | atributo | ID |
Sí |
ad |
Es el 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 |
El ID de la cuenta de inventario de DS que contiene el producto asociado con la conversión DS genera este ID cuando vinculas una cuenta de inventario en DS. | atributo | ID |
Sí |
productId |
Es el ID del producto asociado con esta conversión. | atributo | String |
Sí |
productCountry |
Es el país (formato ISO 3166) registrado para el feed de inventario que contiene el producto asociado con esta conversión. | atributo | String |
Sí |
productLanguage |
El idioma (ISO 639-1) del producto asociado a esta conversión | atributo | String |
Sí |
productStoreId |
Es la tienda del anuncio del inventario local asociada con la conversión. 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 asociado con la conversión: Online o Local . |
atributo | Product channel |
Sí |
conversionId |
Es el ID que genera Search Ads 360 para cada conversión. | atributo | ID |
Sí |
advertiserConversionId |
En el caso de las conversiones sin conexión, se trata de un ID que proporcionan los anunciantes. Si un anunciante no especifica ese ID, se genera uno mediante Search Ads 360 En el caso de las conversiones en línea, esto es igual a la columna conversionId o a la columna floodlightOrderId según las instrucciones de Floodlight del anunciante. | atributo | String |
Sí |
conversionType |
Es el tipo de conversión: Action o Transaction . |
atributo | Conversion type |
Sí |
conversionRevenue |
Es el importe total en dólares de la conversión. | atributo | Money |
Sí |
conversionQuantity |
Es la cantidad de artículos que registra la conversión, según lo determinado por el parámetro qty. El anunciante es responsable de propagar los parámetros de forma dinámica (como la cantidad de artículos que se venden en la conversión). De lo contrario, el valor predeterminado es 1. | atributo | Number |
Sí |
conversionDate |
Es la fecha, en la zona horaria de la red de Campaign Manager, en la que se produjo la conversión. Esta fecha se usa para la agregación de métricas de conversión. Por ejemplo, cuando el DS agrega acciones para el 1 de mayo, cuenta todas las conversiones de acción cuyo conversionDate es 1 de mayo. |
atributo | Date |
Sí |
conversionTimestamp |
Es la marca de tiempo en UTC del momento en que ocurrió la conversión. | atributo | Timestamp |
Sí |
conversionLastModifiedTimestamp |
Es la marca de tiempo (UTC) de la modificación más reciente de la conversión. | atributo | Timestamp |
Sí |
conversionAttributionType |
A qué se atribuye la conversión: Visit o Keyword+Ad . |
atributo | Conversion attribution type |
Sí |
conversionVisitId |
Es el ID de visita de DS al que se atribuye la conversión. | atributo | ID |
Sí |
conversionVisitTimestamp |
Es la marca de tiempo (UTC) de la visita a la que se atribuye la conversión. | atributo | Timestamp |
Sí |
conversionVisitExternalClickId |
Es una cadena única para la visita a la que se atribuye la conversión; esta se pasa a la página de destino como el parámetro de URL gclid. Solo está habilitada para los anunciantes que tienen integración con la API de conversiones o con Google Analytics. | atributo | String |
Sí |
conversionSearchTerm |
Es el término de búsqueda que generó la conversión. | atributo | String |
Sí |
floodlightOriginalRevenue |
Los ingresos originales sin cambios asociados con el evento de Floodlight (en la moneda del informe actual), antes de las modificaciones de la instrucción de la moneda de Floodlight. | atributo | Money |
Sí |
floodlightEventRequestString |
Es la cadena de solicitud de Floodlight de la conversión. | atributo | String |
Sí |
floodlightReferrer |
El sitio web de referencia de Floodlight de la conversión. | atributo | String |
Sí |
floodlightOrderId |
Es el ID de pedido de Floodlight que proporciona el anunciante para la conversión. | atributo | String |
Sí |
feedItemId |
Es el ID de la fila del artículo del feed asociada con esta conversión. | atributo | ID |
Sí |
feedId |
Es el ID de la tabla del feed asociada con esta conversión. | atributo | ID |
Sí |
feedType |
Es el tipo de feed asociado con esta conversión. | atributo | Feed type |
Sí |