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.
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.
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.
Na tela de nova integração, você deverá preencher corretamente o formulário com as informações solicitadas.
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).
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}.
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.
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.
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.
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.
Ele é composto principalmente por dois elementos: promolink e postback URL.
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.
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.
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.
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, 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
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} | 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 |
| {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 |
Atualizado em: 11/12/2024
Obrigado!