Data Locker para marketers

Reportes disponibles en Data Locker

La estructura de tus datos en el almacenamiento depende de si los datos se envían al almacenamiento en la nube o a un almacén de datos. La estructura de carpetas descrita aquí se aplica al almacenamiento (buckets). En el caso del almacenamiento en almacén de datos, ten en cuenta que la referencia a las carpetas se aplica a las vistas. Consulta Snowflake. 

Los datos se escriben en la opción de almacenamiento seleccionada. En el caso del almacenamiento en la nube, el almacenamiento es propiedad de AppsFlyer en AWS o de tu propiedad en AWS, GCS o Yandex. Puedes cambiar de opción de almacenamiento en cualquier momento o enviar algunos o todos tus datos a varias opciones de almacenamiento. 

Los datos del almacenamiento en el bucket en la nube están organizados en una estructura jerárquica de carpetas, según el tipo de reporte, la fecha y la hora. La siguiente figura contiene un ejemplo7 de esta estructura:

Los datos de un reporte determinado están incluidos en las carpetas de horas (h) asociadas con ese reporte:

• La cantidad de carpetas de horas depende de la actualización de los datos del reporte (por hora, por día o versionado).
• Los datos se proporcionan en archivos comprimidos Snappy o GZIP, o en archivos sin comprimir, que tienen formato Parquet o CSV.
• Los archivos de datos constan de columnas (campos). 
• La estructura del esquema (campo) de los reportes de la trayectoria del usuario es idéntica y depende de los campos seleccionados por ti. Otros reportes tienen cada uno sus propios campos explícitos, también conocidos como reportes sin esquema. Consulta Reportes para marketers de Data Locker para ver los reportes disponibles y los enlaces a las especificaciones del reporte. 

Los archivos de datos dependen del tipo de segregación.

• Los datos se escriben en un propietario de almacenamiento de tu elección de la siguiente manera:
  • Almacenamiento de AppsFlyer
  • Almacenamiento de clientes: AWS, GCS, Azure, Yandex, BigQuery y Snowflake
• Puedes cambiar la selección del almacenamiento en cualquier momento.
• Si cambias el almacenamiento, ocurre lo siguiente:
  • Comenzamos a escribir en el almacenamiento recién seleccionado en una hora.
  • Seguimos escribiendo en el almacenamiento existente durante un período de transición de 7 días. El tiempo de vencimiento del período de transición se muestra en la interfaz de usuario. Usa el período de transición para actualizar tus procesos de carga de datos. Puedes reiniciar el período de transición o volver al bucket de AppsFlyer si es necesario. 
  • Cambio de almacenamiento: puedes migrar de una opción de almacenamiento a otra utilizando la opción de almacenamiento múltiple y enviando datos a varios destinos simultáneamente. Una vez que hayas completado la migración y las pruebas, elimina la opción de almacenamiento que ya no necesitas. 

Aviso a los agentes de seguridad en el caso de almacenamiento controlado por el cliente

Considera:

• El bucket o destino es para uso exclusivo de AppsFlyer. No debe haber ninguna otra entidad que escriba a un destino determinado.
• Puedes eliminar datos en el destino 25 horas después de que escribamos los datos.
• Los datos escritos en el destino son una copia de los datos que ya están en nuestros servidores. Los datos continúan estando en nuestros servidores de acuerdo con nuestra política de retención. 
• Por motivos técnicos, a veces eliminamos y reescribimos los datos. Por esta razón, requerimos permisos de lista y eliminación. Ninguno de estos permisos supone un riesgo de seguridad para ti. En el caso de la lista, somos la única entidad que escribe en el bucket. En el caso de la eliminación, podemos volver a generar los datos.
• Para obtener información adicional, puedes contactar a nuestro equipo de seguridad a través de hello@appsflyer.com o a tu CSM.  

En Data Locker, puedes enviar algunos o todos tus datos a 2 destinos (definidos en la configuración de la conexión). Por ejemplo, puedes enviar los datos de la aplicación A a AWS y los de la aplicación B a GCS.

