Data Locker: configuración del servicio en la nube

• El procedimiento de esta sección debe ser realizado por tu administrador de Google Cloud.
• Puedes eliminar archivos de Data Locker 25 o más horas después de su escritura. No los borres antes.

Información para el administrador de GCS

Data Locker es la solución de AppsFlyer para la transmisión de datos al almacenamiento.

Requisitos

• Crea un bucket en GCS para el uso exclusivo de Data Locker. Exclusivo significa que ningún otro servicio escribe datos en el bucket.  
• Nombre del bucket sugerido: af-datalocker.
• Otorga permisos de Data Locker mediante el siguiente procedimiento.

Para otorgar permisos de Data Locker:

En este procedimiento, sustituye data-locker-example por el nombre del bucket que creaste anteriormente para Data Locker. 

1. Inicia sesión en tu consola de GCS.

2. Ve a Almacenamiento > Navegador de almacenamiento.
    

   

3. Selecciona el bucket que has creado anteriormente, por ejemplo, data-locker-example. 
4. Ve a la pestaña Permisos. 
5. Haz clic en Agregar.
   Se abre la ventana “Agregar miembros”.
6. Completa de la siguiente forma:

   1. Nuevos miembros, pega el fragmento que sigue.

      af-data-delivery@af-raw-data.iam.gserviceaccount.com

   2. Selecciona un rol: Almacenamiento en la nube > Administrador de objetos de almacenamiento 

      

7. Haz clic en Guardar. 

• Tu administrador de AWS debe llevar a cabo el procedimiento en esta sección.
• Puedes eliminar archivos de Data Locker 25 o más horas después de su escritura. No los elimines antes.

Información para el administrador de AWS

Data Locker es la solución de AppsFlyer para la transmisión de datos al almacenamiento.

Requisitos

• Crea un bucket de AWS con el nombre af-datalocker-mybucket. El prefijo af-datalocker- es obligatorio. El sufijo es texto libre.
• Sugerimos af-datalocker-aaaa-mm-dd-hh-mm-texto-libre. Donde aaaa-mm-dd-hh-mm son la fecha y hora actuales, y luego agregas cualquier otro texto que quieras, como se muestra en la siguiente figura.

Interfaz de usuario en la consola AWS

Una vez creado el bucket, concede los permisos a AppsFlyer mediante el siguiente procedimiento. 

Para crear un bucket y otorgar permisos a AppsFlyer: 

1. Inicia sesión en la consola de AWS.
2. Ve al servicio S3.
3. Para crear el bucket:
   1. Haz clic en Crear bucket.
   2. Completa el Nombre del bucket de la siguiente manera: Comienza con af-datalocker- y luego agrega cualquier otro texto como se describió anteriormente.
   3. Especifica una de las regiones AWS compatibles.
   4. Haz clic en Crear bucket.
4. Para otorgar permisos a AppsFlyer:
   1. Selecciona el bucket.  
   2. Ve a la pestaña Permisos. 
   3. En la sección Política del bucket, haz clic en Editar. 
      Se abre la ventana de Política del bucket.

   4. Pega el siguiente fragmento de código en la ventana.

      {
        "Version": "2012-10-17",
        "Statement": [
          {
            "Sid": "AF_DataLocker_Direct",
            "Effect": "Allow",
            "Principal": {
              "AWS": "arn:aws:iam::195229424603:user/product=datalocker__envtype=prod__ns=default"
            },
            "Action": [
              "s3:GetObject",
              "s3:ListBucket",
              "s3:DeleteObject",
              "s3:PutObject"
            ],
            "Resource": [
              "arn:aws:s3:::af-datalocker-my-bucket",
              "arn:aws:s3:::af-datalocker-my-bucket/*"
            ]
          }
        ]
      }
      

5. En el fragmento, reemplaza af-data-locker-my-bucket por el nombre del bucket que creaste.

