[GA4] Importar eventos offline

Acerca de los datos de eventos offline

Puede importar eventos offline de fuentes que no tengan conexión a Internet o que no permitan recoger eventos en tiempo real a través de SDKs o de Measurement Protocol. Una vez subidos estos eventos, se procesan como si se hubieran recogido a través de nuestros SDKs, con la marca de tiempo que usted proporcione o, si no indica ninguna, con la marca del momento de la subida.

Puede importar cualquier evento que coincida con los que Analytics recoge de forma automática o los que recomendamos para distintos verticales. También puede usar cualquier elemento personalizado que tenga el formato correcto (ya sea un evento, un parámetro o una propiedad de usuario). Más información

Para eliminar estos datos es necesario enviar una solicitud de eliminación de datos o usuarios.

Cómo funciona la importación de datos de eventos offline

Para importar eventos offline, debe crear un archivo CSV que siga el esquema de eventos de Analytics. Consulte la plantilla de ejemplo que aparece abajo.

Crear dimensiones personalizadas

Si importa valores de dimensiones que aún no existen en Analytics y quiere ver esos datos en los informes, tendrá que crear esas dimensiones antes de subir los datos. Más información

Una vez que haya creado las dimensiones personalizadas, Analytics tarda hasta cuatro horas en poder empezar a reconocer los datos que importe. Para verificar que las dimensiones personalizadas se procesan, abra una exploración y compruebe si las dimensiones están disponibles en el selector de dimensiones.

Crear un archivo CSV

Use la plantilla que se muestra más abajo como guía para crear un archivo CSV con los datos de eventos.

Subir datos

El procedimiento general de subida se describe en el artículo Acerca de Importación de datos.

Cuando cree la fuente de datos, seleccione Datos de eventos offline.

En el caso de los eventos offline, los campos importados se asignan automáticamente a los campos de Analytics.

Una vez que suba los datos, Analytics puede tardar hasta 24 horas en incluirlos en informes, audiencias y exploraciones.

Al eliminar una fuente de datos del servicio de subida de datos, los datos que se suben no se eliminan. Si es necesario, al igual que ocurre con las demás formas de recogida de datos, puede que tenga que solicitar una eliminación de datos para que se eliminen los datos que se hayan subido con el método Importación de datos.

Detalles de las fuentes de datos

Leyenda

Ámbito	Evento
Campos obligatorios	client_id o app_instance_id tag_id o firebase_app_id tag_id y client_id, o bien firebase_app_id y app_instance_id event_name
Datos importados	Puede subir datos de cualquier evento, parámetro, artículo o propiedad de usuario con los siguientes formatos de encabezado: timestamp_micros (opcional; debe ser una marca de tiempo dentro de las 72 horas posteriores al evento y, si no se proporciona, será la del momento de la subida) user_id (opcional, pero recomendamos usarlo cuando está disponible) señales de consentimiento (opcional, pero muy recomendable cuando están disponibles). Más información event_param.<xxxxx> (importa cualquier parámetro de cualquier nombre) user_property.<yyyyy> (importa cualquier propiedad de usuario de cualquier nombre) item<x>.<item_param> (es decir, item2.item_name)
Notas	No se puede utilizar la importación de eventos offline para subir información personal identificable ni para asociar ese tipo de información con los datos importados. Más información

 

Plantilla

A continuación, se incluye un ejemplo de plantilla CSV con datos de eventos. Si necesita crear manualmente los archivos que va a subir, guíese por este ejemplo.