Cada conexión consiste en un conjunto completo de configuraciones de Data Locker, incluido un destino. Las configuraciones de las conexiones son independientes entre sí.

Al administrar tus conexiones, ten en cuenta lo siguiente:

• En la configuración de Data Locker, las conexiones se muestran en pestañas. Cada conexión tiene su propia pestaña de configuración desde la que puedes administrar la conexión. El icono de cada pestaña representa el tipo de almacenamiento.
• Para ver los detalles de la conexión, duplicar una conexión o eliminar una conexión, haz clic en : (opciones).

Usa este procedimiento para configurar el Data Locker. Todos los cambios en la configuración de Data Locker tardan hasta 3 horas en surtir efecto. 

Requisitos previos

Para configurar el almacenamiento propio del marketer:

Si estás configurando Data Locker utilizando un servicio de almacenamiento en la nube propio del marketer, completa uno o más de los siguientes procedimientos ahora. 

• Configura:
  • Bucket de AWS
  • Bucket de GCS
  • [Beta] Azure Blob
  • [Beta] Bucket de Yandex
  • Almacén de datos de BigQuery
  • Almacén de Snowflake

Nota: Si no tienes una suscripción a Data Locker y accedes a las analíticas de cohortes o a los datos de SKAN, debes completar igualmente un procedimiento de servicio de almacenamiento en la nube propio del marketer. 

Para configurar el Data Locker:

1. Un administrador debe realizar la configuración. 
2. En Appsflyer, accede a Integración > Data Locker. 
3. [Opcional] Si ya tienes un destino de Data Locker activo y quieres agregar un destino, haz clic en Agregar conexión. Asigna un nombre a tu conexión.
4. Selecciona un destino de datos de servicio en la nube. Realiza una de las siguientes acciones:
   
   • Selecciona el bucket de AppsFlyer AWS (opción disponible solo para suscriptores de Data Locker). Haz clic en Guardar y continúa con el paso 5. 
   • Selecciona S3.
     1. Introduce el nombre de tu bucket AWS S3. El prefijo af- es obligatorio, y debe introducirse manualmente.
     2. Haz clic en Probar conexión.
     3. Verifica que no se muestre ningún mensaje de error que indique que la ruta del bucket es inválida.
     4. Selecciona si deseas hacer que esta conexión sea compatible con Adobe Experience Platform. Si lo seleccionas, haz clic en Guardar y continúa con el Paso 6.
     5. Haz clic en Guardar.
   • Selecciona GCS.
     1. Introduce el nombre de tu bucket de GCS.
     2. Haz clic en Probar conexión.
     3. Verifica que no se muestre ningún mensaje de error que indique que la ruta del bucket es inválida.
     4. Selecciona si deseas hacer que esta conexión sea compatible con Adobe Experience Platform. Si lo seleccionas, haz clic en Guardar y continúa con el Paso 6.
     5. Haz clic en Guardar.
   • [Beta] Selecciona Azure.
     1. Ingresa tu nombre de conexión, nombre de cuenta de almacenamiento y clave.
     2. Verifica que no se muestre ningún mensaje de error que indique que la ruta del bucket es inválida.
     3. Selecciona si deseas hacer que esta conexión sea compatible con Adobe Experience Platform. Si lo seleccionas, haz clic en Guardar y continúa con el Paso 6.
     4. Haz clic en Guardar.
   • [Beta] Selecciona Yandex.
     1. Ingresa tu Nombre de bucket, Clave de acceso y Clave secreta.
     2. Verifica que no se muestre ningún mensaje de error que indique que la ruta del bucket es inválida.
     3. Selecciona si deseas hacer que esta conexión sea compatible con Adobe Experience Platform. Si lo seleccionas, haz clic en Guardar y continúa con el Paso 6.
     4. Haz clic en Guardar.
   • Selecciona BigQuery.
     1. Introduce tu ID de proyecto de BigQuery y el nombre del conjunto de datos.
     2. Haz clic en Probar conexión.
     3. Verifica que no se muestre ningún mensaje de error que indique que la ruta del bucket es inválida.
     4. Haz clic en Guardar y continúa con el Paso 6.
   • Selecciona Snowflake.
     1. Introduce tu región de Snowflake y tu ID de cuenta.
     2. Haz clic en Probar conexión.
     3. Verifica que no se muestre ningún mensaje de error que indique que la ruta del bucket es inválida.
     4. Haz clic en Guardar y continúa con el Paso 6.
