Atribución y CAPI de OpenAI Ads (ChatGPT)

Seguir
Avatar
Samar Perka
Updated
Configuración de ChatGPT Ads
Atribución y Conversions API
Configurar el enlace de tracking y los postbacks

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 de OpenAI Ads de Singular admite los flujos web-to-app descritos 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 " desde tu OpenAI Ads Manager . Usa el mismo Pixel ID y la misma Conversions API Key para todas las plataformas que configures, en lugar de uno distinto por plataforma. Consulta ¿Necesito un Pixel ID distinto para web y app móvil? más abajo.
    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. Configura el destino de redirección. Es el lugar al que se envía al usuario cuando no tiene la app instalada. El valor predeterminado es la URL de la tienda de tu app. Para enviar a esos usuarios a tu sitio web, elige la opción Web URL e ingresa el destino. Las campañas web que convierten en tu sitio usan esta opción.
  6. (Opcional) Agrega los parámetros o macros adicionales que necesites en la sección Additional Parameters. Agrégalos aquí en lugar de editar el enlace generado después.
  7. Haz clic en "Generate"
  8. Copia el "Click-through Tracking Link" para el paso siguiente

El enlace generado ya incluye los parámetros de campaña y las macros dinámicas de OpenAI Ads. Todos los parámetros se reenvían al destino de redirección, donde el Web SDK de Singular los lee para atribuir la conversión web. Un enlace generado se ve así:

https://yourapp.sng.link/XXXXX/YYYY?_dl=yourapp%3A%2F%2Fmy_default_deeplink&_smtype=3&wpcl={oppref}&wpscid={ad_group_id}&pcid={campaign_id}&_forward_params=1&pscid={ad_group_id}&pcrid={ad_id}&wpcrid={ad_id}&cl={oppref}&wpsrc=ChatGPT%20Web%20CAPI&wpcid={campaign_id}

No edites la query string generada. El enlace incluye wpsrc=ChatGPT%20Web%20CAPI, que define el Source al que está asociado el postback de OpenAI Ads. Si ese valor se modifica, se elimina o se vuelve a codificar, Singular no enviará los datos de conversión a OpenAI y no se mostrará ningún error. _forward_params=1 también debe mantenerse, porque es lo que reenvía los parámetros al destino de redirección. Si necesitas parámetros adicionales, agrégalos en la sección Additional Parameters de la configuración del enlace.

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
  3. Deja las macros del enlace tal como están. OpenAI Ads reemplaza {campaign_id}, {ad_group_id}, {ad_id}, {oppref} en el momento del clic, por lo que la desagregación de la campaña llega a Singular sin ninguna sustitución manual.

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
¿Necesito un Pixel ID distinto para web y app móvil?

No. Usa un Pixel ID de OpenAI por anunciante, marca o destino de partner de integración, no por plataforma. En Singular, usa el mismo Pixel ID y la misma Conversions API Key para la medición en web, iOS y Android.

Singular define la plataforma en cada evento automáticamente: action_source: "web" para eventos web y action_source: "mobile_app" para eventos de iOS y Android. No hay nada que configurar para esto.

OpenAI no admite actualmente fuentes de datos móviles nativas, por lo que no existe una fuente de datos de tipo app para crear. Crea una fuente de datos web y usa su Pixel ID para todas las plataformas que midas.

Los Pixel ID múltiples tienen otro propósito: cuando el mismo sitio web mide conversiones para más de un anunciante, marca o partner de integración. La plataforma no es un motivo para crear un segundo Pixel ID.

¿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.
action_source
  • Identifica la plataforma desde la que se originó el evento. Singular lo define automáticamente: web para eventos web y mobile_app para eventos de iOS y Android. Así se distinguen los eventos web y de app en un mismo Pixel ID, por lo que no se requiere un Pixel ID móvil aparte.
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.
¿Qué parámetros incluye el enlace de tracking generado?

Cada dimensión de campaña aparece dos veces. El parámetro del lado de la app atribuye la instalación, y el parámetro del lado web es el que lee el Web SDK de Singular para atribuir una conversión que ocurre en tu sitio web. Un solo enlace cubre ambos resultados.

Dimensión Lado de la app Lado web Macro de OpenAI Ads
Campaña pcid wpcid {campaign_id}
Grupo de anuncios pscid wpscid {ad_group_id}
Anuncio / creativo pcrid wpcrid {ad_id}
Click ID cl wpcl {oppref}

El enlace también incluye estos parámetros de control:

  • wpsrc=ChatGPT%20Web%20CAPI define el Source de Singular Web Attribution y es obligatorio para que se dispare el postback de OpenAI Ads. No lo modifiques.
  • _forward_params=1 reenvía los parámetros del enlace a los destinos de redirección de la tienda y del sitio web.
  • _dl contiene el destino de deep link que el enlace abre cuando la app está instalada.
  • _smtype=3 se aplica cuando la atribución probabilística está habilitada en el enlace de tracking. Si la atribución probabilística está desactivada para el enlace, este parámetro no se agrega.
¿De dónde provienen los nombres de campaña?

El enlace de tracking captura los ID de campaña, grupo de anuncios y anuncio, no los nombres. Singular toma los nombres del Data Connector de OpenAI Ads y los asocia con los ID capturados en el enlace, de modo que tus reportes muestran nombres legibles junto a los clics y las instalaciones.

Por eso los nombres no se incluyen en el enlace. Los ID son claves de unión estables, así que una campaña que se renombra sigue reportando correctamente sobre los clics históricos.

Dimensión ID capturado en el enlace Nombre que aporta el Data Connector
Campaña adn_campaign_id adn_campaign_name
Grupo de anuncios adn_sub_campaign_id adn_sub_campaign_name
Anuncio / creativo adn_creative_id adn_creative_name

Los nombres de campaña y el costo provienen del Data Connector, así que configúralo junto con esta integración. Consulta OpenAI Ads (ChatGPT) Data Connector.