Documentation Index
Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Destination Type: and
Installation instructions
-
Navigate to your and choose Tools > Conversions.
-
Click Create > Data source.
- Give it a name (e.g.,
Converge Pixel), select Type Web, and click Create.
- In the Copy data source screen, copy the ID and keep it handy. Click Confirm when you’re done.
- In the same Tools > Conversions page, click Manage conversion keys > Create new key.
- Give it a name (e.g.,
Converge) and click Create.
- In the Save your key screen, click Copy to copy the key to your clipboard and keep it safe.
-
In the Converge sidebar, click on and then click Create new Destination.
-
Select the OpenAI Ads destination and click Next.
-
Give your destination a name (e.g. OpenAI Ads Destination) and click Next.
-
In the Authentication screen, fill in the Pixel Id you copied on step 4, fill in Conversions API Key with the key you copied on step 7, and click Next.
-
In the Configuration screen, fill in the Domain name with your domain name (e.g. example.com), and click Next.
-
Select Use default mapping and click Next.
You can find the Default mapping for the OpenAI Ads destination
here. For more information on setting up Custom mappings, look
here.
-
Select the sources you want to forward events from, then click Next.
-
Review any issues and click Submit.
Once you have installed your Converge Destination, you should pause or remove all existing OpenAI Ads tracking. Leaving these on will lead to duplicate tracking.
Modify your Item ID
The Converge OpenAI Ads destination, by default, will use the Product ID as the item identifier for the events being tracked.
However, you can configure the destination to use explicitly the Product ID, the Variant ID or SKU if you so choose, or use a custom item ID.
- Navigate to your OpenAI Ads destination, click on Configuration.
- Click on the Configuration-subtab
- Open the Advanced configuration (optional) section
- Pick your desired Item ID, and click on Save
List of Item ID Modes
| Content ID Mode | Behavior |
|---|
| Product ID | The ID of the product (product_id) |
| Variant ID | The ID of the variant of the product (variant_id) |
| SKU | The SKU of the product (sku) |
| Custom | An arbitrary item ID derived from the event data |
Converge functionality
This integration supports the following Converge destination functionality.
| Converge Feature | Supported |
|---|
| Custom Events | |
| Filters | |
| Server-side Conversions | |
| Conversion amount | |
Event mapping
Converge automatically maps the following events from the Converge event spec to the :
| Converge Event Name | Meta Event Name |
|---|
| $page_load | page_viewed |
| Viewed Product | contents_viewed |
| Viewed Collection | contents_viewed |
| Added To Cart | items_added |
| Added To Wishlist | items_added |
| Started Checkout | checkout_started |
| Added Payment Info | checkout_started |
| Placed Order | order_created |
| Started Subscription | subscription_created |
| Activated Subscription | subscription_created |
| Subscribed To Newsletter | lead_created |
| Signed Up | registration_completed |
