1. Mitgo
  2. Admitad Advertisers
  3. Technical integration

Integração por meio de um código de rastreamento para Shopify

  • Atualizado

Os sites criados na plataforma Shopify podem ser integrados rapidamente ao sistema Admitad Partner Network usando um código de rastreamento.

Esse código é um código JavaScript que permite registrar ações e transferir dados correspondentes para a Admitad Partner Network. Ele deve ser colocado no seu site para ser integrado ao sistema Admitad.

Informações gerais: características e recomendações

  • Você pode iniciar a integração somente se o seu programa:
    • já tiver um link de rastreamento gerado na seção General Settings;
    • já tiver uma ação adicionada e a taxa correspondente configurada na seção Actions.

Se você não tiver um gestor, crie um link de rastreamento por conta própria (instruções) e adicione pelo menos uma ação e uma taxa (instruções).
Se você tiver um gestor pessoal, ele configurará tudo para você.

  • A integração é um passo obrigatório para continuar trabalhando. Sem ela, você não pode lançar um programa afiliado na Admitad.

  • Em caso de dificuldades durante o processo de integração, acione seu especialista técnico: mostre a ele as instruções e tire suas dúvidas.

Quando a integração for concluída, todos os dados de ações (data de ação, ID de pedido, seu valor, entre outros) serão enviados para a Admitad automaticamente.

Como instalar e configurar um código de rastreamento no site

1. Abra o site https://www.shopify.com/ e entre na sua conta. Você verá o painel de administração do seu site.

2. Vá para a seção Temas (Loja virtual → Temas).

shopify

3. No bloco Tema atual no tema do site, pressione os três pontos (seção Ações) (1) e selecione Editar código (2).

shopify

4. Na nova página, selecione o arquivo theme.liquid no painel esquerdo. Será exibido o arquivo com o código-fonte.

5. Copie o código abaixo e cole-o no código-fonte do seu site antes da tag de fechamento </head>.

  • <script src="https://www.artfut.com/static/tagtag.min.js?campaign_code={your_campaign_code}" onerror='var self = this;window.ADMITAD=window.ADMITAD||{},ADMITAD.Helpers=ADMITAD.Helpers||{},ADMITAD.Helpers.generateDomains=function(){for(var e=new Date,n=Math.floor(new Date(2020,e.getMonth(),e.getDate()).setUTCHours(0,0,0,0)/1e3),t=parseInt(1e12*(Math.sin(n)+1)).toString(30),i=["de"],o=[],a=0;a<i.length;++a)o.push({domain:t+"."+i[a],name:t});return o},ADMITAD.Helpers.findTodaysDomain=function(e){function n(){var o=new XMLHttpRequest,a=i[t].domain,D="https://"+a+"/";o.open("HEAD",D,!0),o.onload=function(){setTimeout(e,0,i[t])},o.onerror=function(){++t<i.length?setTimeout(n,0):setTimeout(e,0,void 0)},o.send()}var t=0,i=ADMITAD.Helpers.generateDomains();n()},window.ADMITAD=window.ADMITAD||{},ADMITAD.Helpers.findTodaysDomain(function(e){if(window.ADMITAD.dynamic=e,window.ADMITAD.dynamic){var n=function(){return function(){return self.src?self:""}}(),t=n(),i=(/campaign_code=([^&]+)/.exec(t.src)||[])[1]||"";t.parentNode.removeChild(t);var o=document.getElementsByTagName("head")[0],a=document.createElement("script");a.src="https://www."+window.ADMITAD.dynamic.domain+"/static/"+window.ADMITAD.dynamic.name.slice(1)+window.ADMITAD.dynamic.name.slice(0,1)+".min.js?campaign_code="+i,o.appendChild(a)}});'></script>

6. Substitua o valor {your_campaign_code} pelo valor do parâmetro campaign_code (sem chaves) e clique em Salvar.
Você obterá um parâmetro do seguinte modelo: campaign_code=a1b2c3d4e5, no qual a parte destacada é o número exclusivo do seu programa afiliado. Onde obter o valor do parâmetro campaign_code

7. Clique em Sair para voltar à página anterior e vá para a seção Configurações.

