Los datos dentro de las fuentes deben cumplir estos requisitos:

• Fecha (solo): aaaa-mm-dd (por ejemplo, 2023-04-18)
• Fecha y hora:
  • Formato: aaaa-MMM-dd hh:mm:ss (por ejemplo, 2023-APR-18 15:30:35)
  • Zona horaria: UTC
• Números: máximo 2 dígitos después del punto decimal
• Longitud de la cadena: máximo 256 caracteres
• Limitaciones de caracteres:
  • Para los nombres de campo (encabezados de columna): sin espacios ni caracteres especiales
  • Todos los demás datos: sin limitaciones (todos los caracteres son válidos)

Además de los datos compartidos para su procesamiento, las tablas fuente en BigQuery o Snowflake deben incluir 2 columnas adicionales: una para la fecha y otra para la versión:

• Fecha:
  • Encabezado de columna: dt
  • Tipo de columna: fecha
  • Formato de los datos: aaaa-mm-dd (por ejemplo, 2023-04-18)
  • Adicional: las tablas de BigQuery deben estar particionadas por esta columna
• Versión:
  • Encabezado de columna: v
  • Tipo de columna: string
  • Formato de los datos: número (por ejemplo, 1, 2, 3, 10)
  • ¡Importante! Una nueva versión de un reporte se activa cada vez que DCR detecta un nuevo valor en esta columna. Para garantizar la integridad de tu reporte, asegúrate de rellenar la tabla de la fuente con un conjunto completo de datos cada vez que se cambie el valor de la columna.

Los archivos de fuentes almacenados en Amazon S3 o GCS deben cumplir los siguientes requisitos de nombre y formato de archivo:

• El nombre del archivo debe cumplir los requisitos de nomenclatura de DCR
• Formato CSV o GZIP
  • El archivo que se encuentra bajo la compresión GZIP debe ser un archivo CSV.
• Número de archivos de fuentes de datos por carpeta de datos:
  • CSV: Máximo: 1
  • GZIP: Máximo de 1 archivo de una sola parte. Los archivos GZIP de varias partes son compatibles cuando se nombran de la siguiente manera: filename_part01.csv.gz, filename_part02.csv.gz, etc.

1. En AppsFlyer, en el menú lateral, selecciona Colaborar > Data Clean Room.
    

   

2. Haz clic en + Nueva fuente (en la página principal o en la pestaña Fuentes).
    

   

3. Procede con los pasos guiados de Nueva fuente :

Introduce el nombre de la fuente. Puede ser cualquier nombre único que te ayude a identificar la fuente. También puedes añadir una descripción opcional sobre la fuente para ayudarte a identificar fácilmente lo que contiene (por ejemplo, «Todas las compras de 2025»).

Requisitos y directrices

• Asegúrate de que el nombre de la fuente sea único entre todas las demás fuentes de tu cuenta. De lo contrario, no podrás guardar la fuente.
• Para las integraciones en la nube, no es necesario que el nombre coincida con el nombre del archivo.
• Requisitos del nombre de la fuente:
  • Longitud: 2-80 caracteres
  • Caracteres válidos:
    • letras (A-Z, a-z)
    • números (0-9), no pueden ser el primer carácter de un nombre;
    • Guion bajo "_"
  • Caracteres inválidos:
    • espacios
    • todos los demás símbolos o caracteres especiales

Para especificar la ubicación de la fuente:

1. Selecciona la conexión en la que se creará (o se ha creado) la fuente.
   • Si no hay conexiones definidas en tu cuenta, se abrirá el cuadro de diálogo Nueva conexión, para que crees una. Sigue estas instrucciones to create it.
   • Si tienes conexiones existentes pero quieres usar una nueva, haz clic en + Nueva conexión y sigue estas instrucciones para crearla.
2. Continúa con las instrucciones relevantes a continuación, en función de dónde se encuentren los datos de tu fuente.

