Observação
Requisito importante para configurar o retorno postback S2S
Como um Associado...
- Você precisa de uma parceria aprovada com o vendedor do produto.
- Você precisa de um link promocional ou de conteúdo para promover o produto.
Como um Vendedor...
- Você precisa de um produto aprovado.
- Você precisa de uma página de vendas com um botão de compra vinculando a um formulário de pedido Digistore24.
- Você precisa de um link promocional ou link de conteúdo para seu produto.
Aviso
Este procedimento só funciona com softwares de marketing que suportam URLs de retorno postback S2S! Se você não tiver certeza se seu software de marketing possui esse recurso, entre em contato com o suporte do seu sistema de marketing.
O retorno postback S2S é um método de rastreamento que você pode usar tanto como vendedor quanto como associado para notificar seu software de marketing (por exemplo, Klick-Tipp) sobre vendas e ganhos que você alcançar. Saiba mais sobre os fundamentos do processo de retorno postback S2S aqui.
Depois de atender aos critérios acima, prossiga da seguinte forma.
Passo 1: Insira o link promocional ou de conteúdo no sistema de marketing como Vendedor/Associado
- Certifique-se de ter um link promocional ou de conteúdo Digistore24. Isso também se aplica a você como vendedor.
- Crie um link publicitário em seu software de marketing. Para a URL de destino, insira seu link promocional ou de conteúdo Digistore24.
- Adicione um parâmetro GET ao seu link promocional ou de conteúdo Digistore24 para transmitir o Click-ID. O Digistore24 usa o nome do parâmetro cid para transmitir o Click-ID. Você pode encontrar mais espaços reservados aqui.
- Em seguida, adicione o espaço reservado Click-ID do seu sistema de marketing como um valor (veja o Exemplo 1).
Exemplo 1: Captura de tela do BeMob
Nota
Se você não conseguir encontrar uma opção para inserir um espaço reservado Click-ID em seu sistema de marketing, entre em contato com o suporte do software de marketing.
Seu link promocional ou de conteúdo deve se parecer com isso:
Link Promocional
https://www.checkout-ds24.com/redir/[PRODUCT-ID]/[AFFILIATE-ID]/[CAMPAIGNKEY]?cid=[CLICK-ID-PLACEHOLDER]
Exemplo: https://www.checkout-ds24.com/redir/123456/MaxMuster/FacebookCampaign?cid={click_id}
Link de Conteúdo
https://www.checkout-ds24.com/content/[PRODUCT-ID]/[CONTENTLINK-ID]/[AFFILIATE-ID]/[CAMPAIGNKEY]?cid=[CLICK-ID-PLACEHOLDER
Exemplo: https://www.checkout-ds24.com/content/123456/20581/MaxMuster/FacebookCampaign?cid={click_id}
Todo texto entre os colchetes deve ser substituído:
- [PRODUCT-ID]: ID do produto que você deseja promover
- [CONTENT LINK ID]: ID do seu link de conteúdo
- [YOUR AFFILIATE-ID]: seu ID Digistore24
- [CAMPAIGNKEY]: a chave de campanha que você deseja usar para rotular sua campanha – isso pode ser deixado vazio
- [CLICK-ID-PLACEHOLDER]: Seu sistema de marketing deve ter a opção de adicionar um espaço reservado ao URL que será automaticamente substituído pelo Click-ID.
Dica
Para usuários avançados: O Digistore24 também permite que você adicione até cinco Sub-IDs como parâmetros GET adicionais (sid1 a sid5).
Exemplo: https://www.checkout-ds24.com/redir/123456/MaxMuster/FacebookCampaign?cid={click_id}&sid1={value}&sid2={value}&sid3={value}&sid4={value}&sid5={value}
Aviso
Por favor, observe o limite de caracteres: Sua chave de campanha, Click-ID e Sub-IDs podem conter apenas letras maiúsculas e minúsculas (incluindo diacríticos), os dígitos 0–9 e os caracteres especiais ., _ e - (ponto, vírgula, sublinhado e hífen). , _ e - (ponto, vírgula, sublinhado e hífen). Seu Click-ID e Sub-IDs também não devem exceder um total de 1000 caracteres, e sua chave de campanha não pode ter mais de 127 caracteres.
Passo 2: Insira a URL de retorno no Digistore24
- Como um Vendedor, vá para Configurações – IPN.
Como um Associado, vá para Conta > S2S Postback. - Clique em Adicionar Nova Integração no canto superior esquerdo.
Como um Vendedor, role para baixo até a última seção e clique no ícone S2S Postback. - Insira um nome para a integração de retorno postback S2S. Isso é visível apenas para você.
- Como um Vendedor, escolha quais produtos você deseja ativar o retorno postback S2S.
Como um Associado, escolha quais parcerias de associado ativar o retorno postback S2S. - Escolha quais eventos de pedido desencadearão a transmissão de dados para seu software de marketing.
- Agora insira a URL de Retorno válida do seu sistema de marketing.
Aviso
Lembre-se de ajustar os nomes dos parâmetros para aqueles utilizados pelo seu software de marketing. Se você não tiver certeza de quais nomes de parâmetros seu sistema de marketing usa, entre em contato com sua equipe de suporte. - Em seguida, em vez de usar valores específicos, insira os espaços reservados apropriados fornecidos pelo Digistore24. Você pode encontrá-los aqui.
Exemplo: Usando os parâmetros "cid" e "pagamentos", sua URL de retorno pode parecer assim:https://domain.com/postback?cid={cid}&payout={amount_affiliate} - Escolha a moeda em que os valores devem ser transmitidos.
Dica
Se seu sistema de marketing coleta os dados de ganhos em dólares americanos, faz sentido configurar o Digistore24 para também passar seus ganhos para seu software de marketing em dólares americanos. - Certifique-se de que a integração esteja ativa.
- Opcional: Insira um endereço de email para ser notificado em caso de erros. Isso permite que você intervenha rapidamente se algo der errado com a conexão.
- Clique em Salvar.
Passo 3: Teste o Retorno Postback S2S
Após configurar o retorno postback S2S, siga estas etapas para testá-lo:
- Como um Vendedor, vá para Configurações – IPN.
Como um Associado, vá para Conta > S2S Postback. - Clique no ícone de editar ao lado da conexão de retorno postback S2S desejada.
- Role até o final do formulário.
- Clique em Testar Conexão.
Isso simulará uma compra e enviará os dados para seu software de marketing, testando a conexão.
Teste de Compra:
- Como um Associado, você não pode realizar uma compra de teste para os produtos que você promove. Entre em contato com o fornecedor do produto para agendar uma compra de teste.
- Como um Vendedor, você pode realizar compras de teste para seus produtos.
Você também pode visualizar os logs de chamadas:
- Como um Associado, encontre o log em Conta > S2S Postback na aba Log.
- Como um Vendedor, encontre o log em Relatórios – Integrações (IPN).
Lista de espaços reservados para a URL de retorno postback S2S
| Informação | Espaço Reservado | Descrição | Exemplo |
| Click-ID | {cid} | O ID usado pelo seu sistema de rastreamento para atribuir a compra a um clique específico. | por exemplo, 123456789 |
| Chave da Campanha | {campaignkey} | Em cada link promocional, você pode incluir uma chave de campanha para mais tarde distinguir entre as campanhas. | por exemplo, Campanha do Facebook |
| País | {country} | O país onde a compra foi realizada, com base no endereço IP do comprador. | por exemplo, Alemanha |
| Valor do Associado | {amount_affiliate} | O valor que você ganha com a venda referida. | por exemplo, €15,03 |
| Valor Bruto | {amount_brutto} | O valor bruto do produto comprado. | por exemplo, €99,99 |
| Valor Líquido | {amount_netto} | O valor líquido do produto comprado. | por exemplo, €84,03 |
| Moeda | {currency} | A moeda em que o produto foi comprado. | por exemplo, EUR |
| ID do produto | {product_id} | O ID do produto comprado. | por exemplo, 62686 |
| Nome do produto | {product_name} | O nome do produto comprado. | por exemplo, Como Ser Feliz Feito Fácil |
| ID da Transação | {transaction_id} | O ID da transação. | por exemplo, 286230 |
| Tipo de Transação | {transaction_type} | O tipo de transação resultante do pedido. | por exemplo, pagamento |
| ID do Fornecedor | {merchant_id} | O ID Digistore24 do fornecedor. | por exemplo, AnnasShop |
| Nome do Fornecedor | {merchant_name} | O nome completo do fornecedor (se visível para você). | por exemplo, Max Mustermann |
| Status do Pagamento | {billing_status} | O status de pagamento do comprador. | pagando, concluído, abortado |
| Tipo de Cobrança | {billing_type} | Como o comprador pagou pelo produto. | pagamento único, assinatura, parcelamento |
| Tipo de pedido | {order_type} | Indica o papel do produto neste funil de vendas. | venda inicial, upsell |
| Número do upsell | {upsell_no} | Indica a posição do produto no funil de vendas. | por exemplo, 3 (= terceiro upsell) |
| Teste de pagamento/Não teste de pagamento | {is_test} | Indica se este pedido é um teste de pagamento. | por exemplo, 1 (= teste de pagamento) |
| ID do afiliado | {affiliate_id} | Seu ID Digistore24. | por exemplo, max_affiliate |
| Nome do associado | {affiliate_name} | Seu nome completo. | por exemplo, Max Mustermann |
| Data e Hora | {datetime_unix}{datetime_full}{datetime_utc} | Data e hora, disponíveis em três formatos. | por exemplo, 1570216877 |
| String Aleatória | {random} | Uma string gerada aleatoriamente (para evitar problemas de cache, potencialmente). | por exemplo, 2nc91mx82 nv912kcx81be8c |