Integraciones con socios

AdsGram admite la integración con plataformas populares de atribución y seguimiento. Estas le permiten rastrear clics, instalaciones y acciones de los usuarios después de interactuar con los anuncios de AdsGram, así como enviar datos de conversión de vuelta a AdsGram, lo que le permite optimizar campañas por costo de conversión (tCPA).

Las siguientes integraciones están disponibles:

• AppsFlyer
• Adjust
• AppMetrica
• Kochava
• Keitaro

También puede usar enlaces de otras plataformas de seguimiento. Sin embargo, en este caso, AdsGram no podrá transferir toda la información necesaria al rastreador para un análisis más detallado.

Adjust

1. Elegir Red

En la sección Campaign Lab, vaya a Partners

• Haga clic en New Partner.
• En la barra de búsqueda, escriba AdsGram y seleccione esta red.
• Después de seleccionar, haga clic en Next.

2. Elegir la Aplicación

En la siguiente pantalla, elija la aplicación para la cual desea crear el enlace. Use la barra de búsqueda para encontrar su aplicación, o desplácese por la lista para encontrarla. Puede configurar enlaces para una aplicación a la vez.
Después de seleccionar la aplicación, haga clic en Next.

3. Establecer Opciones de Compartir Datos

En esta sección, configurará los parámetros de compartir datos con AdsGram, seleccionando qué eventos y parámetros de la aplicación se enviarán a AdsGram para análisis.
Instrucciones detalladas están disponibles en la página de documentación de Adjust.

4. Obtener Enlace de Seguimiento

Después de configurar todos los parámetros y asignaciones, recibirá un enlace de seguimiento único, que debe usarse al crear campañas publicitarias en AdsGram.
Además, puede agregar parámetros adicionales como etiquetas UTM para un seguimiento más preciso de las fuentes de tráfico.

5. Transferencia de Datos de Conversión

De forma predeterminada, los datos de actividad de los usuarios se transfieren de Adjust a AdsGram y se asignan automáticamente a los objetivos correspondientes:

• Sesiones (Sessions) - a Goal 1
• Instalaciones (Installs) - a Goal 2

IMPORTANTE

Para lanzar una campaña tCPA, es necesario recibir al menos 10 conversiones para el objetivo seleccionado. Por ejemplo, si la campaña se lanza con Goal 2, es necesario recibir al menos 10 conversiones para Goal 2.

AppMetrica

Crear un rastreador:

1. Después de registrarse en la cuenta personal de AppMetrica, integrar el SDK en la aplicación y configurar el seguimiento de acciones de destino, puede proceder a crear el rastreador.
2. Especifique el nombre del rastreador.
3. Agregue la aplicación.

Instrucciones detalladas están disponibles en la página de documentación de AppMetrica.

Transferencia de datos de instalación:

4. Elija el receptor del postback (AdsGram).
5. Especifique el tipo de evento que necesita enviarse a AdsGram.
6. Obtenga la URL de Postback — el enlace a través del cual se enviarán eventos e instalaciones al servidor de AdsGram.
7. Después de crear los postbacks, recibirá un enlace de seguimiento. Este enlace debe usarse al crear campañas en AdsGram. Además, puede agregar parámetros adicionales, como etiquetas UTM, si es necesario.

Keitaro

1. Crear un Rastreador en Keitaro

1. Después de iniciar sesión en el panel de Keitaro, vaya a la sección Trackers.
2. Haga clic en Create tracker o New tracker.
3. Ingrese el nombre del rastreador y seleccione AdsGram como tipo de fuente de tráfico.
4. Haga clic en Save para crear el rastreador.

2. Configurar Postback en Keitaro

1. En la configuración del rastreador creado, vaya a la sección Postback o API Integration.

2. En el campo Postback URL, ingrese el endpoint de AdsGram:

   https://api.adsgram.ai/confirm_conversion?