Nota: Para obtener el mejor rendimiento cuando hay un gran volumen de datos, es posible que se almacene por separado un subconjunto de tus datos. Estos datos se actualizarán cada vez que se actualice la fuente y se eliminarán cuando se elimine la fuente.

Fuentes ubicadas en BigQuery

Para terminar de especificar la ubicación de las fuentes de BigQuery:

1. Selecciona el conjunto de datos en el que se encuentra la tabla de la fuente.
2. Selecciona la tabla en la que se encuentran los datos de la fuente.

Las listas a partir de las que haces estas selecciones contienen los conjuntos de datos y tablas disponibles, respectivamente, en el proyecto de BigQuery que especificaste al crear la conexión.

Fuentes ubicadas en Snowflake

Para terminar de especificar la ubicación de las fuentes de Snowflake:

1. Selecciona el recurso compartido que contiene los datos de la fuente.
2. Selecciona el esquema en el que se encuentra la tabla de la fuente.
3. Selecciona la tabla en la que se encuentran los datos de la fuente.

Las listas a partir de las que haces estas selecciones contienen los recursos compartidos, esquemas y tablas, respectivamente, en la cuenta de Snowflake que especificaste al crear la conexión.

Fuentes ubicadas en buckets de almacenamiento en la nube

Las ubicaciones de fuente en Amazon S3 o GCS consisten en el bucket de almacenamiento en la nube especificado por la conexión y la ruta de la carpeta subyacente desde la que DCR lee el archivo de la fuente cada vez que se actualiza. 

Una vez especificada la conexión, AppsFlyer puede generar automáticamente la ruta de la carpeta subyacente requerida como parte del proceso de creación de la fuente.

• Si dejas que AppsFlyer genere las carpetas, el proceso será más sencillo. Sin embargo, si lo prefieres, puedes crearlas manualmente siguiendo las instrucciones detalladas aquí.

Si AppsFlyer genera las carpetas, la única información adicional que necesitas es el nombre que quieres dar a la carpeta fuente. (Esta es la carpeta de nivel superior en la que actualizas la fuente cada vez que quieres usarla para ejecutar una nueva versión del reporte.) También puedes indicar si quieres que la carpeta fuente se cree dentro de una carpeta principal – que a menudo se llama de entrada.

Para terminar de especificar la ubicación de la fuente en un bucket de almacenamiento de datos, introduce el nombre de la carpeta de la fuente.

• Por defecto, el nombre de la carpeta fuente mostrada:
  • Se basa en el nombre que le diste a la fuente. Puedes cambiar el nombre de la carpeta para adaptarlo a tus necesidades, siempre que cumpla los requisitos de nomenclatura de DCR.
  • Indica que se generará dentro de una carpeta principal llamada input. Esta carpeta sirve como carpeta principal para todas las fuentes que cargues en DCR.
    • La carpeta de entrada no es obligatoria, y puedes eliminarla o ponerle otro nombre, siempre que cumpla con los requisitos de nomenclatura de DCR.
    • Aunque esta carpeta no es obligatoria, se considera una buena práctica tener una carpeta de entrada (o una carpeta equivalente con otro nombre). Se recomienda aún más cuando se utiliza el mismo bucket de almacenamiento en la nube, tanto para subir archivos de datos (entrada) como para recibir reportes (salida).

Ubicación de la fuente como archivos locales 

También puedes subir datos de la fuente mediante un archivo local. Sin embargo, se recomienda encarecidamente configurar un servicio en la nube como ubicación de la fuente (algo crucial para conjuntos de datos más grandes y actualizaciones automáticas). Un archivo local se usa principalmente para hacer pruebas y familiarizarte con las funcionalidades de la plataforma. 

Para subir datos de fuente con un archivo local: 

Al seleccionar la ubicación de la fuente, haz clic en Sistema de archivos local y en Siguiente; así se añade la opción de subir archivos locales desde tu dispositivo. 

Al configurar una fuente en la Plataforma de colaboración de datos (DCP), debes elegir cómo quieres que se gestionen las actualizaciones de esa fuente. DCP admite dos métodos de sincronización: Snapshot y Append. Cada método se adapta a distintos casos de uso y flujos de datos:

