docs(chatgpt-ads): add the ChatGPT Ads integration guide - #211
Merged
RathodDarshil merged 3 commits intoSep 7, 2026
Merged
Conversation
Covers creating the Pixel and Conversions API key, connecting them in Linkrunner, mapping events, and building the ChatGPT campaign so the ad points at a Linkrunner campaign link. Screenshots are captured from the real Ads Manager and dashboard, with the fields the setup depends on highlighted. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PfVgVVEv7mrVmXZYcBBXDf
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PfVgVVEv7mrVmXZYcBBXDf
…nk examples Adds a step-by-step deep linking section: turning on deferred deep linking when creating the campaign, pasting the campaign link into ChatGPT Ads Manager, putting per-ad values in Landing page query parameters, and reading the result with getAttributionData(). Covers two things that are easy to get wrong: the tracking values are merged into the deep link, so the app must ignore parameters it does not recognise, and the deferred path only runs on a genuinely fresh install. The c param is gone from every link example and from the two Ads Manager screenshots. It is a default Linkrunner adds, and showing it led customers to think it was something they had to append themselves. The screenshots were re-captured rather than edited, which also removes a real customer subdomain from both. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PfVgVVEv7mrVmXZYcBBXDf
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the ChatGPT Ads (OpenAI) integration guide for LIN-2733: creating the Pixel and Conversions API key, connecting them in Linkrunner, mapping events, and building the ChatGPT campaign so the ad points at a Linkrunner campaign link.
Every step that touches a UI has a screenshot taken from the real ChatGPT Ads Manager and the Linkrunner dashboard, with the relevant field highlighted.
Two things worth a reviewer's eye, both verified against the live Ads Manager:
opprefis a reserved query-parameter name and the landing-page field rejects it, so the guide tells you not to add it; and the conversion credentials live under Tools → Conversions, which is a different key from the Ads API key under Settings.🤖 Generated with Claude Code
https://claude.ai/code/session_01PfVgVVEv7mrVmXZYcBBXDf