¿Cómo podemos ayudar?

Configura mediante API las integraciones de Partners de ingresos por anuncios de ROI360 Premium

  • Actualización

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

  1. Prepara la lista de integraciones: App ID, partner, tipo de integración, credenciales y evento fuente (cuando sea necesario).
  2. Dale a tu desarrollador el token de la API V2 y esta lista.
  3. 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.
  4. 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.