Data Locker para anunciantes

De un vistazo: Data Locker escribe los datos de tus reportes en el almacenamiento en la nube para cargarlos en tus sistemas de Business Intelligence. Las diferentes opciones de almacenamiento te permiten seleccionar entre un bucket propiedad de AppsFlyer en AWS o un bucket de tu propiedad en AWS o GCS. Data Locker es una solución que admite múltiples aplicaciones. 

6133DataLockerForAdvertisers.png

Lectura relacionada: Selección de la herramienta de entrega de raw data adecuada 

Data Locker

Data Locker escribe tus datos de AppsFlyer en el almacenamiento en la nube. Selecciona las aplicaciones, las fuentes de medios, los eventos y los reportes necesarios para incluirlos en los datos. Carga los datos programáticamente en tus sistemas de Business Intelligence. 

Data Locker: funciones

Característica Descripción
Opciones de almacenamiento (nube)

Hay varias opciones de almacenamiento disponibles. Puedes alternar entre las opciones en cualquier momento. Las diferencias entre las opciones se relacionan con el proveedor de servicios en la nube y la propiedad del bucket. Opciones disponibles: 

Aplicaciones múltiples 

Envía datos de 1, más o todas las aplicaciones de tu cuenta. Cuando agregas aplicaciones a la cuenta, se pueden incluir automáticamente. 

Segregación de datos

 

Opciones de segregación de datos disponibles

  • [Predeterminado] Unificado: datos de todas las aplicaciones combinadas. El campo ID de aplicación a nivel fila se utiliza para identificar la aplicación en archivos de datos. 
  • Segregados por aplicación: los datos de cada aplicación se encuentran en una carpeta independiente. El nombre de la carpeta es el ID de la aplicación. 
Actualización de los datos

La actualización depende del tipo de reporte 

  • Por hora: los datos se generan continuamente; por ejemplo, los datos de instalaciones y eventos in-app se escriben dentro de las horas posteriores a la llegada del evento a AppsFlyer. 
  • Diaria: algunos reportes, por ejemplo, desinstalaciones, se generan a diario y están listos al día siguiente. 
Reportes exclusivos de Data Locker
  • Datos no convertidos: datos de clics e impresiones de UA y campañas de retargeting. Acerca de los clics e impresiones
  • Raw data de SKAdNetwork está disponible en el almacenamiento que tú posees sin necesidad de una suscripción a Data Locker. 
Archivos de datos de ejemplo

Clics, Instalaciones, Eventos in-app 

Reportes: trayectoria del usuario

Para obtener una descripción de los tipos de reportes, consulta los reportes de trayectoria del usuario.

 
Categoría Tipo de reporte (tema) Actualización de los datos* Orgánico/No-orgánico Exclusivo del Data Locker
La adquisición de usuarios Clics  Demora de 6 horas N/A
Retargeting Clics Demora de 6 horas N/A
La adquisición de usuarios Impresiones Demora de 6 horas N/A
Retargeting Impresiones Demora de 6 horas N/A
La adquisición de usuarios Instalaciones Demora de 6 horas Ambos  
La adquisición de usuarios Eventos in-app  Demora de 6 horas Ambos  
La adquisición de usuarios Ingresos por publicidad atribuidos Diariamente+2 No orgánico  
La adquisición de usuarios Ingresos por publicidad orgánicos Diariamente+2 Orgánico  
Retargeting Ingresos por publicidad por retargeting Diariamente+2 No orgánico  
Retargeting Conversiones Demora de 6 horas No orgánico  
Retargeting Eventos in-app Demora de 6 horas No orgánico  
Retargeting Sesiones Demora de 6 horas Ambos
La adquisición de usuarios Sesiones Demora de 6 horas Ambos
La adquisición de usuarios Desinstalar Desinstalación diaria No orgánico  
La adquisición de usuarios Desinstalaciones orgánicas Desinstalación diaria Orgánico  
Reinstalaciones Reinstalaciones Demora de 6 horas No orgánico  
Reinstalaciones Reinstalaciones orgánicas Demora de 6 horas Orgánico  