shopify

8. Na janela de configurações, clique em Checkout.

shopify

9. Role a página para baixo e encontre o bloco Página de status do pedido. No campo Scripts adicionais, insira o seguinte código:

  • <script src="https://www.artfut.com/static/tagtag.min.js?campaign_code={your_campaign_code}" onerror='var self = this;window.ADMITAD=window.ADMITAD||{},ADMITAD.Helpers=ADMITAD.Helpers||{},ADMITAD.Helpers.generateDomains=function(){for(var e=new Date,n=Math.floor(new Date(2020,e.getMonth(),e.getDate()).setUTCHours(0,0,0,0)/1e3),t=parseInt(1e12*(Math.sin(n)+1)).toString(30),i=["de"],o=[],a=0;a<i.length;++a)o.push({domain:t+"."+i[a],name:t});return o},ADMITAD.Helpers.findTodaysDomain=function(e){function n(){var o=new XMLHttpRequest,a=i[t].domain,D="https://"+a+"/";o.open("HEAD",D,!0),o.onload=function(){setTimeout(e,0,i[t])},o.onerror=function(){++t<i.length?setTimeout(n,0):setTimeout(e,0,void 0)},o.send()}var t=0,i=ADMITAD.Helpers.generateDomains();n()},window.ADMITAD=window.ADMITAD||{},ADMITAD.Helpers.findTodaysDomain(function(e){if(window.ADMITAD.dynamic=e,window.ADMITAD.dynamic){var n=function(){return function(){return self.src?self:""}}(),t=n(),i=(/campaign_code=([^&]+)/.exec(t.src)||[])[1]||"";t.parentNode.removeChild(t);var o=document.getElementsByTagName("head")[0],a=document.createElement("script");a.src="https://www."+window.ADMITAD.dynamic.domain+"/static/"+window.ADMITAD.dynamic.name.slice(1)+window.ADMITAD.dynamic.name.slice(0,1)+".min.js?campaign_code="+i,o.appendChild(a)}});'></script>
<script type="text/javascript">
   ADMITAD = window.ADMITAD || {};
   ADMITAD.Invoice = ADMITAD.Invoice || {};
    
   ADMITAD.Invoice.category = '{your_action_code}';  // código de ação (definido durante a integração)
   var orderedItem = [];  // matriz temporária para itens
   var coup = '';
   var targ = '';
   {% for discount_application in discount_applications %}
       coup = '{{ discount_application.title }}';
       targ = '{{ discount_application.target_type }}';
   {% endfor %}
   var disc = ( targ != 'shipping_line' && '{{ discounts_amount  | divided_by: 100.00 }}' > 0 ) ? Number({{ discounts_amount  | divided_by: 100.00 }}) : '0';
   disc = Number(disc + {{ gift_cards_amount  | divided_by: 100.00 }});
   var total = Number(({{ subtotal_price | divided_by: 100.00  }} - {{ gift_cards_amount  | divided_by: 100.00 }}) + disc); //preço do pedido sem desconto
   // se houver desconto, calculamos a porcentagem de desconto e obtemos o nome do cupom
   var average_price = (disc > 0) ? Number((total - disc) / total) : '1';
   {% for item in checkout.line_items %}
   var price = '{{ item.price | divided_by: 100.00 }}';
   // repita para cada item no carrinho
   orderedItem.push({
       Product: {
           productID: '{{ item.product_id }}',
           category: '{your_tariff_code}',
           price: (price*average_price).toFixed(3), // aplique um desconto no preço do produto
           priceCurrency: '{{ currency }}', // moeda
       },
       orderQuantity: '{{ item.quantity }}',
       additionalType: "sale" // payment_type
   });
   {% endfor %}
   ADMITAD.Invoice.referencesOrder = ADMITAD.Invoice.referencesOrder || [];
   // adicione itens em ordem
   ADMITAD.Invoice.referencesOrder.push({
         orderNumber: '{{ checkout.order_id }}',
       discountCode: coup, // código de promoção
       orderedItem: orderedItem
   });
   // Importante! Se os dados do pedido forem carregados via AJAX, remova o comentário dessa string.
   // ADMITAD.Tracking.processPositions();
   </script>

