Platforms, unified entities, vendor APIs, endpoints and connectors.
ads.audienceUnifiedSoonA custom or lookalike audience, built from a hashed customer list or site visitors.
key platform + audience ID6 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.
/Custom and lookalike audiences, with their sizeMeta · Google · TikTok · LinkedIn · Pinterest · XDraft/Create an audience from a customer list, site visitors or a lookalikeMeta · Google · TikTok · LinkedIn · Pinterest · XDraft/Add hashed emails or phone numbers to an audienceMeta · Google · TikTok · LinkedIn · Pinterest · XDraft/Delete an audienceMeta · Google · TikTok · LinkedIn · Pinterest · XDraft/Look up interests, locations and other targeting optionsMeta · Google · TikTok · LinkedIn · Pinterest · X · RedditDraft/Estimate how many people a targeting setup reachesMeta · LinkedIn · Pinterest · XDraftA first cut of the schema from the ad platforms' own objects. Names, types and coverage can change before the Unified layer ships.
ad_accountAdAccountReportednamestringReportedkindstringReportedCustomer list, company list, site visitors, engagement or lookalikestatusStatusReportedsizeBandReportedA range, as the platform reports itretention_daysintegerReportedVendor 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 Audience yet. It comes with the Unified layer.
Each link is a field you can ask for in the same call.
platform + ad set IDThe targeting, budget and placements a group of ads shares. Google calls it an ad group.
platform + ad account IDAn ad account on one ad platform, with its currency, time zone, spend and spending limit.
event name + event IDA purchase or signup sent from your server to the ad platforms, matched by hashed user data.