5. Completa la sección Configuración de datos:
   1. Selecciona el formato de archivo que desees:
      • [Predeterminado] Parquet
      • CSV
   2. Selecciona el tipo de compresión de archivos que desees:
      • Snappy (solo disponible para archivos Parquet)
      • GZIP
      • Sin comprimir
   3. Selecciona el número máximo de filas que quieras en tu archivo: Ya sea 10 000, 25 000, 50 000, 100 000, 200 000 o 500 000. Más filas en el archivo significa menos archivos pero un tamaño de archivo más grande.
   4. Selecciona la estructura de carpetas (segregación de datos):
      • [Predeterminada] Unificada
      • Segregado por aplicación
6. Completa la sección de contenido de Data Locker:
7. Selecciona una o más aplicaciones para incluir en los reportes. Selecciona todo para incluir automáticamente las aplicaciones agregadas en el futuro. 
8. Haz clic en Aplicar. 
9. [Opcional] Selecciona una o más fuentes de medios para incluirlas en los reportes.
   • Predeterminada=All. Significa que las fuentes de medios que agregues en el futuro se agregan automáticamente.
10. Haz clic en Aplicar. 
11. [Opcional] Selecciona los campos que deseas incluir en los reportes. Nota: A veces ponemos a disposición campos adicionales. Ten esto en cuenta en tu proceso de importación de datos.
12. Haz clic en Aplicar. 
13. Selecciona los tipos de reportes. Debes seleccionar al menos 1. 
14. [Opcional] Para el reporte de eventos in-app, selecciona los eventos in-app que deseas incluir. Si tienes más de 100 tipos de eventos in-app, no puedes buscarlos. Introduce sus nombres con precisión para seleccionarlos. 
    • Predeterminada=All. Significa que los eventos in-app que agregues en el futuro se agregan automáticamente.
15. Haz clic en Aplicar. 
16. Haz clic en Guardar conexión. Una de las siguientes situaciones ocurre:
    
    • Si seleccionaste AppsFLyer AWS bucket:
      • Se crea un AWS bucket exclusivo. Se muestran las credenciales del bucket.
      • Se puede acceder al bucket utilizando las credenciales. Las credenciales brindan acceso al bucket solo para lectura.
    • Si seleccionaste uno de tus servicios de almacenamiento en la nube: los datos se escribirán en tu servicio dentro de las 3 horas. 

Un administrador puede restablecer las credenciales del bucket de AppsFlyer en cualquier momento. Nota: Si restableces las credenciales, debes actualizar los scripts de importación de datos con las credenciales actualizadas.

Para restablecer las credenciales del almacenamiento de propiedad de AppsFlyer:

1. En Appsflyer, accede a Integración > Data Locker. 
2. Selecciona el destino propiedad de AppsFlyer.
3. En la sección Credenciales, haz clic en Restablecer credenciales.
   Aparece una ventana de confirmación.
4. Haz clic en Restablecer.
5. Espera aproximadamente 20 segundos hasta que aparezca el mensaje Credenciales restablecidas correctamente.
   Las credenciales actualizadas están disponibles.

• Síntoma: no se pueden recuperar datos con AWS CLI
• Mensaje de error: Se produjo un error (AccessDenied) al solicitar la operación ListObjectsV2 operation: Acceso denegado
• Causa: las credenciales de AWS que se utilizan no son las credenciales correctas para el bucket de AppsFlyer. Esto puede ser causado por tener credenciales múltiples o inválidas en tu máquina. 
• Solución:
  1. Utiliza un método diferente, como Cyberduck, para acceder al bucket, es decir, que no sea CLI. Haz esto para verificar que las credenciales que estás utilizando funcionen. Si puedes conectarte con Cyberduck, esto indica un problema con el caché de credenciales. 
  2. Actualiza el caché de credenciales de AWS.
     Captura de pantalla de AWS

     