10. Substitua os valores {your_action_code}, {your_tariff_code} e {your_campaign_code} pelos valores dos parâmetros action_code, tariff_code e campaign_code respectivamente. Onde obter os valores desses parâmetros
Clique em Salvar na parte inferior da página.

Pronto, o código de rastreamento está instalado e configurado.

Como funciona a deduplicação no código de rastreamento na plataforma Shopify

A deduplicação é um método de processamento de dados que permite identificar corretamente uma fonte de tráfego paga para atribuir um pedido, bem como eliminar ações duplicadas, se houver.

O que é uma fonte de tráfego paga

  • Uma fonte de tráfego paga é qualquer recurso de terceiros ao qual você paga por atrair usuários ao seu site sob certas condições: por cada acesso ao site, visualização de anúncios, solicitação, cadastro ou compra.
    Por exemplo, publicidade direcionada e contextual, publicações pagas em canais de influenciadores, etc.

O código de deduplicação já está incorporado no código de rastreamento.
Portanto, os dados de ações são transferidos à Admitad de acordo com o modelo de atribuição Last Paid Click: se a última fonte paga for um afiliado da Admitad Partner Network, a ação é atribuída à Admitad.

Um cookie de deduplicação com o valor de uma fonte paga é gerado automaticamente no código de rastreamento que você implementa em todas as páginas do seu site.

Quando um usuário faz um pedido em seu site, o código de rastreamento identifica automaticamente a última fonte pelo valor do parâmetro utm_source.

O valor utm_source=admitad no último link em que o usuário clicou significa que a ação será atribuída à Admitad.

Para que a deduplicação funcione corretamente, cada fonte de tráfego paga deve ter o parâmetro utm_source com um valor exclusivo no link de redirecionamento.

Para configurar a deduplicação personalizada (por exemplo, definir seus próprios nomes de variáveis ​​ou alterar a data de expiração do cookie):

Insira o código de deduplicação em todas as páginas do site depois do código de rastreamento.

  • <script type="text/javascript">
// o nome do cookie para armazenar a fonte
// se outro nome for usado, especifique-o
var cookie_name = 'deduplication_cookie';
// duração de vida do cookie em dias
var days_to_store = 90;
// valor esperado de deduplication_cookie para a Admitad
var deduplication_cookie_value = 'admitad';
// nome do parâmetro GET para deduplicação
// se você usar outro parâmetro, especifique seu nome
var channel_name = ‘utm_source’;
// função para obter a fonte do parâmetro GET
getSourceParamFromUri = function () {
  var pattern = channel_name + '=([^&]+)';
  var re = new RegExp(pattern);
  return (re.exec(document.location.search) || [])[1] || '';
};
// função para obter a fonte do cookie com o nome cookie_name
getSourceCookie = function () {
  var matches = document.cookie.match(new RegExp(
    '(?:^|; )' + cookie_name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + '=([^;]*)'
  ));
  return matches ? decodeURIComponent(matches[1]) : undefined;
};
// função para gravar a fonte no cookie com o nome cookie_name
setSourceCookie = function () {
  var param = getSourceParamFromUri();
  if (!param) { return; }
  var period = days_to_store * 60 * 60 * 24 * 1000; // em segundos
  var expiresDate = new Date((period) + +new Date);
  var cookieString = cookie_name + '=' + param + '; path=/; expires=' + expiresDate.toGMTString();
  document.cookie = cookieString;
  document.cookie = cookieString + '; domain=.' + location.host;
};
// adição do cookie
setSourceCookie();
</script>

Para identificar corretamente a fonte de tráfego na Página de confirmação, insira o código apresentado abaixo logo após o código de rastreamento.

  • Esse código terá uma prioridade mais alta do que o código de deduplicação incorporado no código de rastreamento.

    <script>
if (!getSourceCookie(cookie_name)) {
  ADMITAD.Invoice.broker = 'na';
} else if (getSourceCookie(cookie_name) != deduplication_cookie_value) {
  ADMITAD.Invoice.broker = getSourceCookie(cookie_name);
} else {
  ADMITAD.Invoice.broker = 'adm';
}
</script>

 