Demora de 6 horas:

  • los datos se separan en carpetas de horas de llegada.
  • Esa es la hora en que se proporcionó el evento a Data Locker.
  • El tiempo de demora no está relacionado con la zona horaria específica de la aplicación. 

Desinstalación diaria:

  • los datos de desinstalación se preparan a diario. 
  • Normalmente disponible de 10:00-12:00 UTC.
  • Por lo general, se escribe en la carpeta h=2. Es decir, la carpeta h=2 contiene las desinstalaciones reportadas el día anterior. Sin embargo, los datos pueden escribirse en una carpeta posterior; por lo tanto, tu proceso de importación debe leer los datos de todas las carpetas en la carpeta de desinstalación. Es decir, h=1–24 y h=late. Por ejemplo, el reporte de los datos generados durante el lunes se encuentra en la carpeta h=2 del martes. Los datos están disponibles después de las 10:00 UTC del martes. 

Diariamente+2: Los datos de ingresos por publicidad están disponibles después de 2 días, lo que significa que los datos generados a lo largo del lunes estarán disponibles en la carpeta h=23 del lunes después de las 06:00 UTC del miércoles.

Reportes: aplicación

Reportes de Protect360
Tipo de reporte (tema) Actualización de los datos*
Instalaciones bloqueadas Demora de 6 horas
Eventos in-app bloqueados  Demora de 6 horas
Clics bloqueados Demora de 6 horas
[AG*] Instalaciones posteriores a la atribución Diario
SKAdNetwork [No requiere una suscripción a Data Locker si los envías a tu propio bucket]
Actualización de datos: Diaria 
Tipo de reporte (tema)
[FF*] Postbacks
[FF*] Instalaciones
[FF*] Redescargas
[FF*] Eventos in-app
Reporte de atribución basada en las personas
Actualización de datos: diaria
Tipo de reporte (tema)
[FF*] Visitas al sitio web
[FF*] Eventos del sitio web
[FF*] Instalaciones asistidas por el sitio web
[FF*] Rutas de conversión
 * Referencia para las abreviaturas

[FF] Appsflyer determina los campos de los informes. No están relacionados con los campos seleccionados para incluir en los informes.

[AG] No soporta la transparencia de la agencia (agency transparency).

Demora de 6 horas:

  • los datos se separan en carpetas de horas de llegada.
  • Esa es la hora en que se proporcionó el evento a Data Locker.
  • El tiempo de demora no está relacionado con la zona horaria específica de la aplicación.

Diaria:

  • Los reportes se escriben en la carpeta h=23.
  • Estos reportes suelen estar disponibles entre las 10:00-12:00 UTC en la carpeta h=23 del día anterior.
  • Por ejemplo, el reporte de los datos generados durante el lunes se encuentra en la carpeta Monday h=23. Los datos están disponibles después de las 10:00 UTC del martes. 

Arquitectura de almacenamiento de datos

Información general

Los datos se escriben en la opción de almacenamiento seleccionada. El almacenamiento es propiedad de AppsFlyer en AWS o es propiedad tuya en AWS o GCS. Puedes alternar entre las opciones de almacenamiento en cualquier momento. El cambio entrará en vigor en el transcurso de unas horas. 

Los datos del almacenamiento 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 ejemplo de esta estructura:

DLFolderOVerview.png

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 de reportes (por hora o por día).
  • Los archivos de datos están compuestos por archivos comprimidos GZ que contienen archivos CSV.
  • Los archivos CSV están formados por columnas.
  • La estructura de columnas de los reportes de medición principales es idéntica. Esto significa que puedes tener procedimientos de carga de datos similares para diferentes tipos de reportes. Tú seleccionas los campos (columnas) que se incluyen en cada reporte. 
  • Los reportes designados con FF tienen su propia estructura de columnas. 

Estructura de carpetas

Carpeta Descripción 
data-locker-hourly