6. [Opcional] Agrega soporte para buckets cifrados de KMS. Para ello, en la sección Política de claves, elige Cambiar a la vista de políticas y pega el siguiente fragmento en la matriz Statement.
    

   {
         "Sid": "Allow use of the key",
         "Effect": "Allow",
         "Principal": {
             "AWS": "arn:aws:iam::195229424603:user/product=datalocker__envtype=prod__ns=default"
         },
         "Action": "kms:GenerateDataKey*",
         "Resource": "*"
     }
   

7. Haz clic en Guardar cambios.
8. Completa la configuración del Data Locker.

Regiones AWS admitidas

Data Locker admite las siguientes regiones de AWS:

• Asia Pacífico (Tokio): ap-northeast-1
• Asia Pacífico (Seúl): ap-northeast-2
• Asia Pacífico (Bombay): ap-south-1
• Asia Pacífico (Singapur): ap-southeast-1
• Asia Pacífico (Sídney): ap-southeast-2
• Canadá (Centro): ca-central-1
• UE (Frankfurt): eu-central-1
• UE (Irlanda): eu-west-1
• UE (Londres): eu-west-2
• América del Sur (Sao Paulo): sa-east-1
• US East (N. Virginia): us-east-1
• Estados Unidos Este (Ohio): us-east-2
• US West (N. California): us-west-1
• US West (Oregón): us-west-2

• El procedimiento de esta sección debe ser realizado por tu administrador de Azure Cloud.
• Puedes eliminar archivos de Data Locker 25 o más horas después de su escritura. No los borres antes.

Información para el administrador de Azure

Data Locker es la solución de AppsFlyer para la transmisión de datos a tu cuenta de almacenamiento.

Para definir una cuenta de almacenamiento para Data Locker:

1. En tu portal de Azure, ve a Cuentas de almacenamiento de Azure y haz clic en Crea una nueva cuenta de almacenamiento para obtener tus datos de AppsFlyer.
2. En la pestaña Básico -> Detalles del proyecto, selecciona las opciones correspondientes en los menús desplegables:
   1. Suscripción. 
   2. Grupo de recursos.
      Opcional: Si no existe ningún grupo de recursos, haz clic en Crear nuevo para crear un grupo de recursos.
3. En Detalles de instancia:
   1. Ingresa un nombre de cuenta de almacenamiento.
   2. Selecciona una región en el menú desplegable.
4. Haz clic en Siguiente. Avanzado >
5. En la pestaña Seguridad, selecciona Habilitar espacio jerárquico.
6. Haz clic en Revisar -> Crear.
7. Cuando finalice la implementación, vuelve a Azure storage accounts y selecciona la cuenta de almacenamiento recién creada.
8. Ve a Access keys y copia el Storage account name y una de las claves. 
9. Ve a Storage browser > Blob containers y haz clic en Add container.
   1. Ingresa un Nombre para el contenedor nuevo.
   2. Haz clic en Crear.
10. Ponte en contacto con tu CSM para habilitar Azure en Data Locker.
11. Una vez habilitado, en AppsFlyer, ve a Data Locker -> Nueva conexión.
12. En la nueva conexión:
    1. Asigna un nombre a tu conexión.
    2. Selecciona Azure Blob.
    3. Introduce el Container name de Azure en el campo Bucket Name (el que creaste en el paso 9).
    4. Introduce el Storage account name que copiaste en el paso 8.
    5. Introduce la clave que copiaste en el paso 8.
    6. Haz clic en Probar conexión.
    7. Guardar.

• El procedimiento de esta sección debe realizarlo el administrador de Yandex Cloud.
• Puedes eliminar archivos de Data Locker 25 o más horas después de su escritura. No los borres antes.

Información para el administrador de Yandex Cloud

Data Locker es la solución de AppsFlyer para la transmisión de datos al almacenamiento.

Para crear un bucket y otorgar permisos de Data Locker:

1. En la Yandex Cloud console, ve a la pestaña Service Accounts y haz clic en Create service account.
2. Nombra la cuenta de servicio, por ejemplo, af-datalocker.
3. Crea una clave de acceso estática para la cuenta de servicio. En la cuenta de servicio:
   1. Haz clic en Crear una nueva clave.
   2. Selecciona Crear clave de acceso estática.
   3. Guarda el ID de clave y la Clave secreta.