Como testar a integração configurada

1. Obtenha um link de afiliado de teste na página Setting up integration for Shopify no bloco Integration testing.

  • 1.1 Na sua conta, vá para a seção Integration (Program → Integration).

    1.2 Em seguida, clique em Next e, na página Integration methods, selecione Shopify. Clique em Next.

    1.3 O bloco Integration testing está localizado na parte inferior da tela.

2. Siga o link e conclua a ação de acordo com os termos do seu programa.

Recomendações de teste de integração:

  • Faça alguns pedidos de teste para verificar todas as atividades e taxas.

  • Inclua vários itens em um de seus pedidos de teste para verificar se os itens e o valor total do pedido são exibidos corretamente.

  • Se você tiver um formulário de pedido rápido ou de compra com um clique, faça um pedido por meio dele para testar a integração do formulário.

O pedido de teste aparecerá nos relatórios do Admitad dentro de uma hora.

Se, após uma hora ou mais, o pedido não aparecer nos relatórios, verifique se a configuração da integração foi feita corretamente (instruções). Se o problema persistir, informe o especialista da Admitad.


3. Acesse sua conta da Admitad → Relatórios → Por ações e verifique se a ação e os dados referentes são exibidos corretamente nos relatórios:

  • a ação corresponde às configurações do programa afiliado;
  • o ID do pedido na Admitad corresponde ao ID do pedido no seu sistema;
  • o valor do pedido na Admitad corresponde ao valor do pedido de teste.

4. Notifique o especialista da Admitad Partner Network sobre o fim do teste para que o programa seja preparado para o lançamento.

Pronto. Teste de integração concluído.

 

Como remover o código de rastreamento do seu site

1. No painel de administração do seu site, abra o arquivo theme.liquid seguindo as etapas 1 a 3 destas instruções.

2. Remova o código Admitad adicionado antes da tag de fechamento </head>.
Clique em Salvar.

3. Clique em Sair para voltar à página anterior.

4. Na nova página, clique em Configurações. Você verá a guia de configurações.

5. Na janela de configurações, clique em Checkout.

6. Role a página para baixo e encontre o bloco Página de status do pedido. No campo Scripts adicionais, remova o código da Admitad. Clique em Salvar na parte inferior da página.


Pronto, o código de rastreamento foi removido.

Perguntas Frequentes

Onde encontrar o valor do parâmetro campaign_code?

1. Na sua conta, vá para a seção Integration (Program → Integration).

2. Em seguida, clique em Next e, na página Integration methods, mude para a guia Integration via plugin.

3. Na guia Integration via plugin, selecione Shopify e clique em Next.

4. O valor do parâmetro campaign_code é apresentado na tabela na parte superior da tela (no bloco Integration setup: unique parameter values for your program).

Voltar para instalação e configuração do código de rastreamento

Onde encontrar o valor do parâmetro action_code?

1. Na sua conta, vá para a seção Integration (Program → Integration).

2. Em seguida, clique em Next e, na página Integration methods, mude para a guia Integration via plugin.

3. Na guia Integration via plugin, selecione Shopify e clique em Next.

4. Na segunda tabela da página, na coluna Action, encontre aquela cujo código você precisa.
O valor do parâmetro action_code é apresentado na linha com esta ação na coluna Action code (bloco Integration setup: unique parameter values for your program).

Voltar para instalação e configuração do código de rastreamento

 

Onde encontrar o valor do parâmetro tariff_code?

1. Na sua conta, vá para a seção Integration (Program → Integration).

2. Em seguida, clique em Nextr e, na página Integration methods, mude para a guia Integration via plugin.

3. Na guia Integration via plugin, selecione Shopify e clique em Next.

4. Na segunda tabela da página, na coluna Rate, encontre aquela cujo código você precisa.
O valor do parâmetro tariff_code é apresentado na linha com esta taxa na coluna Rate code (bloco Integration setup: unique parameter values for your program).

Voltar para instalação e configuração do código de rastreamento

Esse artigo foi útil?