Datos sin procesar sobre eventos 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 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": "conversion"
.
{ ... "reportType": "conversion", "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 |
El estado de la conversión: Active o Removed . |
atributo | Status |
Sí |
deviceSegment |
Indica el segmento del dispositivo al que se atribuye la conversión: Desktop , Mobile , Tablet o Other . |
atributo | Device segment |
Sí |
floodlightGroup |
Nombre del grupo de Floodlight. | atributo | String |
Sí |
floodlightGroupConversionType |
Es el tipo de conversiones generadas por 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 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 |
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 conversión. Solo las conversiones 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 asociado con la conversión. DS genera este ID cuando se vincula una cuenta de inventario en DS. | atributo | ID |
Sí |
productId |
Es el ID del producto asociado con esta conversión. | atributo | String |
Sí |
productCountry |
Indica 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 |
Es el idioma (ISO 639-1) del producto asociado con esta conversión. | atributo | String |
Sí |
productStoreId |
Indica la tienda en el anuncio del inventario local asociado con la conversión. 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 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 |
Para las conversiones sin conexión, se trata de un ID que proporcionan los anunciantes. Si un anunciante no especifica ese ID, Search Ads 360 genera uno. Para 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 |
La cantidad de artículos que registra la conversión, según lo determina el parámetro qty. El anunciante es el responsable de propagar de forma dinámica el parámetro (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 |
Indica la fecha, en la zona horaria de la red de Campaign Manager, cuando ocurrió la conversión. Esta fecha se utiliza para la agregación de la métrica de conversión. Por ejemplo, cuando DS agrega acciones para el 1 de mayo, registra todas las conversiones de acción cuyo conversionDate es el 1 de mayo. |
atributo | Date |
Sí |
conversionTimestamp |
Es la marca de tiempo UTC en la que se generó 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 |
El ID de visita a 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 string única para la visita a la que se atribuye la conversión, 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í |
conversionSearchTerm |
Es el término de búsqueda que generó la conversión. | atributo | String |
Sí |
floodlightOriginalRevenue |
Son los ingresos originales sin cambios asociados con el evento de Floodlight (en la moneda del informe actual), antes de que se modifique la instrucción de la moneda de Floodlight. | atributo | Money |
Sí |
floodlightEventRequestString |
Es la string 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 elemento del feed asociado con esta conversión. | atributo | ID |
Sí |
feedId |
El ID de la tabla de feeds asociada con esta conversión. | atributo | ID |
Sí |
feedType |
Es el tipo de feed asociado con esta conversión. | atributo | Feed type |
Sí |