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 (encabezado 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 de fuentes 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: cadena
  • Formato de los datos: número (por ejemplo, 1, 2, 3, 10)
  • Nota: 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 1 archivo de una sola parte. Se admiten archivos GZIP de varias partes cuando se nombran de la siguiente forma: filename_part01.csv.gz, filename_part02.csv.gz, etc.

1. En AppsFlyer, desde el menú lateral, ve a Colaborar > Data Clean Room.
    

   

2. Haz clic en + New source (en la página principal o en la pestaña Sources).
    

   

3. Procede con los pasos del recorrido de la 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 ayudar 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 creó) la fuente.
   • Si no hay conexiones definidas en tu cuenta, se abrirá el cuadro de diálogo Nueva conexión, pidiéndote que crees una. Sigue estas instrucciones para crearla.
   • Si tienes conexiones existentes pero quieres usar una nueva, haz clic en + New connection 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 un subconjunto de tus datos se almacene por separado. 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.

• Permitir que AppsFlyer genere las carpetas facilita el proceso. Sin embargo, puedes optar por crearlas manualmente en su lugar, de acuerdo con las instrucciones detalladas aquí.

Si AppsFlyer genera las carpetas, la única información adicional requerida es el nombre que deseas dar a la carpeta fuente. (Esta es la carpeta de nivel superior en la que se actualiza la fuente cada vez que desees utilizarla para ejecutar una nueva versión del reporte). También puedes indicar si deseas que la carpeta fuente se cree debajo de una carpeta principal, a menudo denominada input.

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 denominada input. Esta carpeta sirve como carpeta principal para todas las fuentes que cargues en DCR.
    • La carpeta input no es obligatoria y puedes eliminarla o asignarle un nombre diferente, siempre y cuando cumpla con los requisitos de nomenclatura de DCR.
    • Aunque esta carpeta no es obligatoria, se considera una buena práctica disponer de una carpeta input (o una carpeta equivalente con un nombre diferente). 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 cargar 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 (fundamental para conjuntos de datos más grandes y actualizaciones automáticas). Un archivo local se usa principalmente para fines de prueba y para familiarizarte con las funcionalidades de la plataforma. 

Para cargar datos de la fuente mediante un archivo local: 

Al seleccionar la ubicación de la fuente, haz clic en Local file system y en Next, lo que añade la opción de cargar 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 carga el conjunto de datos completo cada vez que se actualiza la fuente y sustituye por completo el conjunto de datos anterior por el nuevo en cada actualización. Elige este método solo si tus cargas de archivos siempre contienen el conjunto de datos completo y actualizado.
• Append - Este método carga solo los datos nuevos o modificados, no el conjunto de datos completo. Los conjuntos de datos antiguos no se eliminan ni se actualizan. Ideal para cargas recurrentes como reportes diarios o semanales. Entre las ventajas se incluyen cargas más pequeñas (lo que puede reducir los costos de almacenamiento en la nube), un rendimiento de carga de datos más rápido, una gestión de registros más sencilla y más.

Requisitos para cargar Snapshot

Usa este método para subir un archivo completo e independiente 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 (por ejemplo, input/my_source_folder/) para esa fuente. Cada vez que actualizas el conjunto de datos, subes una instantánea completa—un archivo que contiene todas las filas actuales—a esta carpeta. Esto garantiza que DCP siempre procese la vista más reciente 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/
└ bucket ┘ └ tenant ┘ └ingesta┘ └fuente┘└fecha de la instantánea┘└versión┘└archivos┘

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

fuente_name1/\n  dt=2025-08-10/\n    v=1/\n      data/\n        snapshot.parquet\n      _SUCCESS\n  dt=2025-08-11/\n    v=1/\n      data/\n        snapshot.parquet\n      _SUCCESS

Después de cargar una instantánea completa de los archivos fuente de 2 días (y de crear programáticamente carpetas de fecha/versión/datos y archivos _SUCCESS), tu estructura de bucket/carpetas podría tener este aspecto:
 

Requisitos de carga de Append

Usa este método para cargar 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 los 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. Carga de archivos de anexo (delta)

Estructura de la carpeta:

s3://af-dcr-xyz/abcd1234/input/source_name/dt=2025-08-10/\n└ bucket ┘ └ tenant ┘ └ ingesta ┘ └ fuente ┘ └ partición diaria ┘

Ejemplo de estructura de carpetas de 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/

Hoja de referencia rápida:

Punto clave: Incluso si haces cargas semanales, organiza siempre los datos en carpetas dt=YYYY‑MM‑DD específicas por día.

Mapea los campos de la fuente con los campos de DCP, pruébalo y guarda los datos configurados:

1. Carga los campos de tu fuente
2. Configura los campos de la fuente
3. Verifica la inclusión de usuarios de la UE
4. Prueba 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. Si es necesario cargar los campos manualmente, 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 de una fuente ubicada en un almacén de datos (BigQuery o Snowflake), haz clic en Cargar campos de 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.

A efectos de mapear los campos de la fuente con 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 subir una versión prototipo del archivo de 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
    • Crea 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:

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.