4. Dale a tu nueva cuenta de servicio el permiso storage.editor.
   1. En la configuración del bucket, ve a Access Bindings y haz clic en Assign bindings.
   2. Para la nueva cuenta de servicio, añade el rol storage.editor y haz clic en Guardar.
5. Ponte en contacto con tu CSM de AppsFlyer para habilitar Yandex en Data Locker.
6. Una vez habilitado, utiliza el ID de la clave y la clave secreta durante la configuración de Data Locker.

El procedimiento de esta sección debe ser realizado por tu administrador de BigQuery.

Información para el administrador de BigQuery

Data Locker es la solución de AppsFlyer para la transmisión de datos al almacenamiento.

Requisitos

• Crear un conjunto de datos de BigQuery

Para crear un conjunto de datos de BigQuery: 

1. En BigQuery, crea un proyecto o usa un proyecto existente. 
2. En el proyecto, haz clic en CREAR CONJUNTO DE DATOS.

3. Proporciona al conjunto de datos un ID adecuado.

   Nota

   Asegúrate de que el proyecto o conjunto de datos objetivo esté vinculado a una cuenta de facturación activa. Sin una cuenta de facturación, Data Locker no puede crear ni escribir tablas en el destino de BigQuery, y el proceso de configuración de la conexión puede fallar.

4. Otorga a AppsFlyer acceso al conjunto de datos. Ver instrucciones de Big Query
   • Para Agregar principal, utiliza el siguiente usuario de AppsFlyer: datalocker-bq-admin-prod@datalocker-bq-prod.iam.gserviceaccount.com
   • En Asignar roles, selecciona Editor de datos de BigQuery.
5. Completa la configuración restante según sea necesario.  

Conecta Data Locker a tu cuenta de Snowflake. Al hacerlo, los datos se envían a Snowflake y continúan estando disponibles en tu almacenamiento en la nube seleccionado.

Consideraciones para desarrolladores de BI

• La tasa de actualización de datos es la misma que la de los datos proporcionados en un bucket. 
• La estructura de tabla y columna de los datos es equivalente a la que se encuentra en los datos disponibles directamente desde un bucket de Data Locker. 
• A medida que se añaden filas al recurso compartido de Snowflake, la columna _ingestion_time se completa con la zona horaria local del sistema (no UTC). Para garantizar que cada fila sea única y evitar la ingestión de la misma fila más de una vez:
  1. Guarda el max_ingestion_time por tabla ingerida.
  2. Cada vez que ejecutes tu proceso de ingestión, añade solo aquellas filas en las que _ingestion_time > max_ingestion_time

Completa los procedimientos siguientes para conectar Snowflake a Data Locker.  

Procedimientos de conector de Snowplake

Para obtener tu ID de cuenta y región de Snowflake:

1. En Snowflake, inicia sesión en tu cuenta de Snowflake.

2. En la barra de menú, selecciona tu nombre.
   Se muestra el ID de tu cuenta y la región.

   

Para conectar Data Locker a Snowflake:

1. En AppsFlyer, ve a Reportes > Data Locker.
2. Selecciona Snowflake.
3. Introduce la región de Snowflake y el account locator utilizando la información que recibiste previamente de Snowflake.
4. Haz clic en Guardar.

Para crear una base de datos a partir de un recurso compartido en Snowflake:

1. En Snowflake, inicia sesión en tu cuenta de Snowflake.
2. Cambia el rol a Accountadmin. Consulta Crear una base de datos a partir de un recurso compartido.
3. Selecciona Recursos compartidos.
4. Selecciona el recurso compartido de AppsFlyer. Por ejemplo, APPSFLYER_ACC_XXX_DATA_LOCKER. 
5. Haz clic en Crear base de datos desde Secure Share y completa los detalles requeridos. ¡Importante! Debes cargar los datos de la base de datos compartida en tus tablas, porque los datos en la base de datos compartida solo están disponibles por un período limitado (actualmente 14 días).    

6. En tu base de datos, se muestran las tablas importadas. Los nombres y estructuras de las tablas son equivalentes a los de los buckets de Data Locker.