Antes de comenzar:

• Instala AWS CLI en tu computadora.
• En AppsFlyer, accede a Data Locker y recupera la información incluida en el panel de credenciales.

Para usar AWS CLI:

1. Abre la terminal. Para hacerlo en Windows, <Windows>+<R>, haz clic en Aceptar.
   Se abre la ventana de línea de comando.
2. Ingresa aws configure.
3. Ingresa la clave de acceso de AWS tal como aparece en el panel de credenciales.
4. Ingresa tu clave secreta de AWS tal como aparece en el panel de credenciales.
5. Ingresa eu-west-1.
6. Presiona Entrar (Ninguno).

Usa los comandos de CLI que siguen según sea necesario.

En los siguientes comandos, se puede encontrar el valor de {home-folder}

Para enumerar carpetas en tu bucket:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/

Enumeración de archivos y carpetas

Hay tres tipos de carpetas en tu bucket de Data Locker:

• Tipo de reporte t=
• Fecha dt=
• Hora h=

Para enumerar todos los reportes de un tipo de reporte específico:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/

Para enumerar todos los reportes de un tipo de reporte específico para un día específico:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17

Para enumerar todos los reportes de un tipo de reporte específico en un hora específica para un día específico:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17/h=23

Para descargar archivos para una fecha específica:

aws s3 cp s3://af-ext-reports/<home-folder>/data-locker-hourly/t=installs/dt=2020-08-01/h=9/part-00000.gz ~/Downloads/

Antes de comenzar:

• Instala el cliente Cyberduck.
• En AppsFlyer, accede a Data Locker y recupera la información incluida en el panel de credenciales.

Para configurar Cyberduck:

1. En Cyberduck, haz clic en Acción.
2. Selecciona Marcador nuevo. Se abre la ventana.
3. En el primer campo (marcado como [1] en la siguiente captura de pantalla), selecciona Amazon S3.

   

4. Completa los campos de la siguiente manera:
   • Apodo: texto libre
   • Servidor: s3.amazonaws.com
   • ID de clave de acceso: copia la clave de acceso de AWS tal como aparece en el panel de credenciales en AppsFlyer.
   • ID de clave secreta: copia la clave secreta del bucket tal como aparece en el panel de credenciales en AppsFlyer.
   • Ruta: {Bucket Name}/{Home Folder} Por ejemplo: af-ext-reports/1234-abc-ffffffff
5. Cierra la ventana. Para ello, haz clic en la X de la esquina superior derecha de la ventana.
6. Selecciona la conexión.
   Se muestran los directorios de datos.

Antes de comenzar:

• Instala el navegador Amazon S3.
• En AppsFlyer, accede a Data Locker y recupera la información incluida en el panel de credenciales.

Para configurar el navegador Amazon S3:

1. En el navegador S3, haz clic en Cuentas > Agregar Cuenta nueva.
   Se abre la ventana Agregar Cuenta Nueva.

   

2. Completa los campos de la siguiente manera:
   • Nombre de cuenta: texto libre. 
   • ID de clave de acceso: copia la clave de acceso de AWS tal como aparece en el panel de credenciales. 
   • Clave secreta de acceso: copia la clave secreta del bucket tal como aparece en el panel de credenciales.
   • Selecciona Cifrar claves de acceso con una contraseña e ingresa una contraseña. Anota esta contraseña.
   • Selecciona Usar transferencia segura.
3.  Haz clic en Guardar cambios.
4. Haz clic en Buckets > Agregar bucket externo.
   Se abre la ventana Agregar Bucket Externo.
   

   

5. Ingresa el Nombre del bucket.El nombre del bucket tiene el siguiente formato: {Bucket Name}/{Home Folder}. Los valores necesarios para el nombre del bucket y la carpeta de inicio aparecen en la ventana de credenciales. 
6. Haz clic en Agregar bucket externo.
   El bucket se crea y se muestra en el panel izquierdo de la ventana.
   Ahora puedes acceder a los archivos de Data Locker.