3. Agregue el parámetro token requerido y el parámetro record. El nombre del parámetro debe coincidir con el parámetro record especificado en el Tracking Link.

   Por ejemplo, si pasa el macro de AdsGram en el Tracking Link de la siguiente manera:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&record={record_data}

   entonces debe especificar lo siguiente en el postback de Keitaro:

   https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record={_record}

   Donde:

   • YOUR_UNIQUE_TOKEN — el token de su perfil de AdsGram
   • record — el parámetro que pasa en el Tracking Link
   • {_record} — un macro que pasa el valor original del parámetro record al postback

   ATENCIÓN

   Para obtener un valor sin formato del sistema de seguimiento, agregue "_" (guión bajo) antes del nombre de la macro. Solo es relevante para el rastreador Keitaro y es necesario para prevenir ataques XSS.

3. Configurar una Campaña en AdsGram

1. Copie la Click URL de la configuración de su rastreador Keitaro (por ejemplo: https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
2. En el panel de AdsGram, al crear una campaña, pegue este enlace en el campo Click URL.
3. Agregue las macros requeridas de AdsGram al enlace:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}

4. Asegúrese de que la macro {record_data} esté incluida en el enlace final.

4. Configurar Objetivos en Keitaro

1. En la configuración de su rastreador Keitaro, vaya a la sección Goals o Conversions.
2. Cree un nuevo objetivo o seleccione uno existente.
3. Habilite el envío de postback a la URL especificada anteriormente para este objetivo.
4. Defina las condiciones de activación (por ejemplo, tras la confirmación de conversión o estado específico).

Kochava

1. Crear un Rastreador en Kochava

1. Después de iniciar sesión en el panel de Kochava, vaya a la sección Apps & Assets.
2. Haga clic en Add New y seleccione App para crear un nuevo rastreador de aplicación.
3. Complete los campos requeridos:
   • Platform: Elija la plataforma de la aplicación (iOS, Android, Web).
   • App Name: Ingrese el nombre de su aplicación.
   • Store ID: Ingrese el identificador de la tienda de la aplicación (App Store ID, Package Name, etc.).
4. Haga clic en Save para crear la aplicación.

2. Configurar Integración con Socios

1. En la página de la aplicación creada, navegue a la sección Partner Management.
2. Haga clic en Add Partner.
3. Encuentre y seleccione AdsGram de la lista de socios.
4. Haga clic en Next para proceder a la configuración.

3. Configurar Parámetros de Integración

1. En la sección Integration Settings, seleccione el tipo de seguimiento (Click-Through, View-Through o Hybrid).

2. Habilite la opción Server-to-Server Postbacks.

3. En el campo Postback URL, ingrese el endpoint de AdsGram:

   https://api.adsgram.ai/confirm_conversion

4. Agregue los siguientes parámetros a Postback Parameters:

   • Parámetro requerido: {record_data} (insertado automáticamente por Kochava).
   • Agregue parámetro: token con el valor YOUR_UNIQUE_TOKEN (tomado de su perfil de AdsGram).

5. Configure las macros de asignación de datos:

   • {campaign_id} → campaign_id
   • {click_id} → click_id
   • {publisher_id} → publisher_id

4. Configurar una Campaña en AdsGram

1. Regrese a la sección Tracking Links en Kochava y cree un enlace de seguimiento (por ejemplo: https://your-app.kochava.com/install?data={encrypted_data}).
2. En el panel de AdsGram, al crear una campaña, pegue este enlace en el campo Click URL.
3. Agregue las macros obligatorias de AdsGram al enlace como parámetros:

   https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}

4. Asegúrese de que la macro {record_data} esté incluida en la URL final.

5. Configurar Eventos en Kochava

1. En el panel de Kochava, vaya a la sección Events.
2. Cree un nuevo evento o elija uno estándar (por ejemplo, install, purchase).
3. Configure el postback para el evento seleccionado:
   • Habilite Send Postback.
   • Seleccione la integración de AdsGram creada anteriormente.
   • Defina filtros y condiciones de activación.
4. Guarde la configuración del evento.

6. Probar la Integración

1. Use el Modo de Prueba en Kochava para verificar el seguimiento de instalaciones.
2. Compruebe las solicitudes entrantes en los registros de Kochava y AdsGram.
3. Asegúrese de que el parámetro record_data se esté pasando correctamente.

