En esta guía, se describe cómo importar datos de costos mediante la API de administración.
Introducción
La importación de datos de costos y clics de campañas pagadas que no pertenecen a Google te permite aprovechar la plataforma de Google Analytics para realizar análisis de ROI y comparar el rendimiento de las campañas con todas tus inversiones en marketing y publicidad en línea.
Antes de comenzar
Antes de comenzar con esta guía, los desarrolladores deben hacer lo siguiente:
- Lee la Guía de importación de datos (Centro de ayuda) para obtener información sobre la función de importación de datos.
- Lee la Guía para desarrolladores sobre la importación de datos a fin de obtener información sobre los conceptos sobre cómo usar la API de Management para importar datos.
- Consulta la referencia de carga de recursos para obtener más información sobre cómo subir datos.
Descripción general
Para importar datos de costos a Google Analytics mediante la API de Management, debes seguir estos pasos:
- URL de las campañas de etiquetas.
- Crea un conjunto de datos.
- Prepara el archivo CSV de datos de costos para subirlo.
- Sube datos de costos mediante la API de Management.
Etiquetar las URL de la campaña
Para realizar un análisis de ROI de las campañas pagadas, los datos de costos de fuentes externas pueden combinarse con los datos de sesiones de Google Analytics. Para ello, agrega parámetros de seguimiento de campañas a todas las URL de destino del sistema de anuncios que no es de Google que utilizas.
Ejemplo
En el siguiente anuncio de ejemplo, la URL de destino está etiquetada con
parámetros de seguimiento de la campaña (utm_campaign
,
utm_source
, utm_medium
, utm_term
).
Esto garantiza que las visitas al sitio web provenientes de los clics en el anuncio estén asociadas con la
campaña de ofertas del verano en Google Analytics.

La tienda de mascotas utilizó la siguiente URL de destino para este anuncio:
http://www.examplepetstore.com?utm_campaign=Summer%2BSale&utm_source=ad%2Bnetwork&utm_medium=cpc&utm_term=dogbone
Cuando el usuario haga clic en el anuncio, se lo dirigirá al sitio web de la tienda de mascotas y se configurarán los siguientes valores en Google Analytics para la sesión:
Nombre de la dimensión en la interfaz web de Google Analytics | Parámetro de seguimiento de la campaña | Valor establecido en Google Analytics |
---|---|---|
Nombre de la campaña | utm_campaign | Ofertas de verano |
Fuente | utm_source | ad network |
Media | utm_medium | CPC |
Keyword | utm_term | hueso para perro |
Esto garantiza que Google Analytics tenga los parámetros de seguimiento de la campaña asociados con la sesión y que exista una manera de unir los datos de Google Analytics con la fuente de datos de costos externos.
Crear un conjunto de datos
Para importar tus datos de costos, debes crear un conjunto de datos. Un conjunto de datos se usa para representar una o más fuentes de datos externas en Google Analytics. Un conjunto de datos solo se puede crear a través de la interfaz web.
En la pestaña Propiedad de la página de administrador, sigue estos pasos:
- Selecciona la pestaña Importación de datos.
- Haga clic en el botón Nuevo conjunto de datos.
- Selecciona los Datos de costos para el tipo y haz clic en Paso siguiente.
- Asigna un nombre al conjunto de datos y selecciona una o más vistas (perfiles) para habilitar el análisis de costos en los informes y haz clic en Paso siguiente.
- Selecciona las Dimensiones y métricas que deseas subir.
- Selecciona el Import Behavior deseado.
- Esta configuración controla si se reemplazan los datos de costos o se suman en casos en los que se encuentra una clave duplicada. Para obtener más información sobre el comportamiento de la importación, consulta la sección Suma de datos de costos vs. reemplazo de la Guía para desarrolladores de importación de datos.
- Haz clic en Guardar.

Prepara el archivo CSV de datos de costos para subirlo
Google Analytics espera que los datos de costos se suban en un formato específico con ciertos valores. Debes asegurarte de que los datos de costos exportados desde una fuente externa cumplan con estos requisitos antes de subirlos.
Las modificaciones y validaciones principales que debes realizar en el archivo CSV son las siguientes:
- Cambie el nombre de los encabezados de columna para que coincidan con los que reconoce Google Analytics. Puedes recuperar el encabezado desde la página de detalles del conjunto de datos en la interfaz web.
- Agregue los valores obligatorios que falten.
- Cuando corresponda, los valores en el archivo CSV deben coincidir con los valores usados para los parámetros de seguimiento de la campaña.
Ejemplo
Con el ejemplo de la tienda de mascotas, los datos se exportan de forma agregada y se guardan como un archivo CSV:

Luego, el archivo CSV se modifica para cumplir con el formato requerido por Google Analytics:

Una vez que hayas preparado el archivo CSV, el formato debe ser similar al siguiente ejemplo:
ga:date,ga:source,ga:medium,ga:campaign,ga:keyword,ga:impressions,ga:adClicks,ga:adCost 20140615,ad network,cpc,Summer Sale,dogbone,9387,288,100.3 20140615,ad network,cpc,Summer Sale,dog treat,1684,52,19.35 20140615,ad network,cpc,Summer Sale,pet store,3187,143,76.23 20140616,ad network,cpc,Summer Sale,dogbone,8754,188,86.21
Consulta la Guía para desarrolladores de importación de datos a fin de conocer las restricciones generales de formato de archivo.
Subir datos de costos con la API de Management
Una vez que hayas creado el conjunto de datos y hayas preparado los datos de costos para subirlos en un archivo CSV, estarás listo para subirlos mediante la API de Management o la interfaz web.
Informes
Los datos de costos subidos estarán disponibles como parte de los informes de análisis de costos en Adquisición en Google Analytics, así como en la API de Core Reporting.