DLHourly.png

  • La carpeta de nivel superior del bucket depende del propietario y proveedor del almacenamiento.
  • La carpeta data-locker-hourly contiene los temas de los reportes. Las carpetas por encima de este nivel dependen de la propiedad del bucket y del proveedor de servicios en la nube.

 Ejemplos de estructura de carpetas en función del propietario del bucket y el proveedor de la nube

  • Bucket de AppsFlyer: <af-ext-reports>/<unique_identifier>/<data-locker-hourly>
  • Tu bucket de AWS: <af-datalocker-your folder name>/<data-locker-hourly>
  • Tu bucket de GCS: <data-locker-hourly>
t (topic) El tipo de reporte se relaciona con el asunto del reporte. 
dt (date)

Esta es la fecha de los datos. En la mayoría de los casos, esto significa la fecha en que ocurrió el evento. 

h (hour)

Las carpetas h se relacionan con la hora en que AppsFlyer recibió los datos. Por ejemplo, los eventos de instalación recibidos entre las 14:00 y 15:00 UTC se escriben en el archivo h=14. Nota: Hay una demora, de aproximadamente 6 horas, entre el momento en que los datos llegan a AppsFlyer hasta que la carpeta h se escribe en Data Locker. Por ejemplo, la carpeta h=14 se escribe seis horas más tarde a las 23:00 UTC. 

Características de la carpeta:

  • Hay carpetas de 24 h numeradas del 0 al 23. Por ejemplo, h=0, h=1, etc.
  • La carpeta late (h=late) contiene eventos del día anterior que llegaron después de la medianoche. Es decir que llegan entre las 00:00–02:00 UTC del día siguiente. Por ejemplo, si un usuario instala una aplicación el lunes a las 08:00 UTC y el evento llega el martes a la 01:00 UTC, se registra en la carpeta late del lunes. 
  • Los datos que llegan después de las 02:00 UTC se escriben en la carpeta de la fecha y hora de llegada reales. 
  • Asegúrate de procesar los datos de la carpeta h=late. Estos datos no se encuentran en ninguna otra carpeta. 
  • _temporary folder: En algunos casos, generamos una carpeta temporary (temporal) dentro de una carpeta h. Ignora la carpeta temporary y sus subcarpetas. Ejemplo: /t=impressions/dt=2021-04-11/h=18/_temporary.

Consideraciones de los reportes por hora para aplicaciones que no usan la hora UTC.

Para asegurarte de obtener todos los datos para un día calendario determinado, debes procesar las carpetas de acuerdo con el día definido por la zona horaria de la aplicación como se detalla: 

  • Zona horaria del hemisferio este: para obtener todos los datos de una fecha calendario determinada, debes procesar las carpetas según la fecha y hora UTC. Ejemplo: la zona horaria de tu aplicación es UTC+10 (Sídney, Australia). Para obtener todos los datos por hora relacionados con el martes (Sídney), debes procesar las siguientes carpetas: lunes h=14–23 y late, martes h=0–13 y 14-15. ¿Por qué debes procesar martes h=14-15? Algunos datos pueden llegar tarde. Por lo tanto, las carpetas h=14–15 pueden contener eventos de llegada tardía. Debes filtrar event_time para alinearlo con el día calendario de la aplicación en relación con UTC. 
  • Zona horaria del hemisferio oeste: para obtener todos los datos de una fecha calendario determinada, debes procesar las carpetas según la fecha y hora UTC. Ejemplo: la zona horaria de tu aplicación es UTC-7 (Los Ángeles). Para obtener todos los datos por hora relacionados con el martes (Los Ángeles), debes procesar las siguientes carpetas: martes h=7–23 y late, miércoles h=0–6 y 7-914
  • . ¿Por qué debes procesar miércoles h=7-8? Algunos datos pueden llegar tarde. Por lo tanto, las carpetas h=7–8 pueden contener eventos de llegada tardía. Debes filtrar event_time para alinearlo con el día calendario de la aplicación en relación con UTC.

Segregación de aplicaciones