• Snapshot - Este método sube el conjunto de datos completo cada vez que se actualiza la fuente y sustituye por completo el conjunto de datos anterior por el nuevo. Elige este método solo si tus cargas de archivos siempre contienen el conjunto de datos completo y actualizado.
• Anexar - Este método sube solo datos nuevos o modificados, no el conjunto de datos completo. Los conjuntos de datos antiguos no se eliminan ni se actualizan. Es ideal para cargas recurrentes, como reportes diarios o semanales. Entre las ventajas se incluyen cargas más pequeñas (lo que puede impulsar menores costos de almacenamiento en la nube), un mejor rendimiento de carga de datos, una gestión de registros más sencilla y más.

Requisitos para cargar Snapshot

Usa este método para subir un archivo completo y autónomo que sustituya por completo el conjunto de datos anterior cada vez que se actualice la fuente.

Servicios en la nube compatibles

• Amazon S3
• Google Cloud Storage (GCS)
• BigQuery
• Snowflake

Sigue estas directrices para el método de actualización de instantánea:

1. Ruta de la carpeta de la fuente

   Cuando registras una fuente de almacenamiento en la nube en DCP, se define una ruta raíz (p. ej., input/my_source_folder/) para esa fuente. Cada vez que actualizas el conjunto de datos, subes a esta carpeta una instantánea completa: un archivo que contiene todas las filas actuales. Esto garantiza que DCP siempre procese la vista más actualizada y completa de los datos.

2. Carga de archivos de instantánea completa

/v=1/data/

/v=1/

Estructura de la carpeta:

s3://af-dcr-xyz/abcd9876/input/source_name1/dt=2025-mm-dd/v=1/data/\n└ bucket ┘ └ tenant ┘ └ingestion┘ └source┘└snapshot date┘└ver┘└files┘

Ejemplo de una estructura de instantáneas de dos días:

source_name1/
  dt=2025-08-10/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS
  dt=2025-08-11/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS

Este es un ejemplo de cómo debería verse la estructura de carpetas después de subir una instantánea completa de los archivos fuente durante 2 días (y de crear programáticamente las carpetas de fecha/versión/datos y los archivos _SUCCESS); la estructura de tu bucket/carpetas podría verse así:
 

Requisitos de carga de Append

Usa este método para subir solo los datos que cambiaron o se añadieron desde la carga anterior.

¿Por qué usar Append?

• Eficiencia – cargas más pequeñas
• Integridad de datos – conserva el historial completo de cambios para el análisis de series temporales
• Cumplimiento de la privacidad – simplifica la eliminación de registros & la gestión del consentimiento

Servicios en la nube compatibles: AWS S3 y Google Cloud Storage (GCS)
Nota: BigQuery y Snowflake no son compatibles con el método Append y deben usar el método Snapshot.

Sigue estas directrices para el método de actualización Append:

1. Configuración de la carpeta fuente

2. Cargando archivos append (delta) 

Estructura de la carpeta:

s3://af-dcr-xyz/abcd1234/input/source_name/dt=2025-08-10/\n└ bucket ┘ └ tenant ┘ └ de entrada ┘ └ fuente ┘ └ partición por día ┘

Ejemplo de estructura de carpetas delta semanal:

source_name/
  dt=2025-08-04/
  dt=2025-08-05/
  dt=2025-08-06/
  dt=2025-08-07/
  dt=2025-08-08/
  dt=2025-08-09/
  dt=2025-08-10/

Guía rápida práctica:

Punto clave: Incluso al subir datos semanalmente, organiza siempre los datos en carpetas dt=YYYY‑MM‑DD específicas de cada día.

Asigna los campos de la fuente a los campos de DCP, pruébalo y guarda los datos configurados:

1. Cargar los campos de la fuente
2. Configurar los campos de la fuente
3. Verificar la inclusión de usuarios de la UE
4. Probar los datos de la fuente
5. Guardar la fuente

