Artigos sobre: Configurações

S2S Postback

O S2S (server-to-server) postback é um método de rastreamento que você pode usar tanto como produtor quanto como afiliado para notificar sua plataforma de marketing (por exemplo, Redtrack) sobre suas vendas/conversões. Esse sistema faz o envio da conversão diretamente do nosso servidor ao servidor da plataforma de marketing.


Ele é composto principalmente por dois elementos: promolink e postback URL.



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.


Primeiro Passo: criando a integração


Você deverá acessar a página de configuração de integrações S2S em Admin > Rastreamento e Script > S2S Tracking e clicar em Nova integração.


Se você é afiliado, você deverá configurar a integração S2S diretamente no produto em Produtos > Listar todos > Produtos que eu promovo, clicando sobre o produto que desejar para abrir suas configurações.



Segundo Passo: configuração


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


Informações básicas


  • 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.




Ativação e notificações


Por último, mas não menos importante, você deverá ativar a chave para garantir que a integração está ligada e funcional.


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


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



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



  1. 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.



  1. 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}

O ID usado pelo seu sistema de rastreamento para atribuir a compra a um clique específico.

e.g., 123456789

Chave da campanha

{campaignkey}

Em cada link promocional, você pode incluir uma chave de campanha para diferenciar as campanhas posteriormente.

e.g., Facebook Campaign

País

{country}

O país onde a compra foi realizada, com base no endereço IP do comprador.

e.g., Germany

Valor do afiliado

{amount_affiliate}

O valor que o afiliado ganha com a venda.

e.g., €15.03

Moeda

{currency}

A moeda na qual o produto foi comprado.

e.g., EUR

ID do produto

{product_id}

O ID do produto comprado.

e.g., 62686

Nome do produto

{product_name}

O nome do produto comprado.

e.g., Cápsula de cafeína

Tipo do pedido

{order_type}

Indica o papel do produto neste funil de vendas.

initial_sale, upsell

Posição do upsell

{upsell_no}

Indica a posição do produto no funil de vendas.

e.g., 3 (= terceiro upsell)

Slug da loja

{shop_slug}

O identificador da loja na Cartpanda.

e.g., sua-loja

Slug do afiliado

{affiliate_slug}

O identificador do afiliado na Cartpanda.

e.g., AnnasShop

Código do afiliado

{afid}

O código de afiliação ao produto para um afiliado.

e.g., gmHk9k

Pagamento teste

{is_test}

Indica se este pedido é um pagamento de teste.

e.g., 1 (= pagamento teste)

Data e hora

{datetime_unix}{datetime_full}{datetime_utc}

Data e hora, disponíveis em três formatos.

e.g., 1570216877

Texto aleatório

{random}

Uma string gerada aleatoriamente (para evitar potenciais problemas de cache).

e.g., 2nc91mx82 nv912kcx81be8c

E-mail

{email}

O e-mail do cliente que adquiriu o produto.

e.g., cliente@mail.com

Primeiro nome

{first_name}

O primeiro nome do cliente que adquiriu o produto.

e.g., José

Último nome

{last_name}

O último nome do cliente que adquiriu o produto.

e.g., Souza

Telefone

{phone_number}

O número de telefone do cliente que adquiriu o produto

e.g., 5511999119988

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


Atualizado em: 14/04/2025

Este artigo foi útil?

Compartilhe seu feedback

Cancelar

Obrigado!