Primeiros passos

Primeiros passos

Esta página leva você do zero à primeira conversão offline dentro do Google Ads. Nada aqui é simulado: cada passo usa o SDK publicado e o caminho direct-confirm que já roda em produção.

1. Instale o SDK

npm install git+https://github.com/vizuh/apointoo-sdk.git hono zod

O pacote traz tipos de domínio, schemas zod, contratos de adaptadores e o pipeline de servidor (fila, outbox, upload de conversão).

2. Monte o handler

createBookingHandler devolve um app Hono. Monte na rota de API do seu Next.js, Worker ou servidor Node:

import { createBookingHandler } from '@vizuh/apointoo-sdk/server'
import { directConfirmAdapter } from '@vizuh/apointoo-sdk/adapters/booking/direct-confirm'

export const app = createBookingHandler({
  config: { /* configuração do seu tenant */ },
  booking: directConfirmAdapter(),
  state: memoryStateStore(),
})

3. Capture o clique

Atribuição de primeiro e último toque precisa existir no momento da conversão. No WordPress, o plugin Apointoo Capture guarda gclid, fbclid e UTMs nos formulários que você já usa. Em frontends próprios, os helpers de atribuição do SDK normalizam o contexto do clique.

4. Confirme o resultado

Quando a venda, a reserva ou o contrato acontece de verdade, confirme com a atribuição correspondente:

await apointoo.confirm({
  leadId: lead.id,
  outcome: 'sale_paid',
  value: 1840.0,
  currency: 'EUR',
})

5. Veja chegar no Google Ads

O confirm passa pela fila e pelo outbox; a conversão sobe com identificador de clique, valor e horário. Falhas tentam de novo. Os logs guardam cada recibo.

Próximos passos

• Conceitos principais: sessão, identidade e eventos canônicos.
• Adaptadores: troque direct-confirm pelo adaptador do seu sistema.
• Deploy: variáveis de ambiente e checklist de produção.