Platforms, unified entities, vendor APIs, endpoints and connectors.
ads.ad_setUnifiedSoonThe targeting, budget and placements a group of ads shares. Google calls it an ad group.
key platform + ad set ID7 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.
/The ad sets of a campaignAll 8 ad platformsDraft/One ad set's targeting, budget and placementsAll 8 ad platformsDraft/Add an ad group to a Google campaignGoogleDraft/Change an ad set's name, budget or biddingAll 8 ad platformsDraft/Pause or resume an ad setAll 8 ad platformsDraft/Copy an ad set, paused, with or without its adsMeta · TikTokDraft/Delete an ad setAll 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.
campaignCampaignReportednamestringReportedstatusStatusReportedtargetingTargetingReportedLocations, ages, interests and audiences in one shapeaudiencesAudience[]ReportedbudgetBudgetReportedoptimization_goalstringReportedplacementsstring[]ReportedspendMoneyReportedresultsnumberReportedVendor 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 AdSet yet. It comes with the Unified layer.
Each link is a field you can ask for in the same call.
platform + campaign IDA campaign with its objective, budget and status, and the ad sets under it.
platform + ad IDOne ad with its creative, review result, spend and results. Ads from a public ad library come back too.
platform + audience IDA custom or lookalike audience, built from a hashed customer list or site visitors.