For the complete documentation index, see llms.txt. This page is also available as Markdown.

ChatGPT Ads (OpenAI)

Connect DinMo to ChatGPT Ads to send conversions, export first-party audiences, and publish product feeds.

The ChatGPT Ads platform connection lets DinMo send server-side conversions, keep first-party audiences up to date, and publish a product catalog feed to OpenAI.

Supported destination services

DinMo supports the following destination services:

Each destination service receives only the credentials it needs. For audiences, DinMo normalizes raw identifiers and validates identifiers explicitly mapped as SHA-256 before delivery. For conversions, DinMo hashes raw identifiers and preserves valid SHA-256 values. DinMo also converts mapped conversion amounts to the minor units required by OpenAI.

Prerequisites

Before connecting ChatGPT Ads, make sure you have:

  • access to the relevant ad account;

  • an active conversion pixel and its Pixel ID;

  • a Conversions API key created for the ad account that owns the pixel;

  • the Ads API key associated with the ad account.

An active conversion Event Setting linked to the pixel is required before you configure a conversion activation. To export a product feed, first create an SFTP feed connection in ChatGPT Ads Manager and copy its host, port, username, and password.

OpenAI describes the API resources in its Conversions API guide and conversion setup reference.

Credentials and their purpose

Credential
Used by DinMo for

Conversions API key

Validating and sending conversion events with the configured Pixel ID.

Ads API key

Validating the ad account, loading active Event Settings, and synchronizing Custom Audiences.

Product feed SFTP credentials

Uploading a full product catalog snapshot to the feed configured in ChatGPT Ads Manager.

DinMo stores API keys and the SFTP password as encrypted secrets. The activation runtime receives only the credentials required by the selected destination service.

Connect ChatGPT Ads to DinMo

  1. In DinMo, open Destinations and select New destination.

  2. Select Connect a new platform.

  3. Select ChatGPT Ads (OpenAI).

  4. Enter a recognizable connection name.

  5. Enter the Pixel ID from the ChatGPT Ads Manager Conversions tab.

  6. Paste the Conversions API key created for the ad account that owns the pixel.

  7. Paste the Ads API key associated with the same ad account.

  8. To use product feeds, enter the SFTP host, port, username, and password shown for the feed in ChatGPT Ads Manager.

  9. Save the platform connection.

DinMo verifies that the Ads API key can access the ad account and configured pixel. It also sends a validation-only event with the Pixel ID and Conversions API key. The validation request does not record a conversion. SFTP credentials are verified when a product feed activation connects to the remote server.

After the connection succeeds, add one or more supported destination services to it. For conversion events, select an existing active Event Setting rather than entering an event name manually. DinMo does not create conversion Event Settings.

Rotate credentials

Edit the platform connection and enter the replacement credential. Leaving a secret field unchanged preserves the current encrypted secret.

Rotating the Ads API key affects Event Setting discovery and audience synchronization. Rotating the Conversions API key affects event delivery. Replace all affected SFTP values if the feed credentials are rotated.

Troubleshooting the connection

The ad account cannot be loaded

Confirm that the Ads API key is active and belongs to the ad account that owns the pixel. OpenAI scopes each Ads API key to one ad account.

Event validation fails

Confirm that the Pixel ID is accessible from the same ad account as the Conversions API key. Do not paste the Ads API key into the Conversions API key field.

A conversion event is missing

Confirm that the Event Setting is active in ChatGPT Ads Manager, belongs to the connected ad account, and uses the configured pixel as its conversion source. Then refresh or reopen the activation configuration.

A product feed cannot connect

Confirm that all four SFTP fields come from the same feed connection in ChatGPT Ads Manager. Check the host, port, username, and password without substituting either API key.

Last updated