Atribuir conversões e vendas

Uma conversão é uma venda ou um pagamento de apoiante que o LinkHarbor consegue atribuir a um clique na sua página. Assim vê não só quantas vezes um link foi clicado, mas também o que resultou disso. Este artigo destina-se a criadores com loja própria e aos programadores que ligam a loja. Pode analisar conversões e criar segredos de callback a partir do Creator Pro.

#De onde vêm as conversões

• Vendas que a sua loja ou o seu servidor comunica através de um callback de venda
• Pagamentos de apoiantes via Stripe; um reembolso volta a remover a conversão, veja Pagamentos de apoiantes com Stripe

Cada conversão herda os dados do clique a que pertence: página, link, país, dispositivo, origem e parâmetros UTM. É por isso que aparece nas estatísticas exatamente onde o clique teve origem.

#Como funciona a atribuição

1. Um visitante clica num link da sua página
2. O LinkHarbor conta o clique e, ao redirecionar, acrescenta ao URL de destino o parâmetro lt_click_id com um ID de clique único
3. A sua página de destino (por exemplo, a loja) lê lt_click_id do endereço e guarda-o até à compra
4. Depois da compra, o seu servidor envia ao LinkHarbor um callback de venda com este ID de clique
5. A conversão aparece no painel e nas estatísticas da página

O ID do clique só é acrescentado a destinos que comecem por http:// ou https://. Os links para mailto: ou tel: não o recebem, porque aí o parâmetro estragaria o assunto ou o número de telefone. Os cliques de bots também não recebem ID de clique.

#Criar um segredo de callback

Um callback de venda tem de se identificar com um segredo de callback. Proprietários e admins gerem os segredos a partir do Creator Pro em «Callback e API», na secção da conta do menu.

1. Abra «Callback e API»
2. No cartão «Segredos de callback», clique em «+ Criar novo segredo»
3. Se quiser, introduza um nome, por exemplo «Callback da loja»
4. Clique em «Criar segredo»
5. Copie o segredo de imediato: só é mostrado uma vez

«Editar»

Altere o nome e o estado (ativo ou inativo). Um segredo inativo é recusado.

«↺ Rodar»

Cria um novo segredo. O antigo deixa de funcionar de imediato – por isso, introduza logo o novo na sua loja.

«Eliminar»

Remove o segredo depois de um pedido de confirmação.

«Último callback:»

Mostra quando o segredo foi usado pela última vez; caso contrário, «Ainda não utilizado».

Pode criar até 5 segredos de callback por espaço de trabalho.

#Enviar o callback de venda

O seu servidor envia um pedido POST à API do LinkHarbor. O segredo vai no cabeçalho X-Callback-Secret.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

Obrigatório. O ID do clique de lt_click_id (10–36 caracteres).

order_id

Obrigatório. O seu número de encomenda (1–128 caracteres). Só é contada uma conversão por número de encomenda, por isso um callback repetido não cria uma segunda.

amount

Obrigatório. O montante como número decimal.

currency

Obrigatório. Um código de moeda de 3 letras, por exemplo EUR.

occurred_at, meta

Opcional. O momento da compra e até 50 chaves próprias (1–64 caracteres cada) com informação adicional. Um valor é texto com no máximo 500 caracteres, um número, true/false ou null; a API recusa objetos aninhados.

Respostas

Todos os campos e códigos de erro para programadores estão em Enviar vendas e dados próprios.

#Analisar conversões

• Painel: os mosaicos «Conversões» e «CVR» e o cartão «Conversões» por fonte e meio UTM
• Estatísticas da página: o cartão «Conversões» com «CVR total», «CVR únicos» e «Decomposição»
• CVR total = conversões divididas pelos cliques; CVR únicos = conversões divididas pelos cliques únicos