1. Carga tus  campos de la fuente

Los campos de la fuente se cargan automáticamente. En caso de que sea necesario realizar una carga manual, sigue las instrucciones que aparecen a continuación según la ubicación de la fuente:

Fuentes de almacén de datos

Para cargar campos desde una fuente ubicada en un data warehouse (BigQuery o Snowflake), haz clic en Cargar campos desde la fuente.

Fuentes de bucket de almacenamiento en la nube

Para cargar los campos de una fuente ubicada en un bucket de almacenamiento en la nube (Amazon S3 o GCS), debes subir un archivo de fuente prototipo.

Para asignar los campos de la fuente a los campos de DCP: 

• Puedes cargar una versión prototipo de la fuente desde un archivo local.
  • Si seleccionas esta opción, AppsFlyer siempre crea la ruta de la carpeta fuente automáticamente.

                                                                - o -

• Puedes cargar una versión de prototipo del archivo fuente directamente desde el cloud bucket conectado.
  • Si seleccionas esta opción, tendrás que hacer una elección adicional:
    • Permite que AppsFlyer genere automáticamente la carpeta en la nube para el archivo fuente, o bien
    • Crear manualmente la carpeta en la nube para el archivo fuente

Para cargar el archivo fuente de prototipo, sigue las instrucciones de la pestaña correspondiente a continuación:

2. Configura los campos de la fuente

Después de cargar los campos de la fuente, cada campo de la fuente (columna) se muestra con un campo DCP. Revisa cada campo de la fuente y asígnalo al campo DCP correspondiente en la lista desplegable que aparece junto a él. Ten en cuenta lo siguiente:

Detección del tipo de campo asistida por IA

DCP puede sugerir un campo de DCP para cada columna de la fuente mediante IA, en función del nombre de la columna.

Para activar la detección asistida por IA:

1. En la sección Asignar campos de la fuente, busca el banner: «¿Quieres ayuda para asignar los campos rápidamente?» Activar el Asistente de IA de DCP." Haz clic en Activar el asistente de IA de DCP.
2. Cuando se hayan cargado los campos, haz clic en Detectar automáticamente los tipos de campo. DCP evalúa el nombre de cada columna y sugiere un campo de DCP para ella.
3. Revisa cada sugerencia antes de guardar. Puedes aceptar una sugerencia tal cual o cambiar la asignación manualmente, igual que editarías cualquier otro campo.

Cada campo queda en uno de estos estados:

• Asignado: la IA ha encontrado una única coincidencia fiable. Revísala y acéptala, o cámbiala manualmente.
• No se ha podido asignar: la IA no ha podido determinar un campo. Asígnalo manualmente o déjalo sin asignar.

Limitaciones

• Límite de columnas: la detección por IA es compatible con hasta 100 columnas por fuente. Las fuentes con más columnas muestran un mensaje de «límite superado».
• Longitud del nombre del campo: la detección por IA no es compatible con nombres de columna de más de 100 caracteres.

Para eliminar un campo:

• Coloca el cursor sobre la parte derecha del campo que quieres eliminar y haz clic en el icono de la papelera que aparece al pasar el cursor por encima.

Para añadir campos manualmente:

Esta opción te permite incluir en la audiencia un campo que actualmente no está presente en la fuente de datos.

1. Haz clic en + New field. Se añade un campo vacío.
2. Introduce el nombre del campo y selecciona su tipo.
    

Los tipos de campo incluyen: 

• Identificador
  • Canal de medios atribuido a la visita al sitio web
  • Identificación de AppsFlyer
  • CUID
  • Correo electrónico
  • Correo electrónico hashed
  • Correo electrónico con hash (sin puntos)
  • Identificador de anunciante (IDFA)
  • Dirección IP
  • ID de ID5
  • ID de MediaMath
  • IDs de anuncios móviles
  • Número de teléfono
  • Teléfono con hash (sin signo +)
  • ID de plataforma
  • ID hashed SHA256
  • Número de teléfono SHA256
  • Código postal ZIP+5
  • Código postal ZIP+4
  • LUID
  • ID de persona