Los datos se proporcionan en archivos de datos unificados que contienen los datos de todas las aplicaciones seleccionadas o segregadas en carpetas por aplicación. La segregación está dentro de la carpeta h como se describe en la siguiente tabla.
Tipo de segregación Descripción 
[Predeterminada] Unificada

Los datos de todas las aplicaciones se proporcionan en archivos de datos unificados. Al procesar los datos, utiliza el campo app_id a nivel fila para distinguir entre aplicaciones.

Ejemplos de archivos de datos que están en la carpeta h=2

UnifiedByApp.png

La convención de denominación de archivos de datos es: part-nnnnn.gz donde: 

  • nnnnn es un número de pieza en el rango 0000-99999. Por ejemplo, part-00000, part-00001, part-00002, y así sucesivamente.
  • Los números de pieza no son necesariamente consecutivos.
  • En tu proceso de consumo de datos, asegúrate de que:
    • Los datos se procesan solo después de que se configura el indicador _SUCCESS.
    • Se procesan todos los archivos de la carpeta con extensión .gz.
Segregado por aplicación

La carpeta contiene subcarpetas por aplicación. Los archivos de datos de una aplicación determinada se encuentran dentro de la carpeta de la aplicación. En la siguiente figura, la carpeta h=19 contiene carpetas de aplicaciones. Cada carpeta de aplicación contiene los archivos de datos asociados.

DLSegregateByApp.png

En cada carpeta de aplicación, la convención de denominación es: part-nnnnn-string.csv.gz: 

  • nnnnn es un número de pieza en el rango 0000-99999. Por ejemplo, part-00000, part-00001, part-00002, y así sucesivamente.
  • Los números de pieza no son necesariamente consecutivos.
  • En tu proceso de consumo de datos, asegúrate de que:
    • Los datos se procesan solo después de que se configura el indicador _SUCCESS. Nota: El indicador se configura en el nivel h y no en el nivel app_id. 
    • Consumes todos los archivos de la carpeta con una extensión .gz.

Limitación: esta opción no está disponible para los reportes de la atribución basada en las personas.

Archivos de datos

Contenido Unificada  Segregados por aplicación 
Indicador de finalización

El indicador de último archivo (finalización) se establece cuando se han escrito todos los datos de una carpeta h determinada. 

  • No leas datos en una carpeta antes de verificar que tiene el indicador _SUCCESS.

  • El indicador _SUCCESS se configura incluso en los casos en que no hay datos para escribir en una carpeta determinada y la carpeta está vacía. 

  • Nota: En la opción de segregación por aplicación, el indicador se configura en la carpeta h y no en las carpetas individuales de las aplicaciones. Consulta las figuras de la sección anterior. 
Tipos de archivo

Los archivos de piezas se comprimen mediante GZ. Después de descomprimirlos:

  • Los archivos no tienen extensión.
  • Cada archivo tiene una fila de encabezado que contiene los nombres de las columnas (campo). 

Los archivos de piezas se comprimen mediante GZ. Después de descomprimirlos:

  • tienen una extensión CSV.
  • Cada archivo tiene una fila de encabezado que contiene los nombres de las columnas (campo).
Secuencia de columnas

La secuencia de campos en los reportes es siempre la misma. Cuando agregamos campos nuevos, estos se agregan a la derecha de los campos existentes.

En este sentido: 

  • La estructura de columnas de los reportes de medición principales y la UA es idéntica. Esto significa que puedes tener procedimientos de carga de datos similares para diferentes tipos de reportes. Tú seleccionas los campos para escribir. 
  • Los reportes que tienen una indicación de FF en la sección de disponibilidad de reportes no se adhieren a la estructura de columnas comunes. 
  • El significado del campo se detalla en el diccionario de raw data
Consideraciones del relleno de campos

Campos en blanco o vacíos: algunos campos se rellenan con null o están vacíos. Esto significa que en el contexto de un reporte determinado no hay datos para reportar. Normalmente, null (nulo) significa que este campo no se completa en el contexto de un reporte y tipo de aplicación determinados. Blank "" (en blanco) significa que el campo es relevante en su contexto, pero no se encontraron datos para completarlo. 

