De un vistazo: Importe segmentos de audiencia predefinidos desde sus sistemas internos (como BI y CRM) a AppsFlyer Audiences, lo que le permite utilizar Audiences para conectar y mantener estos segmentos con sus socios publicitarios.
¿Por qué importar audiencias?
En ciertas ocasiones, puede que ya tenga segmentos de audiencia predefinidos en sus sistemas internos. Importar estas audiencias (como listas de identificadores de dispositivos y/o usuarios) a AppsFlyer le permite usar Audiences como el punto central para conectar y mantener todos sus segmentos de audiencia con sus socios publicitarios. Además, le ofrece la posibilidad de sacar el máximo partido de otras funciones de Audiences, como la coincidencia de identificadores, el enriquecimiento de datos y las métricas de campañas conectadas.
Considere los siguientes ejemplos:
Ejemplos
Remarketing promocional
Desea dirigir ofertas promocionales a los usuarios durante el mes de sus cumpleaños.
A continuación le explicamos cómo hacerlo con Audiences:
- Utilice su CRM interno para generar una lista de usuarios con sus fechas de cumpleaños.
- Organice la lista según el mes de cumpleaños y expórtela como listas individuales de identificaciones de publicidad.
- Importe las listas a AppsFlyer como audiencias y conéctelas con los socios con los que desea ejecutar campañas promocionales.
- Configure campañas con los socios pertinentes para dirigirse a las audiencias adecuadamente.
Adquisición de usuarios adicionales
Su estudio de desarrollo de aplicaciones adquiere otro estudio. El estudio adquirido cuenta con los ID de dispositivos de los usuarios que instalaron previamente sus aplicaciones, y desea enfocar estos usuarios para que instalen sus aplicaciones existentes.
A continuación le explicamos cómo hacerlo con Audiences:
- Obtenga la lista de ID de dispositivos del estudio adquirido e impórtela a AppsFlyer como una audiencia.
- Conecte la audiencia con los socios con los que desea ejecutar campañas.
- Configure campañas con los socios pertinentes para llegar a estos usuarios adecuadamente.
Importación de audiencias V2.0
Este artículo describe los conceptos y procedimientos relacionados con la nueva función de importación de Audiencias V2.0 (con opciones para importar mediante CSV y API).
Tipos de audiencias importadas
Al importar una audiencia, se le asigna uno de dos tipos, lo que determina cómo AppsFlyer la trata, tanto en el procesamiento como en la carga a los socios. La asignación se realiza al importar una audiencia por primera vez y no se puede cambiar después.
Una audiencia estándar importada:
- Se somete a una comparación de identificadores y enriquecimiento de datos: un proceso en el que Audiences empareja los identificadores importados con los existentes en la base de datos de Audiences (para el mismo usuario en la misma aplicación) con el objetivo de enriquecer los datos de audiencia cargados a los socios.
- Se carga a los socios de acuerdo con la política de identificadores de usuario de su cuenta.
- Debe importarse utilizando la función de importación V2.0 que se describe en este artículo.
Una audiencia "tal cual" importada:
- No se somete a comparación de identificadores ni a enriquecimiento de datos.
- Se carga a socios sin tener en cuenta la política de identificadores de usuario de su cuenta (es decir, todos los identificadores importados se cargan a los socios).
- Se puede importar utilizando la función de importación V2.0 (descrita en este artículo).
¡Importante!
- Todas las audiencias existentes a partir del 23 de noviembre de 2021 se designan como audiencias tal como están y no se pueden cambiar a audiencias estándar. Puede seguir actualizando estas audiencias según sea necesario utilizando la función de importación V2.0 (descrita en este artículo).
- Puedes tener hasta 500 audiencias importadas activas al mismo tiempo.
- Solo un administrador puede designar una nueva audiencia importada como una audiencia tal como está.
- Al importar una audiencia con CUID como identificador, AppsFlyer debe haber recibido la asociación de CUID en el momento de la instalación (no solo en eventos post-instalación) para garantizar una asociación completa con los dispositivos relevantes y un enriquecimiento exitoso con identificadores de dispositivos (es decir, GAID, IDFA). Más información
Procedimientos de importación de audiencias
Importa una audiencia cargando un archivo CSV o utilizando la API de importación de audiencias.
Importar un archivo CSV
Prepara un archivo CSV con las siguientes especificaciones:
Formato
- Una columna para cada identificador de usuario que se suba
- Una fila de encabezado con el nombre del identificador en cada columna (todo en minúsculas)
- Sin filas en blanco
- Número máximo de filas: 10 millones
- Si preparas el archivo con Excel, guárdalo como un archivo CSV (delimitado por comas) (*.csv), como se muestra en la imagen siguiente:
hash del identificador
Columnas e identificadores
- Los datos se procesan usando la fila de encabezado para identificar los datos en cada columna, por lo siguiente:
- No es necesario que las columnas aparezcan en un orden específico.
- No es obligatorio incluir columnas para identificadores que no se estén subiendo.
- Puedes importar tantos identificadores como desees en un único archivo CSV siempre que cada fila incluya los identificadores requeridos, como se detalla a continuación.
- Identificadores disponibles:
- app_id
- idfv
- idfa
- gaid
- oaid
- imei
- cuid
- correos electrónicos
- teléfono
- teléfono_e164
- braze_id
- amplitude_id
- Identificadores requeridos:
- Para audiencias de Android: app_id + uno de los siguientes: gaid O oaid O imei O cuid O braze_id O amplitude_id
- Para audiencias de iOS: app_id + uno de los siguientes: idfv O cuid O braze_id O amplitude_id
- De acuerdo con la aplicación del Digital Markets Act (DMA) por Google el 6 de marzo de 2024, al importar una audiencia tal cual, será necesario agregar dos columnas adicionales de consentimiento de AppsFlyer. Estas son:
| Columnas de consentimiento de AppsFlyer | Campo de Google | Valores | Campo explicado |
|---|---|---|---|
| personalización de anuncios habilitada | personalización de anuncios | verdadero/falso | ¿El usuario ha dado su consentimiento a Google para usar sus datos con fines de personalización de anuncios? |
| datos de usuario de anuncios habilitados | datos_de_usuario_anuncio | verdadero/falso | ¿El usuario ha dado su consentimiento para enviar sus datos de usuario a Google? |
Si los campos de consentimiento no se completan con valores, se enviarán a Google como 'No especificado', y es probable que no se incluyan en la audiencia de Google. Rellenar estos campos garantiza la máxima inclusión de usuarios del Espacio Económico Europeo (EEE) en tus audiencias de Google.
Archivos CSV de ejemplo:
nuevo-ejemplo-importación-android.csv
nuevo-ejemplo-importación-ios.csv
Para crear e importar una nueva audiencia usando un archivo CSV:
- En el panel izquierdo de AppsFlyer, dirígete a Interactuar > Audiencias.
- Haz clic en Nueva audiencia.
- Selecciona Importar audiencia.
Se abrirá la ventana Importar audiencia. - Introduce un nombre de audiencia único.
- Elige la plataforma de audiencia: Android o iOS.
- Indica si esta audiencia es una audiencia estándar o tal cual.
- Para una audiencia estándar, deja la casilla sin marcar.
- Para una audiencia tal cual, marca la casilla. (Nota: (Esta opción está disponible solo para administradores).
- Haz clic en Guardar audiencia y continuar.
Se muestra la pestaña Importar. - En la sección Importar usando CSV, mantén configurado por defecto Agregar nuevos dispositivos/usuarios (ya que se trata de una nueva audiencia).
- Selecciona el archivo CSV que deseas cargar.
Espera el mensaje de confirmación Cargado exitosamente. - Haz clic en Siguiente.
Se muestra la pestaña Conectar. - (Opcional) Sigue las instrucciones para conectar una audiencia con socios.
- Haz clic en Listo.
Tu audiencia ahora es visible en el panel de Audiencias y se ha importado y conectado con los socios. Sin embargo, ten en cuenta que la lista de audiencia recién importada aún no está disponible para cargarla a los socios, ya que las audiencias importadas se procesan con una frescura de datos diaria.
Para actualizar una audiencia existente usando un archivo CSV:
- En el panel izquierdo de AppsFlyer, dirígete a Interactuar > Audiencias.
- Haz clic en el nombre de la audiencia que deseas actualizar.
Se abrirá la pantalla Editar audiencia, mostrando la pestaña Definir. - Si deseas editar el nombre de la audiencia, puedes hacerlo aquí. Si no, selecciona la pestaña Importar para cargar el nuevo archivo CSV.
- En la sección Importar usando CSV, elige qué hacer con la lista cargada:
- Agregar nuevos dispositivos/usuarios: Añadir identificadores de dispositivo/usuario a la audiencia existente
- Eliminar dispositivos/usuarios de la audiencia existente: Eliminar identificadores de dispositivo/usuario en la lista cargada de la audiencia
- Sobrescribir la audiencia existente con nuevos dispositivos/usuarios: Reemplazar toda la audiencia con la lista cargada
- Selecciona el archivo CSV que deseas cargar.
Espera el mensaje de confirmación Cargado exitosamente. - Haz clic en Siguiente.
Se muestra la pestaña Conectar. - Realiza cambios en las conexiones de socios para esta audiencia si es necesario.
- Haz clic en Listo.
Tu audiencia se ha actualizado usando el archivo CSV. Sin embargo, tenga en cuenta que la lista de audiencia revisada aún no se ha cargado para los socios, ya que las audiencias importadas se procesan con una actualización diaria de datos.
Mensajes de error
| Mensaje | Causa | Qué hacer |
|---|---|---|
| Hay un problema con la lista de dispositivos. | Hay uno o varios problemas con la lista de dispositivos. | Por favor, verifique que el archivo CSV:
|
| Parece que tu lista de dispositivos está vacía. Añade algunos identificadores de dispositivos e inténtalo de nuevo. | El archivo CSV está vacío |
Asegúrate de que el CSV contenga al menos un ID de dispositivo. |
| No hemos podido entender uno o más de tus ID de dispositivos. |
|
|
| No se puede utilizar la importación v1 mientras se aplica la política de cuenta de usuario en la audiencia. | Has cargado un archivo CSV para una audiencia estándar utilizando la estructura de importación V1.0. Las audiencias estándar deben cargarse utilizando un CSV en la estructura V2.0. | Edita el archivo CSV que estás cargando para que use el formato, las columnas y los identificadores descritos anteriormente. |
| Tuvimos un problema de conexión temporal y no pudimos cargar tu archivo. Puedes intentarlo de nuevo ahora. | Posible error de red | Intenta cargar el archivo CSV nuevamente. |
Utiliza la API de Importación de Audiencia
La API de Importación de Audiencia se usa para agregar o eliminar dispositivos de una audiencia.
Para importar una nueva audiencia utilizando la API:
- En el panel izquierdo de AppsFlyer, dirígete a Interactuar > Audiencias.
- Haz clic en Nueva audiencia.
- Selecciona Importar audiencia.
Se abrirá la ventana Importar audiencia. - Introduce un nombre de audiencia único.
- Elige la plataforma de audiencia: Android o iOS.
- Indica si esta audiencia es una audiencia estándar o tal cual.
- Para una audiencia estándar, deja la casilla sin marcar.
- Para una audiencia tal como está, marca la casilla (ten en cuenta que esta opción solo está disponible para administradores). Se requieren dos campos de consentimiento adicionales al importar una audiencia 'tal cual' según la normativa de la Ley de Mercados Digitales (DMA) impuesta por Google el 6 de marzo de 2024. Al completar estos campos, se garantiza la máxima inclusión de usuarios del Espacio Económico Europeo (EEE) en tus audiencias de Google.
- Haz clic en Guardar.
Se muestra la página de Importación. - En la sección Importar utilizando la API, mantén el valor predeterminado de Añadir nuevos dispositivos/usuarios (ya que se trata de una nueva audiencia).
- Copia la URL de solicitud de API de la página Importar una nueva API de Audiencia (el token de API ya está incluido).
- Luego copia y pega el cuerpo de la solicitud de API.
- Haz clic en Listo.
Se muestra la pestaña Conectar. - (Opcional) Sigue las instrucciones para conectar una audiencia con socios.
- Haz clic en Listo.
- Prepara la solicitud de API, incluyendo los identificadores de usuario/dispositivo, y envíala a AppsFlyer.
Para actualizar una audiencia existente mediante la API:
- En el panel izquierdo de AppsFlyer, dirígete a Interactuar > Audiencias.
- Haz clic en el nombre de la audiencia que deseas actualizar.
Se abrirá la pantalla Editar audiencia, mostrando la pestaña Definir. - Si deseas editar el nombre de la audiencia, puedes hacerlo aquí. Si no, selecciona la pestaña Importar.
- En la sección Importar mediante la API, elige qué hacer con la lista cargada:
- Agregar nuevos dispositivos/usuarios: Agrega identificadores de dispositivo/usuario a la audiencia existente.
- Eliminar dispositivos/usuarios de la audiencia existente: Elimina identificadores de dispositivo/usuario de la audiencia existente.
- Copia la URL de solicitud de API de la página Importar una nueva API de Audiencia (el token de API ya está incluido). Nota: Al cambiar esta opción se modifica la ruta del endpoint en el código que se va a copiar. Asegúrate de usar el endpoint correcto para la acción que estás realizando (en esta y futuras solicitudes de API).
- Luego copia el cuerpo de la solicitud de API.
- Haz clic en Siguiente.
Se muestra la pestaña Conectar. - Realiza cambios en las conexiones de socios para esta audiencia si es necesario.
- Haz clic en Listo.
- Prepara la solicitud de API, incluyendo los identificadores de usuario/dispositivo, y envíala a AppsFlyer.
Nota: Al importar mediante la API, la audiencia tardará 24 horas en actualizarse.
Códigos de respuesta
| Código | Mensaje | Descripción |
|---|---|---|
|
200 |
La solicitud fue exitosa |
Audiencia importada con éxito |
| 400 | Plataforma de audiencia no válida, esta audiencia ya está configurada para Android/iOS. Para usar una plataforma diferente, crea una nueva audiencia en la interfaz de usuario. | La plataforma especificada en el cuerpo de la solicitud no coincide con la plataforma especificada al crear la audiencia |
| 400 | X o más de tus filas no contienen un ID de aplicación. Debes adjuntar un ID de aplicación a cada fila. |
Es necesario que cada fila contenga un app_id
|
| 400 | X o más de tus filas no contienen un identificador único válido |
Al menos una o algunas filas no contienen alguno de los siguientes identificadores en un formato válido:
|
| 400 | No se pueden procesar más de Y dispositivos por solicitud (se han contado n dispositivos en esta solicitud) |
El cuerpo de la solicitud incluye una lista con más de 10.000 ID de dispositivos. |
| 400 | La lista de dispositivos no puede estar vacía |
El cuerpo de la solicitud contiene una lista vacía de dispositivos. Debe proporcionar al menos un ID de dispositivo por cada solicitud |
| 400 | No pudimos interpretar uno o más de los identificadores de sus dispositivos | Algunos o todos los ID de dispositivos no tienen un formato válido |
|
400 |
X o más de los dispositivos a eliminar contienen más de un identificador por dispositivo |
La solicitud de eliminación fue enviada con más de un identificador por dispositivo |
| 403 | Prohibido | Solicitud no autorizada: Clave de importación incorrecta o faltante |
| 429 | Demasiadas solicitudes | Las solicitudes están limitadas a 350 por minuto |
| 500 | No se pudo procesar la solicitud |
El formato del cuerpo de la solicitud no es válido (no es la estructura JSON esperada o no es un JSON) Consulte la solicitud de ejemplo anterior |
Limitaciones de la API
- Solo se pueden agregar dispositivos a una audiencia por solicitud.
- Solo se pueden eliminar dispositivos de una audiencia por solicitud.
- Puede enviar hasta 20.000 ID de dispositivos por solicitud.
- Se pueden enviar hasta 350 solicitudes por minuto.
API de gestión de audiencias importadas
La API de gestión de audiencias importadas permite a los anunciantes crear y configurar audiencias importadas, conectarlas con socios, subirlas a los socios, entre otras funciones.