AppsFlyer

La integración de AdsGram con AppsFlyer le permite enviar datos sobre instalaciones de aplicaciones y acciones de usuarios dentro de la aplicación a AdsGram.

Una vez configurada la integración, AdsGram recibirá:

• Instalaciones de la aplicación (Installs) - asignadas automáticamente a Goal 1
• Todos los demás In-App Events - asignados automáticamente a Goal 2

No se requiere configuración adicional ni asignación de eventos a objetivos en AdsGram. Por ejemplo, si desde AppsFlyer se envían eventos como registration, purchase, deposit, etc., todos se contabilizarán automáticamente en Goal 2.

IMPORTANT

Las campañas tCPA solo se pueden lanzar en Goal 1. Esto significa que las campañas tCPA solo se pueden optimizar para instalaciones de aplicaciones. Los In-App Events enviados a Goal 2 no se pueden usar como objetivo para campañas tCPA.

1. Conexión de AdsGram a través de Integrated Partners

AdsGram es un socio integrado de AppsFlyer. Para conectar:

• Vaya a Collaboration → Partner Marketplace en AppsFlyer
• Busque AdsGram (nombre de marketing) o adsgram1e_int (nombre técnico) y seleccione el socio

2. Configurar los Postbacks de instalación

Abra la pestaña Integration:

• Active Activate Partner
• Desactive AAP (debe desactivarse tanto en la configuración de la aplicación como en esta pestaña)
• En Install Postback, seleccione This partner only. Esto significa que AdsGram recibirá las instalaciones atribuidas a AdsGram. Estas instalaciones se contabilizarán como Goal 1 en AdsGram.

IMPORTANT

Si desea lanzar una campaña optimizada para instalaciones, asegúrese de que las instalaciones se envíen a AdsGram y se muestren en Goal 1. Las campañas tCPA optimizadas para instalaciones solo se pueden lanzar en Goal 1.

3. Configurar los Postbacks de eventos in-app

Configure los postbacks para los In-App Events (compras, registros, etc.) en la sección In-App Event Postbacks:

• Agregue los eventos necesarios, por ejemplo:
  • purchase - compras
  • af_complete_registration - registros
• En el campo For users from, seleccione This partner only
• AdsGram solo recibe el evento en sí, sin sus parámetros ni ingresos. Por lo tanto, en Including, puede seleccionar No values & no revenue

Recomendado:

• Permitir la configuración de la integración (excepto los postbacks de eventos in-app)
• Permitir la configuración de postbacks de eventos in-app

Otros permisos (informes de retención, ingresos, etc.) son opcionales.

Después de configurar la integración, haga clic en Save Integration.

4. Configurar el Tracking Link

Abra la pestaña Tracking Link:

• AppsFlyer generará automáticamente un enlace de seguimiento para AdsGram y añadirá el identificador de socio requerido: pid=adsgram1e_int
• Los 4 macros de AdsGram se completarán automáticamente (af_storeid, c, etc.)
• Si es necesario, agregue parámetros estáticos como parámetros adicionales
• En Click-through attribution, seleccione la ventana de atribución. El valor predeterminado es 7 días, pero puede cambiarlo si es necesario

5. Configurar Permissions

Abra la pestaña Permissions y active los permisos requeridos:

• Acceso al panel de la aplicación
• Conversiones agregadas
• Eventos
• Protect360

👉 Haga clic en Save Integration

6. Configuración de la campaña en AdsGram

Al crear una campaña en AdsGram:

• Inserte el Click link en el campo Link. El sistema generará automáticamente un enlace de seguimiento de AppsFlyer y añadirá los macros necesarios
• Especifique en el enlace de seguimiento de AppsFlyer el nombre de su package/bundle si aún no está incluido (por ejemplo, id12345678 o com.app.name)
• En el campo Link que aparece, ingrese el enlace directo a su producto en Google Play / App Store / RuStore

7. Notas

• La configuración se aplica a todos los banners dentro de la campaña
• El anunciante es responsable de los parámetros correctos del enlace y la atribución
• Al usar un enlace personalizado, también debe especificar un enlace directo al producto en el campo Link