De un vistazo: Data Locker para partners (redes de publicidad y agencias) entrega los datos de la aplicación al almacenamiento del partner en AWS, GCS o BigQuery.
Data Locker para partners
Data Locker para partners entrega los datos de la aplicación al almacenamiento en la nube. Los anunciantes establecen los permisos que permiten que AppsFlyer comparta los datos seleccionados con un partner determinado.
Características de Data Locker
Característica | Descripción |
---|---|
Opciones de almacenamiento (nube) |
Almacenamiento (bucket) de tu propiedad en:
|
Soporte de múltiples aplicaciones |
Soporta los datos de las aplicaciones que tengas integradas. El anunciante debe dar permiso por cada reporte para que puedas obtener los datos. |
Opciones de formato de datos |
|
Actualización de los datos |
La actualización depende del tipo de reporte:
|
Reportes disponibles para partners
Los reportes disponibles y los permisos necesarios para obtener los reportes varían según el tipo de partner. Sin embargo, el mecanismo de Data Locker, las opciones de almacenamiento y los ajustes necesarios son los mismos independientemente del tipo de partner. Consulta los artículos por tipo de partner que se indican a continuación:
Arquitectura de almacenamiento de datos
Información general
Los datos se escriben en la opción de almacenamiento seleccionada. Puedes alternar entre las opciones en cualquier momento. El cambio entrará en vigor en el transcurso de unas horas.
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 ejemplo 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 si el reporte se transmite por hora o por día.
- 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 de columnas se define por tipo de reporte.
Estructura de carpetas
Carpeta | Descripción |
---|---|
data-locker-hourly |
Ejemplos de estructura de carpetas en función del propietario del bucket y el proveedor de la nube:
|
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 refieren al momento en que AppsFlyer recibió los datos. Por ejemplo, los eventos de instalación recibidos entre las 14:00 y 15:00 UTC se transmiten al 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 transmite a Data Locker. Por ejemplo, la carpeta h=14 se transmite seis horas más tarde a las 23:00 UTC. Características de la carpeta:
|
Datos unificados |
Los datos de todas las aplicaciones se proporcionan en archivos de datos unificados. Al cargar los datos, utiliza el campo app_id a nivel de fila para distinguir entre aplicaciones. Ejemplos de archivos de datos que están en la carpeta h=2
|
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.
|
Compresión |
Los archivos se comprimen con gz. Después de descomprimirlos:
|
Secuencia de columnas |
La secuencia de campos en los reportes es siempre la misma. Los nuevos campos se agregan a la derecha de los campos existentes. Las definiciones de las columnas (campos) se definen por reporte. Consulta el artículo del reporte correspondiente para obtener la descripción. |
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. Un campo en blanco "" significa que el campo es relevante en su contexto, pero no se encontraron datos para completarlo. Zona horaria y divisa: Los ajustes de zona horaria y divisa específicos de la aplicación no se tienen en cuenta para los datos proporcionados por Data Locker. Así pues:
Valores con coma: estas comas se encuentran entre comillas dobles `"`, por ejemplo, |
Archivos de datos
Los archivos de datos dependen del tipo de segregación.
Contenido | Detalles | |
---|---|---|
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.
|
|
Tipos de archivo |
|
|
Secuencia de columnas (archivos CSV) |
En el caso de los archivos CSV, 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:
|
|
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. Si la fuente de medios está restringida, el contenido de los campos restringidos se establece en nulo. En general, se considera nulo y en blanco como un único producto; no hay datos disponibles. 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:
Valores con coma: estas comas se encuentran entre comillas dobles `"`, por ejemplo, |
Opciones de almacenamiento
- Los datos se escriben en un propietario de almacenamiento de tu elección de: AWS, GCS y BigQuery.
- 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.
- 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 propio del partner (GCS, AWS, BigQuery) | |
---|---|
Nombre del bucket |
Ejemplo: |
Propietario de almacenamiento | Partner |
Plataforma del almacenamiento | AWS, GCS, Yandex, BigQuery |
Credenciales para que accedas a los datos | AppsFlyer no las conoce. Usa las credenciales proporcionadas por el proveedor de almacenamiento. |
Retención de datos | Controlada por ti |
de la nube |
Tú controlas el almacenamiento.
|
Aviso a los responsables de seguridad
Ten en cuenta lo siguiente:
- El bucket o destino 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 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 necesitamos eliminar y reescribir 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.
Principios de conexión múltiple (más de un destino)
En Data Locker puedes enviar algunos o todos tus datos a más de un destino (definido 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. La pestaña predeterminada es "Data Locker".
- Para agregar una conexión nueva:
- Haz clic en Agregar conexión.
- Proporciona un nombre para la conexión y elige el tipo de almacenamiento.
- Haz clic en Guardar.Una vez guardada, la conexión se muestra junto a la pestaña predeterminada "Data Locker". 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).
Procedimientos
Configurar el Data Locker
Usa este procedimiento para configurar Data Locker. Los cambios en la configuración surten efecto en 3 horas.
Requisito previo:
Completa uno o más de los siguientes procedimientos de almacenamiento:
Para configurar el Data Locker:
- Inicia sesión en tu panel de control de partners de AppsFlyer.
- Ve a:
-
Anunciantes: Reporte > Data Locker.
- Partners de marketing: haz clic en el menú de la cuenta > Data Locker.
-
Anunciantes: Reporte > Data Locker.
- Sigue los pasos 3-16 de las instrucciones de configuración de Data Locker.
Información adicional
Rasgos y limitaciones
Característica | Observaciones |
---|---|
Zona horaria específica de la aplicación | No corresponde |
Moneda 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 |
Acceso de miembros del equipo | Los miembros del equipo no pueden configurar Data Locker. |