measurement_id	client_id	user_id	timestamp_micros	ad_personalization	ad_user_data	event_name	event_param.page_location	event_param.page_referrer	event_param.page_title	event_param.screen_resolution	user_property.color_score	event_param.foo	item1.item_id	item1.item_name	item1.category	item1.item_list_id	item1.item_list_name	item1.index	item1.quantity	item1.price	item2.item_id	item2.item_name	item2.quantity	item2.price	event_param.transaction_id	event_param.value	event_param.tax	event_param.shipping	event_param.currency
G-12345ABCDE	1234567890.0987654321	1000001	1609488000000000	GRANTED	DENIED	page_view	/home	referrer.com	Página principal	1600x900	blue	1-2
G-12345ABCDE	1234567890.0987654321	1000001	1609488060000000	DENIED	DENIED	page_view	/video_detail		Reproductor de vídeo	1600x900	blue	1-4
G-12345ABCDE	1234567890.0987654321	1000001	1609488120000000	DENIED	GRANTED	video_play	/video_detail		Reproductor de vídeo	1600x900	blue
G-67890ABCDE	2345678901.9876543210	1000002	1609574400000000	DENIED	GRANTED	page_view	/home	referrer.com	Página principal	2560x1440	green	2-2
G-67890ABCDE	2345678901.9876543210	1000002	1609574460000000	DENIED	GRANTED	page_view	/product_detail		Detalles del producto	2560x1440	green	2-16
G-67890ABCDE	2345678901.9876543210	1000002	1609574520000000	GRANTED	GRANTED	page_view	/product_detail		Detalles del producto	2560x1440	green
G-67890ABCDE	121212.3434	1000003	1609574520000000	GRANTED	GRANTED	page_view	/camp_lp_1	referrer.com	Rebajas de verano	2560x1440	blue	3-1
G-67890ABCDE	121212.3434	1000003	1609660801000000	GRANTED	DENIED	view_item_list	/camp_lp_1		Rebajas de verano	2560x1440	blue		123abc	red_shoe	shoe	list_123	colorful_shoes	1	1		234bcd	blue_shoe	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660860000000	GRANTED	GRANTED	select_item	/camp_lp_1		Rebajas de verano	2560x1440	blue		234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660870000000	GRANTED	GRANTED	page_view	/product_detail		Detalles del producto	2560x1440	blue	3-5	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660930000000	DENIED	GRANTED	view_item	/product_detail		Detalles del producto	2560x1440	blue	3-17	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660950000000	DENIED	DENIED	add_to_cart	/product_detail		Detalles del producto	2560x1440	blue		234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660970000000	GRANTED	DENIED	begin_checkout	/product_detail		Detalles del producto	2560x1440	blue		234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660975000000	GRANTED	DENIED	page_view	/purchase_confirmation		Enhorabuena	2560x1440	blue	3-21	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660980000000	GRANTED	DENIED	purchase	/purchase_confirmation		Enhorabuena	2560x1440	purple	3-21	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00					t12345	37.49	2.50	4.99	USD

 

Descargar la plantilla de importación CSV con eventos sin conexión

Límites

Se rechazarán los eventos, parámetros y propiedades de usuario que utilicen nombres reservados.

También se rechazarán los parámetros de eventos relativos a artículos si esos parámetros no tienen ningún valor (por ejemplo, item_list_name). Los parámetros de eventos relativos a artículos son compatibles con un subconjunto de eventos recomendado (por ejemplo, Comercio electrónico, Empleo o Viajes).

Los nombres de los eventos y de los parámetros deben cumplir las siguientes reglas:

• Los eventos pueden tener un máximo de 25 parámetros.
• Los eventos pueden tener un máximo de 25 propiedades de usuario.
• Los nombres de las propiedades de usuario deben tener 24 caracteres como máximo.
• Los valores de las propiedades de usuario deben tener 36 caracteres como máximo.
• Los nombres de los eventos deben tener 40 caracteres como máximo (solo pueden contener caracteres alfanuméricos y guiones bajos) y deben empezar por un carácter alfabético.
• Los nombres de los parámetros (incluidos los parámetros relativos a artículos) deben tener 40 caracteres como máximo (solo pueden contener caracteres alfanuméricos y guiones bajos) y deben empezar por un carácter alfabético.
• Los valores de los parámetros (incluidos los valores de los parámetros relativos a artículos) deben tener un máximo de 100 caracteres.