# Thrad Docs

- [Introduction](https://docs.thrad.ai/introduction.md): For publishers: what Thrad does, and how to go from sign-up to live ads.
- [Quickstart](https://docs.thrad.ai/quickstart.md): Get your first ad on screen with your staging key.
- [Agent Skills](https://docs.thrad.ai/agent-skills.md): Install a Thrad skill so your coding agent integrates the API for you.
- [Ad Formats & Rendering](https://docs.thrad.ai/api/guides/rendering-v2.md): Available ad formats, what each bid carries, and how to render and track it.
- [User & Chat Identification](https://docs.thrad.ai/api/guides/user-identification-v2.md): How user.id and context.id improve ad targeting, frequency capping, and monetization.
- [Impression Billing](https://docs.thrad.ai/api/guides/billing-viewability.md): How impressions are counted, viewability requirements, and how to avoid ad blockers.
- [Best Practices](https://docs.thrad.ai/api/guides/best-practices.md): Harden your integration with proper error handling, timeouts, rate limits, and testing strategies.
- [Go live](https://docs.thrad.ai/go-live.md): Check your integration, then switch to production and authorize Thrad in ads.txt.
- [Revenue & Metrics](https://docs.thrad.ai/insights/overview.md): Pull your impressions, revenue, and fill rate into your own dashboards and reports.
- [Bid Request (v2)](https://docs.thrad.ai/api/api-reference/bid-request-v2.md): One request, one auction, one strict contract.
- [Feedback](https://docs.thrad.ai/api/api-reference/feedback-v2.md): Send a user's thumbs up or thumbs down on an ad.
- [Poll Voting](https://docs.thrad.ai/api/api-reference/poll-voting.md): Send a user's poll answer and get back the results to show.
- [Insights](https://docs.thrad.ai/insights/api-reference.md): The publisher insights endpoint — query parameters, the bare list response, and the error catalog.
- [Publishers](https://docs.thrad.ai/insights/publishers.md): List the publishers your API key can read, with the ids to pass as publisher_id.
- [Bid Request (v1)](https://docs.thrad.ai/api/api-reference/bid-request.md): Orchestrates a multi-bidder auction across multiple DSPs and returns the winning ad creative in a single request
- [Feedback (v1)](https://docs.thrad.ai/api/api-reference/feedback.md): Record user feedback (thumbs up / thumbs down) for an ad impression
- [Poll Tracking (v1)](https://docs.thrad.ai/api/api-reference/sponsored-poll-tracking.md): Submit sponsored poll votes and retrieve signed aggregate results for direct API integrations.
- [Publisher Configuration](https://docs.thrad.ai/api/guides/publisher-config.md): Configure ad pacing, contextual serving, creative constraints, and experiments using the config object.
- [Ad Formats & Rendering](https://docs.thrad.ai/api/guides/rendering-ads.md): Available ad formats, how to identify them in the response, and how to render them.
- [Tracking & Viewability](https://docs.thrad.ai/api/guides/tracking.md): How to track ad impressions and clicks across web and mobile integrations.
- [User & Chat Identification](https://docs.thrad.ai/api/guides/user-identification.md): How user_id and chat_id improve ad targeting, frequency capping, and monetization.
- [Introduction](https://docs.thrad.ai/advertisers/introduction.md): Build and run ad campaigns on Thrad — and across ChatGPT — straight from your own code.
- [Quickstart](https://docs.thrad.ai/advertisers/quickstart.md): Create your API key, pick a creative asset, launch a campaign in one nested call, and read performance — end to end with cURL.
- [Introduction](https://docs.thrad.ai/advertisers/attribution/overview.md): Track ad-driven traffic, events, and conversions with the Browser Tag or the Server-to-server Conversions API.
- [Install the Tag](https://docs.thrad.ai/advertisers/attribution/tag/install.md): Drop one script into the page <head> and the Tag is live.
- [Track events](https://docs.thrad.ai/advertisers/attribution/tag/events.md): Call thradTag("event", name, params) for any standard or custom event.
- [Track purchases](https://docs.thrad.ai/advertisers/attribution/tag/conversions.md): Fire window.thradTag("conversion", ...) on the order confirmation page.
- [Image pixel fallback](https://docs.thrad.ai/advertisers/attribution/tag/image-pixel.md): Use a first-party 1x1 image request when JavaScript cannot run.
- [First-party proxy](https://docs.thrad.ai/advertisers/attribution/tag/first-party-proxy.md): Send Tag requests through your own domain to improve delivery.
- [GTM integration](https://docs.thrad.ai/advertisers/attribution/tag/guides/google-tag-manager.md): Install the Thrad Tag and fire events via Google Tag Manager. The path most advertisers use.
- [Shopify](https://docs.thrad.ai/advertisers/attribution/tag/guides/shopify.md): Install the Thrad tag, connect your checkout pixel, and verify purchase tracking.
- [Framer](https://docs.thrad.ai/advertisers/attribution/tag/guides/framer.md): Install the Thrad Tag on a Framer site via Site Settings → Custom Code.
- [Server-to-server Conversions API](https://docs.thrad.ai/advertisers/attribution/server-events/overview.md): Send conversions from your backend to Thrad for attribution and OpenAI measurement.
- [Authentication](https://docs.thrad.ai/advertisers/attribution/server-events/authentication.md): The Server-to-server Conversions API requires a bearer API key.
- [Identity and consent](https://docs.thrad.ai/advertisers/attribution/server-events/identity-and-consent.md): Send matching data safely and control whether an event can be measured.
- [Testing and troubleshooting](https://docs.thrad.ai/advertisers/attribution/server-events/testing.md): Validate an integration safely before sending live conversions.
- [Event reference](https://docs.thrad.ai/advertisers/attribution/server-events/event-reference.md): Request shape, event names, data types, and response outcomes.
- [Product feeds](https://docs.thrad.ai/advertisers/feeds/overview.md): Connect your product catalog once and let Thrad keep your ads in sync with what's actually in stock.
- [Connect a feed](https://docs.thrad.ai/advertisers/feeds/connect.md): Add a feed, connect over SFTP, upload your catalog, and use your products in campaigns.
- [Advertiser API Overview](https://docs.thrad.ai/advertisers/overview.md): Programmatically create and manage Thrad ad campaigns and read combined Thrad + ChatGPT performance insights over a single REST surface.
- [Authentication](https://docs.thrad.ai/advertisers/api-reference/authentication.md): Authenticate to the Thrad Advertiser API with an org-bound Bearer key, and manage that key from the Platform dashboard.
- [Geographic Targeting](https://docs.thrad.ai/advertisers/api-reference/campaign-targeting.md): Target campaigns by country with targeting.locations.include — country-level only, no region or DMA targeting.
- [Campaigns](https://docs.thrad.ai/advertisers/api-reference/campaigns.md): Create, list, retrieve, update, and control the lifecycle of advertiser campaigns.
- [Ad Groups](https://docs.thrad.ai/advertisers/api-reference/ad-groups.md): Group ads under a campaign with shared context hints and a max bid. Create, list, retrieve, update, and change status.
- [Ads](https://docs.thrad.ai/advertisers/api-reference/ads.md): Create and manage ads (the creative that runs inside an ad group) — cards and polls.
- [Assets](https://docs.thrad.ai/advertisers/api-reference/assets.md): Browse the reusable asset catalog — the images and destination URLs your ads reference by asset_id.
- [Ad Account](https://docs.thrad.ai/advertisers/api-reference/ad-account.md): Retrieve your organization's default ad account — the top-level scope every campaign, ad group, and ad belongs to.
- [Insights](https://docs.thrad.ai/advertisers/api-reference/insights.md): Read-only analytics for your ad account, campaigns, ad groups, and ads — impressions, clicks, spend, and derived rates, bucketed over time and broken out by supply.
- [Introduction](https://docs.thrad.ai/dsp/introduction.md)
- [IVT & Verification](https://docs.thrad.ai/dsp/guides/ivt.md): How Thrad filters invalid traffic across the bid lifecycle, what signal we forward to your DSP, and how verification works on the impression event.
- [Overview](https://docs.thrad.ai/dsp/guides/ortb/overview.md): OpenRTB 2.6 integration with Thrad SSP.
- [Ad Formats](https://docs.thrad.ai/dsp/guides/ortb/ad-formats.md): Placement types available on the OpenRTB path.
- [Targeting Signals](https://docs.thrad.ai/dsp/guides/ortb/targeting.md): Targeting signals available in the Thrad SSP BidRequest.
- [Onboarding](https://docs.thrad.ai/dsp/guides/ortb/onboarding.md): How to get your DSP connected to Thrad SSP.
- [Bid](https://docs.thrad.ai/dsp/api-reference/ortb-bid.md): OpenRTB 2.6 bid endpoint your DSP must expose. Thrad SSP POSTs a BidRequest and expects a BidResponse or no-bid.
- [Delivery & Spend](https://docs.thrad.ai/dsp/guides/reporting.md): Pull your daily impressions and spend from Thrad to reconcile with your own numbers.
- [Report](https://docs.thrad.ai/dsp/api-reference/report.md): Your daily sent impressions, billable impressions, and spend: parameters, response, and errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.