De un vistazo: ¿Eres una ad network? Encuentra respuestas a las preguntas frecuentes sobre las conexiones con partners de audiencias.
Clave de API y clave de extracción de Partners
¿Para qué se usan la clave de API y la clave de API de prueba?
La clave de API es una clave única que el partner emite a cada anunciante. La clave de API identifica al anunciante en cada llamada a la API y normalmente es una cadena hexadecimal larga (por ejemplo, d41ac239b3b918e28fa0c). Durante el proceso de prueba, necesitaremos que nos proporciones una clave de API de prueba, que usaremos para probar tu integración de audiencias.
¿Qué es PARTNER_PULL_KEY?
PARTNER_PULL_KEY es una clave generada por AppsFlyer y proporcionada a cada partner. Luego, el partner la usa en la variable de plantilla ubicada en la URL {{PARTNER_PULL_KEY}} para descargar el archivo de segmento.
¿Cómo y cuándo recibimos el PARTNER_PULL_KEY?
El equipo de audiencias de AppsFlyer te enviará una PARTNER_PULL_KEY cuando probemos tu endpoint /sync en una fase posterior.
Archivo de audiencia, tamaño y limitaciones
¿Hay alguna limitación en el tamaño del segmento?
Subimos los datos a AWS S3 mediante una carga multiparte. Para conocer los límites de AWS, consulta: supports:https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
¿Qué tamaño tienen los archivos?
Admitimos archivos de gran tamaño. Al final, son archivos CSV almacenados en AWS S3. Para conocer los límites de AWS, consulta: supports:https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
¿Hay un límite máximo para las filas de ID de dispositivo?
El número máximo de filas depende del límite de tamaño de archivo de 5 TB de AWS.
¿Podemos usar una ruta o bucket directo de Amazon AWS para la API de audiencias?
Sí, te proporcionaremos un bucket de AWS y te enviaremos una URL prefirmada a una ruta de AWS donde se encuentra el archivo.
¿Está comprimido el archivo?
N.º
¿La audiencia tiene un período de validez predeterminado?
Una audiencia no caduca. Una vez que se crea y se conecta una audiencia, se carga todos los días. Sin embargo, una audiencia puede eliminarse; en ese caso, dejará de cargarse.
¿El formato del archivo está separado por saltos de línea (o por comas)? ¿La primera línea es un encabezado como advertiser_id?
Está separado por saltos de línea, y la primera línea es un encabezado como advertiser_id_sha256 (según el identificador que se cargue).
¿Cada solicitud /sync incluirá las URL de los 3 archivos (por ejemplo, ADID, correo electrónico y teléfono)?
Cada solicitud /sync contendrá las URL de los archivos que admite la integración. Si admites ADID, correo electrónico y teléfono, contendrá esas 3 URL.
Como resultado del paso 3 (/sync), obtenemos un enlace para descargar un archivo de audiencia. ¿Es posible generar y compartir esas plantillas de URL sin una sincronización de API?
Por el momento, no. Las URL se generan en función de tu PARTNER_PULL_KEY único. En la fase de prueba, se proporcionarán las URL y podrán probarse.
Aquí tienes un ejemplo de URL:
https://audiencespull.appsflyer.com/{{PARTNER_PULL_KEY}}/12cjv4dq1zyxz3nh-HASHED.csv?X-Amz-A lgorithm=AWS1-HMAC-SHA256&X-Amz-Date=20190503T091923Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3599&X-Amz-Credential=AKIB22QYTATEGB2HBFJR%2F20190603%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Signature=c8287819a21d2f7832154df609c55ab8c0afe53540d542918b2739a9234923a
¿Para qué necesitamos container_id?
Enviaremos los ID de dispositivo de la audiencia al ID del contenedor que especifiques a través de la API. La creación del contenedor de audiencia es obligatoria para el desarrollo de la integración de audiencias.
Llamadas a la API, respuestas y códigos de estado
¿Cuándo debemos devolver una respuesta?
/validate: cuando la clave de API coincida con la que se te proporcionó.
/create: cuando el contenedor se haya creado por tu parte.
/sync: Esperamos recibir una respuesta después de que recibas nuestra llamada y puedas acceder al archivo de sincronización. Puedes descargar y procesar el archivo después de enviar la respuesta. El enlace está disponible para su descarga durante un plazo de 2 horas.
¿Cómo debemos gestionar las solicitudes fallidas?
Mediante códigos de estado:
200: cuando la solicitud se ha realizado correctamente
401: para una clave de API no válida: autenticación
No admitimos otros casos de forma predeterminada. En estos casos, el anunciante verá que una carga ha fallado debido a un error general. Si hay problemas recurrentes, ponte en contacto con nosotros para analizar estos casos.
¿Cuándo llama AppsFlyer a nuestros endpoints?
/validate: AppsFlyer llamará a este endpoint una sola vez cuando un anunciante cree una nueva conexión contigo.
/create: Se llama a este endpoint solo una vez por contenedor, lo que significa que, para cada audiencia nueva que se conecte contigo por primera vez, llamamos al endpoint /create y almacenamos el ID del contenedor. Esperamos recibir un ID de contenedor diferente para cada llamada a /create. Separamos las plataformas y los nombres de las audiencias de nuestro lado (en otras palabras, cada plataforma tendrá su propia audiencia de nuestro lado e iniciará una llamada a /create).
/sync: Se llama a este endpoint cada vez que se inicia una carga, ya sea durante el proceso diario que realiza una carga programada de todas las audiencias de AppsFlyer o cuando un anunciante inicia una carga manual a través de nuestra IU o de una llamada a la API.
¿Las solicitudes a /sync se realizan solo una vez o AppsFlyer volverá a ejecutarlas más adelante?
La solicitud a /sync se realiza cada vez que se inicia una carga. Esto ocurre durante el proceso diario que realiza una carga programada de todas las audiencias de AppsFlyer o cuando un anunciante inicia una carga manual a través de nuestra IU o de una llamada a la API.
¿Con qué frecuencia envía AppsFlyer llamadas al endpoint /sync?
Depende del número de anunciantes con los que trabajes y del número de audiencias que carguen. Por cada audiencia cargada, se llamará al endpoint /sync. Esto ocurre durante el proceso diario que realiza una carga programada de todas las audiencias de AppsFlyer o cuando un anunciante inicia una carga manual a través de nuestra IU o de una llamada a la API.
Si tenemos mucho tráfico, ¿podemos mantener varios endpoints de API (por ejemplo, varias rutas o incluso varios dominios)?
La solución recomendada es asegurarte de que la API actual pueda gestionar un tráfico relativamente alto. Hay disponible una modificación de la API; sin embargo, esto podría provocar retrasos de semanas o meses en la finalización de la integración.
Reglas de nomenclatura
En la interfaz /validate, ¿el campo api_key es una cadena o una matriz de cadenas?
Es una cadena.
En la interfaz /create, ¿el campo name (nombre de la audiencia) debe admitir solo caracteres ingleses o también otros conjuntos de caracteres? ¿Cuáles son las reglas de validación para los nombres?
El nombre de la audiencia es idéntico al nombre de la interfaz de usuario de AppsFlyer.
- Debe ser un nombre único de entre 2 y 100 caracteres
- Se admiten todos los idiomas
- Se admiten símbolos especiales (p. ej., $, %, ^, @, etc.)
En la interfaz /create, ¿container_id debe contener solo números o también puede admitir caracteres ingleses?
Se admiten tanto números como caracteres ingleses.
SHA256 y URL con Hashing
¿Por qué falló nuestro intento de descodificar el GAID/IDFA SHA256 de las audiencias?
SHA256 no está pensado para descodificarse. Este mecanismo está diseñado para que tú y AppsFlyer codifiquéis el ID del dispositivo (lo que te permite hacer coincidir los valores codificados si tienes acceso al ID de dispositivo original).
¿AppsFlyer nos proporciona identificadores sin hash?
No, los ID de dispositivo sin hash solo están disponibles para los anunciantes. Para garantizar la Privacidad de Datos, aplicamos Hashing a los ID de anunciante en los archivos de segmentos mediante el algoritmo SHA256. Los ID de anunciante se enviarán con esta clave en la carga útil de la solicitud: url_adid_sha256.
Si todos los GAID tienen hash, ¿cómo podemos saber qué GAID hemos recibido?
Si tienes un GAID en texto sin formato de la aplicación y un GAID con hash de AppsFlyer, puedes aplicar SHA256 al GAID en texto sin formato y luego hacerlo coincidir con el GAID con hash de AppsFlyer.
This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.