Platforms, unified entities, vendor APIs, endpoints and connectors.
ads.conversionUnifiedSoonA purchase or signup sent from your server to the ad platforms, matched by hashed user data.
key event name + event ID5 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.
/Send purchases and signups from your serverMeta · Google · TikTok · LinkedIn · Pinterest · Reddit · OpenAIDraft/Where an account can receive conversions: pixels, actions or rulesMeta · Google · LinkedIn · Pinterest · Reddit · OpenAIDraft/Retract or restate conversions already sentGoogleDraft/How well the events you sent match usersMeta · PinterestDraft/The pixels and site tags an account can see, with install snippetsMeta · TikTok · LinkedIn · Pinterest · X · OpenAIDraftA first cut of the schema from the ad platforms' own objects. Names, types and coverage can change before the Unified layer ships.
event_namestringReportedevent_timedatetimeReportedvalueMoneyReporteduser_dataHashedIdsReportedEmails and phone numbers hashed with SHA-256 before sendingevent_idstringReportedLets the platform drop the copy of a pixel eventad_accountAdAccountReportedmatch_qualitynumberReportedThe platform's score for how well events match usersVendor 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 Conversion 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 + audience IDA custom or lookalike audience, built from a hashed customer list or site visitors.
marketplace + listing IDOne product page on one marketplace: price, rank, reviews and sales.