• Lista de identificadores
  • Correos electrónicos con hash (sin puntos)
  • Teléfonos con hash (sin signo +)
  • Correo electrónico hashed
  • Teléfonos hash
  • Correos electrónicos
  • Teléfonos
  • IDs de ID5
  • IDs de MediaMath
  • IDs de anuncios móviles
  • IDFA
  • ID de Android
  • Direcciones IP
• Booleano
• Fecha y hora
  • Fecha y hora
  • Fecha
• DMA
  • Representa el número total de engagements (clics, impresiones y otros tipos de engagement) evaluados para un dispositivo determinado en el momento de la conversión.
  • Una agrupación a nivel de negocio que reúne múltiples valores de Platform en categorías más amplias que reflejan la categoría de plataforma en la que ocurrió el evento.
  • Se aplica la DMA de la UE
• Número
  • Double
  • Lista de números
  • Largo
  • Número
• Característica
  • Característica
  • ID de aplicación
  • Lista de texto

Identificador frente a lista de identificadores:

Los tipos de identificador contienen un único valor por fila (por ejemplo, un correo electrónico o un CUID por fila). Los tipos de lista de identificadores contienen una matriz de valores por fila (por ejemplo, una sola fila puede contener varios correos electrónicos con hashing o ID de dispositivo). Usa esto cuando una fuente necesite hacer coincidir más de un identificador por registro.

Recargar campos de la fuente

Si la configuración de uno de tus archivos de datos ha cambiado, puedes actualizar el archivo de la fuente para reflejar los cambios.

Para recargar los campos actualizados desde un archivo:

1. Haz clic en Recargar campos.
2. Selecciona la ubicación del archivo.
   • Para un archivo local: sube el archivo.
   • Para un archivo de tu servicio en la nube: haz clic en Cargar desde cloud bucket y sigue las instrucciones.
3. Haz clic en OK. Ahora se muestran los archivos actualizados. 

3. Verificar la inclusión de usuarios de la UE

• Selecciona Sí o No para la pregunta: ¿Tu fuente incluye usuarios europeos a los que se aplica la normativa DMA de la UE?

Más información sobre la normativa de privacidad de la Ley de Mercados Digitales de la UE.

4. Probar los datos de la fuente

• [Opcional] Haz clic en Test para comprobar si hay errores en el formato o la validez de los campos de la fuente.

5. Guardar la fuente

• Haz clic en Guardar para guardar la fuente.

Después de confirmar, la nueva fuente se añade en la pestaña Sources .

1. Ve a la pestaña Fuentes de Data Clean Room.
2. En la lista de fuentes, coloca el cursor sobre la fuente que quieres editar y haz clic en el icono de edición al final de la fila.
3. En la página Editar fuente, edita los campos correspondientes, como se detalla a continuación.
4. Haga clic en Guardar.

Editar el nombre de la fuente

Al editar el nombre de la fuente, asegúrate de seguir estos requisitos de nomenclatura.

 Editar la ubicación de la fuente

1. En la página Editar fuente > Ubicación de la fuente, selecciona una conexión de datos diferente.
2. Selecciona los detalles de ubicación correspondientes.
3. [Opcional] Probar la fuente.
4. Haga clic en Guardar.

Editar la asignación de campos

1. Ve a la asignación de campos y realiza los cambios necesarios: cambia el campo o actualiza el campo de DCP asignado.
2. Haga clic en Guardar.

Puedes eliminar cualquier fuente, excepto cuando se esté usando en una audiencia. Si este es el caso, una notificación especificará qué audiencias están usando esa fuente. Para poder eliminar la fuente, primero debes eliminar la audiencia vinculada a ella. En cuanto a las fuentes compartidas contigo, solo puede eliminarlas el propietario de la fuente.