Zona horaria y moneda

La configuración de la zona horaria y divisa específicas de la aplicación no afecta los datos en Data Locker. Aplican las siguientes condiciones: 

  • Zona horaria: los datos de fecha y hora están en UTC.
  • Divisa: el campo event_revenue_usd está en USD.

Valores con coma: estas comas se encuentran entre comillas dobles `"`, por ejemplo, `"iPhone6,1"`.

Los archivos de datos dependen del tipo de segregación

Opciones de almacenamiento

 Precaución

Si estás utilizando la opción de almacenamiento propiedad del anunciante: 

  • Asegúrate de cumplir con las regulaciones de privacidad de datos como el RGPD y las políticas de retención de datos de redes de publicidad/SRN.
  • No uses la solución de almacenamiento propiedad del anunciante para enviar datos a terceros. 
  • Los datos se escriben en un propietario de almacenamiento de tu elección de la siguiente manera:
    • Almacenamiento de AppsFlyer
    • Almacenamiento del cliente: AWS o GCS
  • 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 buckets: si cambias el almacenamiento, los datos se envían a ambos durante un período de transición de 7 días, lo que te permite alinear tu proceso de consumo de datos. 
  Almacenamiento propiedad de AppsFlyer (AWS)  Almacenamiento propiedad del anunciante (GCS o AWS)
Nombre del bucket Configurado por AppsFlyer
  • GCS: Sin restricción
  • AWS: configurado por ti. Debe tener el prefijo af-datalocker-.

Ejemplo: af-datalocker-tu-nombre-de-bucket

Propiedad del almacenamiento AppsFlyer Anunciante
Plataforma del almacenamiento AWS AWS o GCS
Credenciales para que accedas a los datos Disponible para el administrador en la interfaz de usuario de Data Locker AppsFlyer no las conoce. Usa las credenciales proporcionadas por el proveedor de almacenamiento.
Retención de datos Los datos se eliminan después de 30 días Responsabilidad del anunciante
Solicitudes de eliminación de datos Responsabilidad de AppsFlyer Responsabilidad del anunciante
de la nube AppsFlyer controla el almacenamiento. El cliente tiene acceso de lectura.

El anunciante controla el almacenamiento.

  • AWS: AppsFlyer requiere permiso de GetObject, ListBucket, DeleteObject, PutObject para el bucket. El uso del bucket debe ser exclusivo de AppsFlyer. No lo uses para otros fines.
  • GCS: Consulta el artículo de configuración de GCS.
Capacidad de almacenamiento Gestionado por AppsFlyer Gestionada por el anunciante
Control de acceso mediante puntos de conexión de VPC con políticas de bucket No corresponde [Opcional] En AWS, si implementas la seguridad de punto de conexión de VPC a nivel bucket, debes agregar a la lista los servidores de AppsFlyer. 
Reportes de SKAdNetwork Requiere una suscripción a Data Locker Disponible si tienes una suscripción de raw data. Es decir, no hay necesidad de una suscripción a Data Locker.

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

Considera:

  • El bucket es para uso exclusivo de AppsFlyer. No debe haber ninguna otra entidad que escriba en el bucket.
  • Puedes eliminar datos del bucket 25 horas después de que escribamos los datos.
  • Los datos escritos en el bucket 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. Ni la lista ni la eliminación son riesgos 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 ponerte en contacto con nuestro equipo de seguridad a través de hello@appsflyer.com o con tu gestor de éxito del cliente. 

Procedimientos

Configurar el Data Locker

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 propiedad del anunciante:

Si estás configurando Data Locker utilizando almacenamiento de propiedad de un anunciante, es decir, un bucket de tu propiedad, completa uno de los siguientes procedimientos ahora. 

  • Tu bucket AWS.
  • Tu bucket GCS

Nota: Si no tienes una suscripción a Data Locker y solo accedes a los datos de SKAdNetwork, debes completar un procedimiento de almacenamiento propiedad del anunciante. 

