Artigos sobre: Configurações

S2S Postback

O Postback, também conhecido como S2S (Server-to-Server tracking) é uma forma de enviar automaticamente informações de conversão da sua loja Cartpanda para plataformas externas, como Redtrack, UTMify, Voluum, entre outras.

Isso permite acompanhar o desempenho das campanhas de tráfego, atribuir comissões corretamente para afiliados e manter suas ferramentas sincronizadas com os resultados da loja.

Quando o Postback é enviado?

Você pode configurar a Cartpanda para disparar postbacks nos seguintes momentos:

Evento	Quando acontece
`initiate_checkout`	Quando o cliente inicia o checkout
`initial_sale`	Quando o pedido é finalizado com sucesso
`upsell`	Quando uma oferta de upsell é aceita

Esses eventos podem ser ativados ou desativados individualmente na sua integração.

Promolink

O promolink é o endereço eletrônico (URL) que será utilizado para a promoção do produto nas plataformas de marketing. Ou seja, é o link de campanha.

Se você é produtor, ele será o link do produto + click ID.

Se você é afiliado, ele será o link de afiliado do produto (link contendo seu afid) + click ID.

Algumas plataformas de marketing geram esse link automaticamente já com o click ID e outros parâmetros.

Postback URL

Esse link funciona como um receptor das conversões e informações de venda. Ele é fornecido pela plataforma de marketing que estiver utilizando e é por meio dele que o nosso sistema fará o envio para que suas campanhas sejam devidamente atualizadas.

Na etapa de configuração da integração, siga as instruções para utilizar adequadamente.

Como funciona na prática?

1. Você gera um link com o parâmetro `cid`

Esse link é usado em campanhas e anúncios, com o parâmetro cid indicando o ID do clique.

https://sualoja.com/checkout:123456?cid=CLIQUE123

Esse cid será usado pela Cartpanda para vincular o clique à conversão.

2. Você insere a URL de postback na Cartpanda

A Cartpanda substitui os parâmetros dinâmicos na URL sempre que um evento ocorrer.

Exemplo de URL:

https://domain.com/postback?click_id={cid}&amount={total_price}&type={order_type}&product={product_name}&client_email={email}&affiliate_commission={amount_affiliate}

E se o clique não tiver cid?

Existe uma opção na Cartpanda que permite que o postback seja enviado mesmo se o cid estiver em branco. Basta ativar o toggle na configuração da integração.

E se houver múltiplos produtos ou upsells?

A Cartpanda envia postbacks separados para cada produto com afiliação, mesmo que tenham afids diferentes.

Exemplo:

Produto A com afid 123
Produto B (upsell) com afid 456

→ Dois postbacks são enviados, um para cada afiliação.

Primeiro Passo: Criando a integração

Se você for Produtor:

Vá em Admin > Rastreamento > Scripts
Crie uma nova integração S2S

Se você for Afiliado:

Vá em Produtos > Produtos que promovo > [Produto]
Clique em Nova integração S2S e insira sua URL de postback

Segundo Passo: Configuração

Na tela de nova integração, você deverá preencher corretamente o formulário com as informações solicitadas.

Nome	Função
Nome e Serviço	esse você pode preencher como preferir, são identificadores para melhor identificação caso você trabalhe com múltiplas integrações.
Moeda	nesse campo você deve definir em qual moeda você deseja que os valores sejam enviados no postback. O sistema irá converter para moeda selecionada: USD, EUR, BRL ou no caso da opção: “Não converter valores” serão enviados os valores na moeda da venda.
Aplicar para	defina nessa seção as regras para ativação e envio do postback de acordo com produtos específicos, coleções ou para todos os produtos (sempre).

⚠️ Postback URL

Essa etapa é a mais importante para garantir o bom funcionado da integração. Aqui definiremos a URL para onde o sistema enviará as conversões e informações da venda.