1. Ve a la pestaña Fuentes de Data Clean Room.
2. En la lista de fuentes, pasa el cursor por encima de la fila de la fuente que desees eliminar.
3. Haz clic en el icono de eliminación que aparece a la derecha de la fila.
4. En el cuadro de diálogo, haz clic en Delete para confirmar.

En general, es más fácil permitir que AppsFlyer genere automáticamente la estructura de carpetas requerida como parte del proceso de creación de la fuente. Sin embargo, si deseas crear estas carpetas manualmente, puedes hacerlo de la siguiente manera.

Crear una carpeta de claves de DCR

Para garantizar la máxima seguridad, la carpeta directamente debajo del bucket (la "carpeta de clave DCR") debe tener el nombre de la clave DCR alfanumérica de 8 caracteres asignada a tu cuenta (por ejemplo, 01bcc5fb). Ten en cuenta que esta es diferente de cualquier otra contraseña o clave asociada a tu cuenta de AppsFlyer.

Por lo general, la carpeta de claves DCR se crea manualmente utilizando la interfaz del servicio en la nube seleccionado.

Para obtener la clave DCR de tu cuenta:

• Haz clic en el menú de 3 puntos (acciones) de la parte superior derecha y selecciona DCR key.

Después de crear la carpeta de clave DCR, tu estructura de bucket/carpetas se verá así:

Carpeta de entrada de nivel superior

Aunque no es obligatorio, la práctica recomendada es crear una carpeta de entrada de nivel superior directamente debajo de la carpeta de claves DCR. Esta carpeta estará dedicada a los archivos que subas a DCR.

Por lo general, la carpeta de entrada de nivel superior se crea manualmente utilizando la interfaz del servicio en la nube seleccionado.

• Esta práctica es aún más recomendable cuando se utiliza el mismo bucket tanto para cargar archivos de datos (entrada) como para recibir reportes (salida).
• Puedes nombrar esta carpeta como quieras, siempre y cuando cumpla con los requisitos de denominación de DCR. Para facilitar su identificación, suele denominarse input/.

Después de crear la carpeta de entrada de nivel superior, tu estructura de bucket/carpetas se verá así:

Carpeta de segundo nivel para cada fuente de datos

Puedes cargar regularmente diferentes archivos de origen de datos en DCR para su procesamiento. A cada una de estas fuentes de datos se le debe asignar una carpeta separada ("carpetas de origen de datos").

Por ejemplo, si planeas cargar 2 archivos a DCR para procesarlos todos los días: BI-data.csv y CRM-data.gzip, asignarías una carpeta a cada una de estas fuentes de datos. Puedes denominar estas carpetas BI-data/ y CRM-data/.

Por lo general, las carpetas de origen de datos se crean manualmente utilizando la interfaz del servicio en la nube seleccionado.

Después de crear 2 carpetas de origen de datos, tu estructura de bucket/carpetas se verá así:

Debajo de cada carpeta de fuente de datos, se deben crear subcarpetas anidadas por fecha y versión cada vez que se actualice la fuente.

Como parte de la aplicación de la Ley de Mercados Digitales (DMA) por parte de Google, Google actualizó su política de consentimiento de usuarios de la UE el 6 de marzo de 2024. Como partner de atribución de apps de Google, AppsFlyer realizó los cambios necesarios para dar soporte a los requisitos de su política, al tiempo que garantiza que los anunciantes maximicen el valor de sus canales de marketing de Google Ads. 

Añadir campos de consentimiento

Al configurar una fuente destinada a la activación de audiencias en Google y confirmar Sí en la pregunta ¿Tu fuente incluye usuarios europeos sujetos a la normativa DMA de la UE? asegúrate de que los campos de consentimiento adicionales de la tabla siguiente estén incluidos en el archivo de origen. Esto permite a AppsFlyer transferir la información necesaria a Google durante el proceso de activación.

Campos de consentimiento adicionales y sus valores de respuesta:

Posible impacto en el tamaño de la audiencia

El tamaño real y estimado de la audiencia enviada a Google puede variar en función del número de usuarios que otorguen o denieguen su consentimiento.