Audiencias: atributos de los usuarios

Tú, como marketer de aplicaciones, estás ocupado con lo siguiente:

• Mantener 2 aplicaciones de juegos: game_a y game_b.
• Lanzar game_c
• Dirigirte a los usuarios actuales de la aplicación con estos atributos de usuario:
  • Deporte favorito: Cricket
  • Puntuación actual del juego: 15 o más en uno de los juegos actuales

La tabla contiene datos de atributos de usuario de tu CRM. Los conjuntos de reglas de audiencia necesitan acceso a estos datos. 

Usa datos de CRM en conjuntos de reglas

En Audiencias, crea atributos de usuario (deporte favorito y puntuación del juego). Esto permite que el conjunto de reglas acceda a los datos de CRM. 

Atributos de usuario del escenario

Atributos de usuario en conjuntos de reglas

Los atributos de usuario funcionan como filtros en los conjuntos de reglas de Audiencias. Este ejemplo utiliza criterios (deporte favorito y puntuación en el juego) que establece el comercializador. 

altEjemplo de atributo de usuario.jpgalt

Requisito previo:

Para gestionar atributos a nivel de aplicación, el usuario de la cuenta debe tener permiso para la aplicación. 

Para configurar los atributos de usuario siga estos pasos:

1. Añadir atributos de usuario.

2. Puede realizar una de las siguientes acciones:

   • Importar datos de atributos de usuario mediante CSV.

   • Importar datos de atributos de usuario mediante API.

3. Implementar atributos de usuario en conjuntos de reglas.

Para añadir atributos de usuario:

1. En AppsFlyer, desde el menú lateral, elija Interactuar > Audiencias.
2. Haga clic en la pestaña Atributos de usuario.
3. Haga clic en Agregar atributo de usuario.
   

   

4. Rellene los campos. Las características de los campos se enumeran en la tabla que sigue. 
   
   • Nombre del atributo
   • Formato
   • Nivel
5. Haga clic en Guardar.

Para gestionar los atributos de usuario, diríjase a la pestaña Audiencias > Atributos de usuario.

Solo un usuario administrador puede suprimir un atributo.

Para suprimir un atributo que forma parte de un conjunto de reglas:

1. Quite el atributo del conjunto de reglas.
2. Elimine el atributo.

Los datos de atributos de usuario se agregan o eliminan mediante un archivo CSV. La figura y el archivo CSV de ejemplo que sigue coinciden con el escenario descrito en este artículo.

Ejemplo de atributo de usuario.csv

Requisitos del archivo CSV

• Sin fila de encabezado
• Contiene todas las columnas enumeradas en la tabla anterior. 

Para importar un archivo CSV:

1. Vaya a la pestaña Audiencias > Atributos de usuario .
2. Haga clic en Importar datos.
3. Seleccione CSV.
4. Seleccione una de las siguientes opciones:
   • Añadir datos
   • Eliminar datos
5. Elija un archivo CSV para importar. 
6. Haga clic en Cargar; aparecerá un mensaje de estado de carga.

Nota: Al importar atributos de usuario, todos los dispositivos asociados conocidos con un ID de cliente también reciben el atributo. Por ejemplo, si un usuario importa 10 dispositivos (por customer_id) al atributo “Puntaje del juego”, y uno de los customer_id está asociado a 2 dispositivos (es decir, 2 GAID con el mismo CUID), esta importación incluirá 11 registros de atributos de usuario.

Este método de importación requiere una URL de solicitud y un JSON con datos de atributos de usuario.

1. En el panel de control, obtén las llamadas de solicitud de API preparadas y la plantilla JSON.
2. Rellena la plantilla JSON con tus datos de acuerdo con las especificaciones de campo. 

Para generar la URL de solicitud de API y la plantilla JSON:

1. Haz clic en Importar datos.
2. Selecciona API.
3. Elige una acción:
   
   • Actualizar atributos de usuario: Sobrescribir o agregar.
   • Eliminar atributos de usuario.
   • Eliminar datos del usuario: Elimina todos los datos relacionados con un usuario específico. El usuario se identifica mediante su ID de AppsFlyer.
   • Eliminar datos de la aplicación: Elimina todos los datos a nivel de la aplicación. 
4. Copia la URL de solicitud de API generada.
5. Copia el cuerpo de la solicitud de API generada.
6. Prepara el JSON (con sus datos de atributos de usuario) utilizando el formato JSON especificado. Para los atributos a nivel de cuenta, configura "app_ids": ["*"]
7. Prepara la llamada API basándote en la URL y el cuerpo de la solicitud.
8. Envía la solicitud de manera programática.

https://hq1.appsflyer.com/api/user-attributes-import-api/set-user-data
{
  "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
  "attributes_values": [
    {
      "device_id": "",
      "customer_id": "",
      "app_ids": [],
      "attributes": [
        {
          "attribute_key": "",
          "attribute_value": ""
        }
      ]
    }
  ]
}

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "2222222",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 5
                }
                ,
                {
                    "attribute_key": "favorite_sport",
                    "attribute_value": "cricket"
                }
            ]
        }
        ,
        {
            "device_id": "555555-d1d1-d1d1-555-fffffffff",
            "customer_id": "111111",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "order",
                    "attribute_value": 7
                }
                ,
                {
                    "attribute_key": "number",
                    "attribute_value": 8
                }
            ]
        }]
}

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "12345678",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 90
                }
                ,
                {
                    "attribute_key": "favorite-sport",
                    "attribute_value": "cricket"
                }
                ,
                {
                    "attribute_key": "orderNumber",
                    "attribute_value": 93
                }
                ,
                {
                    "attribute_key": "netPromoterScore",
                    "attribute_value": 94
                }
            ]
        }
    ]
}

Limitaciones generales

• Solo se admiten números enteros en los datos de importación CSV/API. No se admiten números de tipo flotante (decimales). Ejemplo: Un valor de atributo "puntuación" puede ser 90, pero no 90,5.
• No se pueden imprimir ni descargar los datos de atributos de usuario. 

• Limitaciones de los valores de los atributos:

  • No se permiten comas, puntos ni otros caracteres especiales en los valores de los atributos.
  • Existe una limitación de 40 caracteres para un valor de atributo de tipo cadena.
  • Los valores de los atributos no pueden comenzar con 0.

Limitaciones de importación a través de la API

• Un máximo de 350 solicitudes API por minuto, 10.000 dispositivos para una carga útil simple (10.000 dispositivos con un atributo, 5.000 con dos atributos, etc.)
• Las claves device_id y customer_id son necesarias para cada llamada de importación. Si desea importar atributos con solo uno de estos identificadores, la llamada debe incluir el "encabezado" del otro identificador con una cadena vacía. Por ejemplo, si desea importar atributos por device_id y no por customer_id, la llamada debería ser así:

"attributes_values": [
{
"device_id": "39e123.......",
"customer_id": "",

Limitaciones de importación CSV

• Al agregar valores de atributos de usuario, se permite un máximo de 10 millones de filas por archivo CSV.