Atribución y CAPI de OpenAI Ads (ChatGPT)

Este artículo explica cómo configurar campañas de OpenAI Ads (ChatGPT) con la atribución y la Conversions API de Singular para campañas de apps móviles, instalaciones en PC/consola y campañas web.

Descripción general

Las soluciones de atribución web-to-app de Singular permiten a los marketers ejecutar campañas web que generan instalaciones de apps en plataformas móviles, de PC y de consola. La integración web-to-app de OpenAI Ads de Singular admite el flujo Direct to Store descrito en nuestra Guía de Web to App aquí .

Agregar la configuración de partner de ChatGPT en Singular

Agregar la configuración de partner de ChatGPT Ads en Singular

  1. Ve a Singular > Attribution > Partner Configuration
  2. Haz clic en " Add a Partner ", luego escribe y elige " OpenAI Ads (ChatGPT) "
  3. En el cuadro de diálogo, elige la app y la app/sitio web (plataforma) que quieres configurar. Esta integración admite apps móviles, web, de PC y de consola
  4. Pega el " Pixel ID " y la " Conversions API Key " de tu app desde tu OpenAI Ads Manager .
    Configuración de partner de OpenAI Ads (ChatGPT) en Singular con los campos Pixel ID y Conversions API Key completados
  5. De forma opcional, configura eventos adicionales para enviar a OpenAI y asígnalos a un "OpenAI Event Name"
    Configuración de postbacks en Singular que asigna eventos de ingresos y eventos in-app a nombres de eventos de OpenAI, con Send All e Include Revenue activados
  6. Haz clic en " Save " para finalizar.
Atributos de evento requeridos para "OpenAI Ads (ChatGPT)"

Atributos de evento requeridos para la integración "OpenAI Ads (ChatGPT)"

Para habilitar la integración de OpenAI Ads (ChatGPT), implementa y envía los siguientes atributos de evento. Distinguen entre mayúsculas y minúsculas.

Móvil

Envía los siguientes atributos de evento:

  • ehash : el hash SHA-256 de la dirección de correo del usuario, después de eliminar los espacios al inicio y al final y convertirla a minúsculas.
  • external_id_hash (opcional): el hash SHA-256 de un identificador de cliente pseudónimo y estable de tu sistema.
    • Si es posible, envía tanto ehash como external_id_hash para mejorar el matching. Si ehash no está disponible, envía como mínimo external_id_hash .

Web

Envía los siguientes atributos de evento:

  • page_url (requerido): la URL completa de la página donde ocurrió el evento (por ejemplo, https://shop.example.com/checkout/confirmation ).
  • ehash : el hash SHA-256 de la dirección de correo del usuario, después de eliminar los espacios al inicio y al final y convertirla a minúsculas.
  • external_id_hash (opcional): el hash SHA-256 de un identificador de cliente pseudónimo y estable de tu sistema.
    • page_url es obligatorio. En los campos de usuario, si es posible, envía tanto ehash como external_id_hash para mejorar el matching. Si ehash no está disponible, envía como mínimo external_id_hash .
Crear un Singular Link para "ChatGPT Ads"

Crear un Singular Link para "ChatGPT Ads"

  1. Ve a Singular > Attribution > Manage Links
  2. Selecciona tu app móvil en la lista de apps de la izquierda
  3. Selecciona "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)"
  4. Continúa con el proceso guiado de creación del enlace.
  5. Haz clic en "Generate"
  6. Copia el "Click-through Tracking Link" para el paso siguiente
Configurar tu campaña de OpenAI Ads (ChatGPT Ads)

Configurar tu campaña de OpenAI Ads (ChatGPT Ads)

  1. En OpenAI Ads Manager, crea una campaña y continúa hasta el paso de Ad Group.
  2. Ingresa el Singular Link creado arriba en el campo "Default Ad Destination URL":
    Configuración del grupo de anuncios de una nueva campaña de OpenAI Ads con un enlace de tracking sng.link de Singular en Default Ad Destination URL

Preguntas frecuentes

¿Cómo reporta Singular las atribuciones de ChatGPT?

Una vez que se registra una atribución, las atribuciones de ChatGPT se reportan de la siguiente manera:

  • Source = "ChatGPT"
  • Tracker Source Name = "ChatGPT"
¿Dónde se encuentra el Pixel ID?
  1. Ve a la página OpenAI Conversions .
  2. Selecciona " Create " y elige "Data Source": Página Conversions de OpenAI Ads Manager con el cuadro de diálogo Create new data source, nombrando Singular Pixel a una fuente de datos Web
  3. Cuando termines, copia el nuevo Pixel ID:
    Lista de fuentes de datos de OpenAI Ads Manager mostrando la entrada Singular Pixel con su Pixel ID debajo del nombre
¿Dónde se encuentra la Conversions API Key?
  1. Ve a la página OpenAI Conversions .
  2. Selecciona " Conversion keys " y elige "Create new key":
    Cuadro de diálogo Create New Conversion Key de OpenAI Ads Manager con el nombre Singular Conversions API Key
  3. Copia tu nueva clave en la Partner Configuration de Singular:
    Cuadro de diálogo Save your key de OpenAI Ads Manager mostrando la clave generada con los botones Copy y Download
¿Qué datos envía Singular a través de la API?
Parámetro Detalles
event_name
  • Un nombre de evento estándar o personalizado. Este campo se asigna automáticamente al Singular Event Name. Este valor ayuda a OpenAI a deduplicar eventos. El parámetro event_id también se usa en la deduplicación.
correo hasheado
  • Opcional
  • El correo hasheado se puede enviar como el atributo de evento instrumentado de Singular "ehash"
  • El valor del correo hasheado debe estar normalizado y hasheado con SHA-256
ID de usuario externo hasheado
  • Opcional
  • El ID externo hasheado se puede enviar como el atributo de evento instrumentado de Singular "external_id_hash"
Dirección IP
  • La dirección IP del cliente
user agent
  • El User-Agent del cliente
Para la deduplicación de eventos (opcional)
event_id
  • Parámetro requerido para la deduplicación
  • Envía el valor de event_id a Singular en los Event Arguments usando el nombre de atributo: " eventId ".
  • El parámetro event_id debe agregarse a tus eventos desde ambos: la Conversions API y el OpenAI Pixel.
  • El parámetro event_id es un identificador que permite distinguir de forma única entre eventos similares.