AppsFlyerAdmin_us-en.png Para configurar el Data Locker:

  1. El administrador debe realizar la configuración. 
  2. En Appsflyer, accede a Integración > Data Locker. 
  3. Selecciona un destino de datos de servicio en la nube. Realiza una de las siguientes acciones:
    • Selecciona Bucket AWS de AppsFlyer. Pasa al paso 4. 
    • Selecciona Tu bucket de AWS.
      1. Ingresa el nombre de tu bucket AWS. No incluyas el prefijo af-datalocker-.
      2. Haz clic en Prueba.
      3. Verifica que no se muestre ningún mensaje de error que indique que la ruta del bucket es inválida.
    • Selecciona Tu depósito GCS, luego ingresa el nombre de tu depósito GCS y finalmente haz clic en Probar. 
  4. Selecciona la estructura de carpetas (segregación de datos):
    • [Predeterminada] Unificada.
    • Segregados por aplicación.
  5. Selecciona las aplicaciones requeridas. Selecciona todas para incluir automáticamente las aplicaciones que agregues en el futuro. 
  6. Haz clic en Aplicar
  7. [opcional] Fuentes de medios: Selecciona una o más Fuentes de medios para incluir en los reportes.
    • Predeterminada=All. Significa que las fuentes de medios que agregues en el futuro se agregan automáticamente.
  8. Selecciona los tipos de reportes requeridos. Debes seleccionar al menos 1. 
  9. [opcional] Eventos in-app: Selecciona los eventos in-app a incluir. Si tienes más de 100 tipos de eventos in-app, no puedes buscarlos. Ingresa sus nombres con precisión para seleccionarlos. 
    • Predeterminada=All. Significa que los eventos in-app que agregues en el futuro se agregan automáticamente.
  10. Haz clic en Aplicar
  11. [Opcional] Campos: selecciona los campos para 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 Guardar configuració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 el bucket de cliente: los datos se escribirán en tu bucket en un plazo de 3 horas. 

Restablecer credenciales

El 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.

AppsFlyerAdmin_us-en.pngPara restablecer las credenciales:

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

Información adicional

Rasgos y limitaciones

Características
Característica Observaciones 
Redes de publicidad No apto para el uso por parte de redes de publicidad
Agencias No apto para el uso por parte de agencias.
Zona horaria específica de la aplicación No corresponde. Las carpetas de Data Locker se dividen en horas usando UTC. Los eventos reales contienen horarios en UTC. Convierte los horarios a cualquier otra zona horaria según sea necesario. Independientemente de la zona horaria de tu aplicación, el lapso desde que ocurre el evento hasta que se registra en Data Locker sigue siendo el mismo, es decir, 6 horas. 
Divisa específica de la aplicación  No se admite
Limitaciones de tamaño No correponde
Actualización de los datos Los datos se actualizan de acuerdo con la actualización específica de los datos del reporte que se detalla en este artículo. 
Historial de datos No se admite. Los datos del evento se envían después de configurar Data Locker. Si necesitas datos históricos, utiliza la Pull API. 
Acceso de miembros del equipo Los miembros del equipo no pueden configurar Data Locker. 
Aplicación única/múltiples aplicaciones Admite múltiples aplicaciones. Data Locker está a nivel cuenta

Resolución de Problemas

  • 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 AWSmceclip0.png 

Recuperación de datos de AWS

Utiliza tu herramienta de recuperación de datos de AWS preferida, AWS CLI, o una de las herramientas descritas en las secciones a continuación. Nota: Las instrucciones exactas son adecuadas para los buckets de propiedad de AppsFlyer. Adapta las instrucciones según sea necesario si la conexión es a tu bucket. 

AWS CLI

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/

Cyberduck

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 captura de pantalla a continuación), selecciona Amazon S3.

    DataDuckSmall2.png

  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 hacerlo, usa la X en la esquina superior derecha de la ventana.
  6. Selecciona la conexión.
    Se muestran los directorios de datos.

Navegador Amazon S3

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.

    mceclip0.png

  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.

    mceclip2.png

  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. 
¿Fue útil este artículo?