[GA4] Cómo recopilar datos proporcionados por el usuario (gtag.js)

Esta función forma parte de una versión beta abierta y está sujeta a cambios.

Estas instrucciones son para los administradores y editores que activaron la recopilación de datos proporcionados por el usuario y desean comenzar a enviar este tipo de datos desde un sitio web usando gtag.js.

Before you begin

You must turn on user-provided data collection in Google Analytics.

Elige cómo identificar los datos proporcionados por el usuario

1. En Administrar, en Recopilación y modificación de datos, haz clic en Flujos de datos.
   Nota: El vínculo anterior abre la última propiedad de Analytics a la que accediste. Debes acceder a una Cuenta de Google para poder abrir la propiedad. Puedes cambiar de propiedad con el selector de propiedades. Debes ser editor o tener un rol de nivel superior a nivel de la propiedad para establecer tu configuración de datos proporcionados por el usuario.
   
2. Selecciona el flujo de datos web que deseas.
3. En Etiqueta de Google, haz clic en Establecer configuración de etiquetas > Permitir funciones de datos proporcionados por el usuario.
4. Habilita Permitir las funciones de datos proporcionados por el usuario.
   
5. Elige una o más formas de identificar los datos proporcionados por el usuario:

   Opción	Descripción
   Detecta automáticamente los datos proporcionados por el usuario	Google Analytics revisa tus páginas web en busca de cadenas que coincidan con el patrón de una dirección de correo electrónico. Los números de teléfono y las direcciones se excluyen de la opción. Te recomendamos que la complementes con las siguientes opciones.
   Especifica selectores CSS o variables de JavaScript	Selecciona los tipos de datos proporcionados por el usuario que deseas recopilar, como direcciones de correo electrónico o números de teléfono. Para cada tipo de datos, selecciona cómo deseas identificarlos en la página: con un selector CSS o una variable global de JavaScript. Más información sobre esta opción Este método es más preciso que la detección automática de los datos proporcionados por el usuario, pero no es tan confiable como agregar un fragmento de código a tu sitio web. Si cambias el código de tu sitio web con frecuencia, en especial los selectores CSS o de formato en la página de recopilación, considera agregar un fragmento de código a tu sitio web.
   Agrega un fragmento de código a tu sitio web	Agrega código JavaScript a tus páginas web para recopilar direcciones de correo electrónico, números de teléfono o nombres y direcciones. Luego, configura el parámetro user_data para cada evento en la página. Más información sobre esta opción

6. Haz clic en Guardar.

Campos que puedes establecer

En la siguiente tabla, se describen todos los campos que puedes establecer. El nombre de la clave muestra cómo debes hacer referencia al campo en tu código. Debes pasar los datos como cadena. Cuando definas el nombre y la dirección, asegúrate de definir cada componente como una variable individual (por ejemplo, nombre, apellido, etcétera).

Nota: Si deseas enviar datos sin codificación hash y permitir que Google los normalice y les aplique esta codificación, usa el primer nombre de clave para cada campo de datos, por ejemplo, email en el campo de datos Dirección de correo electrónico que aparece a continuación. Si deseas enviar datos con codificación hash, usa el nombre de clave que comienza con sha256_.

Campo de datos	Nombre de la clave	Descripción
Dirección de correo electrónico	email	Es el correo electrónico del usuario. Ejemplo: "[e-mail]".
	sha256_email_address	Es el correo electrónico del usuario con codificación hash. Ejemplo: ‘a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db’
Número de teléfono	phone_number	Es el número de teléfono del usuario. Debe tener el formato E.164, es decir, debe tener entre 11 y 15 dígitos, incluidos un prefijo de signo más (+) y un código de país sin guiones, paréntesis ni espacios. Ejemplo: "[phone]"
	sha256_phone_number	Es el número de teléfono del usuario con codificación hash. Ejemplo: "e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1".
Nombre	address.first_name	Es el nombre del usuario. Ejemplo: "Juan".
	address.sha256_first_name	Es el nombre del usuario con codificación hash. Ejemplo: "96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a".
Apellido	address.last_name	Es el apellido del usuario. Ejemplo: "Pérez".
	address.sha256_last_name	Es el apellido del usuario con codificación hash. Ejemplo: "799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f".
Dirección	address.street	Es la dirección del usuario. Ejemplo: "Av. San Martín 123".
Ciudad	address.city	Es el nombre de la ciudad del usuario. Ejemplo: "Southampton".
Región	address.region	Es la provincia, el estado o la región del usuario. Ejemplo: "Hampshire".
Código postal	address.postal_code	Es el código postal del usuario. Ejemplo: "SO99 9XX"
País	address.country	Es el código de país del usuario. Ejemplo: "UK". Utiliza los códigos de país de dos letras de la norma ISO 3166-1 alfa-2.