Platforms, unified entities, vendor APIs, endpoints and connectors.
ads.campaignUnifiedSoonA campaign with its objective, budget and status, and the ad sets under it.
key platform + campaign ID9 planned callsNo Direct endpoint yet
Our own first draft of the paths, not reviewed yet. Each call acts on the platforms it lists through the Connection you grant, and none is deployed yet.
/Campaigns with status, budget and spendAll 8 ad platformsDraft/Campaigns, ad sets and ads as one treeAll 8 ad platformsDraft/One campaign as the platform holds it nowAll 8 ad platformsDraft/Spend and results of one campaign by dayAll 8 ad platformsDraft/Create a campaign with its objective and budgetAll 8 ad platformsDraft/Change budget, bidding or nameMeta · Google · Reddit · OpenAIDraft/Pause or resume one campaign or manyAll 8 ad platformsDraft/Copy a campaign with its ad sets and adsMeta · TikTok · LinkedInDraft/Delete a campaignAll 8 ad platformsDraftA first cut of the schema from the ad platforms' own objects. Names, types and coverage can change before the Unified layer ships.
ad_accountAdAccountReportednamestringReportedobjectivestringReportedMapped to one list, with the platform's own value keptstatusStatusReportedActive, paused or archived, in one set of statusesbudgetBudgetReportedDaily or lifetime, in the account currencybid_strategystringReportedstarts_atdatetimeReportedends_atdatetimeReportedspendMoneyReportedimpressionsintegerReportedclicksintegerReportedconversionsnumberReportedCounted with each platform's own attribution windowVendor endpoints that already return this kind of object, in the vendor's own format. Your code names the vendor, so switching vendors means changing it.
No Direct endpoint returns Campaign yet. It comes with the Unified layer.
Each link is a field you can ask for in the same call.
platform + ad account IDAn ad account on one ad platform, with its currency, time zone, spend and spending limit.
platform + ad set IDThe targeting, budget and placements a group of ads shares. Google calls it an ad group.
platform + ad IDOne ad with its creative, review result, spend and results. Ads from a public ad library come back too.