Plataformas, entidades Unified, APIs de fornecedores, endpoints e conectores.
ads.conversionUnifiedEm breveUma compra ou um cadastro enviado do seu servidor às plataformas de anúncios, associado por dados de usuário com hash.
chave nome do evento + ID do evento5 chamadas planejadasNenhum endpoint Direct ainda
Nosso primeiro rascunho dos caminhos, ainda sem revisão. Cada chamada age nas plataformas listadas pela Connection que você concede, e nenhuma está implantada ainda.
/ v1/ ads/ conversionsEnviar compras e cadastros a partir do seu servidorMeta · Google · TikTok · LinkedIn · Pinterest · Reddit · OpenAIRascunho/ v1/ ads/ conversion-destinationsOnde uma conta pode receber conversões: pixels, ações ou regrasMeta · Google · LinkedIn · Pinterest · Reddit · OpenAIRascunho/ v1/ ads/ conversions/ adjustmentsRetirar ou corrigir conversões já enviadasGoogleRascunho/ v1/ ads/ conversions/ qualityO quanto os eventos que você enviou correspondem a usuáriosMeta · PinterestRascunho/ v1/ ads/ tracking-tagsOs pixels e as tags de site que uma conta vê, com os snippets de instalaçãoMeta · TikTok · LinkedIn · Pinterest · X · OpenAIRascunhoUma primeira versão do schema, a partir dos objetos das próprias plataformas de anúncios. Nomes, tipos e cobertura podem mudar antes do lançamento da camada Unified.
event_namestringReportadoevent_timedatetimeReportadovalueMoneyReportadouser_dataHashedIdsReportadoE-mails e telefones com hash SHA-256 antes do envioevent_idstringReportadoPermite que a plataforma descarte a cópia de um evento do pixelad_accountAdAccountReportadomatch_qualitynumberReportadoA nota da plataforma para o quanto os eventos correspondem a usuáriosEndpoints de fornecedores que já retornam esse tipo de objeto, no formato do próprio fornecedor. Seu código indica o fornecedor, então trocar de fornecedor significa alterar o código.
Por enquanto nenhum endpoint Direct retorna Conversion; a entidade chega com a camada Unified.
Cada link é um campo que você pode pedir na mesma chamada.
plataforma + ID da conta de anúnciosUma conta de anúncios em uma plataforma de anúncios, com moeda, fuso horário, gasto e limite de gastos.
plataforma + ID do públicoUm público personalizado ou semelhante, criado a partir de uma lista de clientes com hash ou de visitantes do site.
marketplace + ID da página de produtoUma página de produto em um marketplace: preço, ranking, avaliações e vendas.