O postback URL é composto por: promolink + click ID + parâmetros com informações da venda encadeados.
Os parâmetros disponíveis para uso estão indicados abaixo do postback URL, e devem ser encadeados com o símbolo & após o click ID.
Exemplo: https://domain.com/postback?click_id={cid}&amount={total_price}&type={order_type}&product={product_name}&client_email={email}&affiliate_commission={amount_affiliate}.

Ativação e notificações

Por último, você deverá ativar a chave para garantir que a integração está ligada e funcional e configurar quais eventos serão registrados.

Também é possível incluir um e-mail para receber notificações em caso de erros no envio dos postbacks a URL configurada.

Terceiro Passo: testando a integração

Nesta etapa, com sua integração já configurada e salva, iremos validar a conexão com seu postback URL para garantir que está tudo pronto para rodar as campanhas de marketing.

Testando a conexão

Você deverá acessar novamente a integração em **Admin > Rastreamento e Script > S2S Tracking.
Clique no título da integração que deseja testar.

No fim da página, clique no botão “Testar conexão” e um pop up será aberto.

Aqui você poderá inserir o promolink fornecido pela sua plataforma de marketing já com o click ID, ou você poderá inserir um link de checkout do seu produto na Cartpanda incluindo um click ID ao final: ?cid=algum-click-id.

— Atenção: algumas plataformas de marketing apenas retornarão sucesso no teste de conexão caso você utilize o promolink com um click ID válido fornecido por eles.

Clique em testar e verifique o resultado.

a. Caso esteja tudo bem, uma mensagem de sucesso será exibida na tela.

b. Caso tenha algum problema com o postback URL, o erro técnico será mostrado.

Testando com pedidos

Após garantir que a conexão está funcional, você poderá validar complemente a integração realizado um teste de ponta a ponta, ou seja, você ira abrir o promolink como um cliente e irá finalizar uma compra na Cartpanda.

Para realizar pedidos teste na Cartpanda, você deverá seguir essas instruções.

Lista de parâmetros para o S2S Postback URL

Informação	Parâmetro	Descrição	Exemplo
Click ID	`{cid}`	ID usado pelo sistema de rastreamento para atribuir a compra a um clique.	`123456789`
Chave da campanha	`{campaignkey}`	Chave opcional para identificar campanhas distintas.	`Facebook Campaign`
País	`{country}`	País da compra, com base no IP do comprador.	`Germany`
Valor do afiliado	`{amount_affiliate}`	Valor da comissão paga ao afiliado.	`€15.03`
Moeda	`{currency}`	Moeda em que a compra foi realizada.	`EUR`
ID do produto	`{product_id}`	Identificador interno do produto.	`62686`
Nome do produto	`{product_name}`	Nome do produto comprado.	`Cápsula de cafeína`
Tipo do pedido	`{order_type}`	Fase da venda: venda inicial ou upsell.	`initial_sale`, `upsell`
Posição do upsell	`{upsell_no}`	Posição da oferta no funil de vendas.	`3` (= terceiro upsell)
Slug da loja	`{shop_slug}`	Identificador único da loja na Cartpanda.	`sua-loja`
Slug do afiliado	`{affiliate_slug}`	Identificador único do afiliado na Cartpanda.	`AnnasShop`
Código do afiliado	`{afid}`	Código único de afiliação do produto.	`gmHk9k`
Pagamento teste	`{is_test}`	Indica se o pedido é um teste (`1`) ou real (`0`).	`1`
Data e hora	`{datetime_unix}{datetime_full}{datetime_utc}`	Data e hora da conversão em diferentes formatos.	`1570216877`
Texto aleatório	`{random}`	String aleatória usada para evitar cache.	`2nc91mx82`
E-mail	`{email}`	E-mail do cliente.	`cliente@mail.com`
Primeiro nome	`{first_name}`	Primeiro nome do cliente.	`José`
Último nome	`{last_name}`	Último nome do cliente.	`Souza`
Telefone	`{phone_number}`	Número de telefone do cliente.	`5511999119988`

Vídeo de exemplo com integração a Redtrack

Atualizado em: 22/07/2025

Este artigo foi útil?

Obrigado!