Crea, actualiza, consulta y elimina integraciones de ingresos por anuncios con partners para varias aplicaciones a la vez mediante la Ad Revenue Integrations API.
Necesitas ROI360.
Acerca de la API
Utiliza la Ad Revenue Integrations API para gestionar en bloque las integraciones de ingresos por anuncios, en lugar de hacerlo una por una en la plataforma. Con una sola llamada a la API, puedes:
- Crear o actualizar integraciones para una o varias aplicaciones y uno o varios partners
- Obtener las integraciones de aplicaciones concretas o de todas las aplicaciones de tu cuenta
- Eliminar las integraciones de aplicaciones concretas con todos los partners o solo con algunos
Puedes configurar un tipo de integración para cada combinación de aplicación y partner:
| Tipo de integración (como aparece en la plataforma) | Valor de la API | Credenciales del partner | Evento fuente |
|---|---|---|---|
| Nivel agregado por API S2S | aggregate_s2s |
Requerido | Requerido |
| Nivel de dispositivo por API S2S | dispositivo_s2s |
Requerido | - |
| Nivel de impresión por SDK | impression_sdk |
- | - |
| Nivel de impresión (por SDK) con nivel de dispositivo (por API S2S) | impression_sdk_and_dispositivo_s2s |
Requerido | - |
Para saber más sobre cada tipo de integración, consulta Tipos de integración para la atribución de ingresos por publicidad.
Antes de comenzar
- Obtén el token de la API V2. Solo el administrador de la cuenta puede recuperarlo. Más información
- Decide qué partners y tipos de integración necesitas para cada aplicación. No todos los partners son compatibles con todos los tipos de integración. Consulta la lista de partners integrados de ingresos por publicidad.
- Obtén las credenciales de la API de cada partner. No necesitas credenciales para la integración a nivel de impresión mediante SDK.
- Para la integración a nivel agregado por API S2S, elige el evento fuente (por ejemplo,
af_app_opened). Los ingresos por publicidad se registran como<source_event>_monetized.
Configura integraciones mediante API
- Prepara la lista de integraciones: App ID, partner, tipo de integración, credenciales y evento fuente (cuando sea necesario).
- Dale a tu desarrollador el token de la API V2 y esta lista.
- Pide a tu desarrollador que siga las instrucciones de la API de integraciones de ingresos por publicidad en DevHub. Las credenciales que necesita cada partner figuran en Credenciales de los partners.
- Comprueba las integraciones en AppsFlyer: Configuración > Configuración de ingresos > Ingresos por publicidad, o mediante la API para obtener integraciones.
Se aplican las mismas reglas que en la plataforma. Por ejemplo, si usas una plataforma de mediación, no mantengas integraciones independientes para las redes que gestiona; así evitarás duplicar los datos.
Cuándo entran en vigor los cambios
| Acción | Entra en vigor |
|---|---|
| Crear nueva integración | Inmediatamente |
| Actualizar una integración existente (incluido un cambio de tipo de integración) | A las 00:00 UTC del día siguiente |
| Eliminar una integración | Inmediatamente |
Especificaciones y limitaciones
| Especificación | Comentarios |
|---|---|
| Límite por llamada | Hasta 1.000 integraciones en una sola llamada de creación o actualización. |
| Todo o nada | Si falla una integración en una llamada, no se aplica ninguna de las integraciones de esa llamada. |
| Actualización | Una actualización sustituye por completo la integración existente de esa aplicación y ese partner (tipo de integración, credenciales y evento fuente). |
| Activar / desactivar | No admitido. Para detener una integración, elimínala. |
| Credenciales | No se devuelve en la API Get integrations. |
| Estado y Probar conexión | Solo está disponible en la plataforma. |
| Partners con OAuth | Las integraciones a nivel agregado mediante la API S2S para anuncios de Meta, Google AdMob y Google Ad Manager utilizan OAuth, por lo que solo puedes configurarlas en la plataforma. Las integraciones de Google AdMob a nivel de impresión mediante el SDK se pueden configurar a través de la API. |
| API v1.0 | Ya no está disponible. Si la usaste, consulta Migrating from API v1.0. |