Integração do Kelkoo Sales Tracking usando PrestaShop
Informação para os comerciantes que utilizam PrestaShop ecommerce open source platform.
Atenção! antes de efetuar qualquer mudança, por favor lembre-se fazer um backup dos arquivos que vai alterar.
Confirme se no control panel, Advanced settings -> Performance, a opção “Ricompile files of template if updated”
é sinalizado.
1º Passo: Implementar o código
Vá para directory /controllers/front/ e abra o arquivo OrderConfirmationController.php.
Pesquisar a seguinte linha
public function initContent()
{
e adicionar este texto
/* Kelkoo Sales Tracking */
$order = new Order($this->id_order);
$products = $order->getProducts();
$productsKelkoo=array();
foreach ($products as $product) {
$productKelkoo=array('productname'=>$product['product_name'],
'productid'=>$product['product_reference'],
'svn1'=>$product['product_quantity'],
'svn2'=>$product['unit_price_tax_incl']);
array_push($productsKelkoo,$productKelkoo);
}
$this->context->smarty->assign(array(
'is_guest' => $this->context->customer->is_guest,
'HOOK_ORDER_CONFIRMATION' => $this->displayOrderConfirmation(),
'HOOK_PAYMENT_RETURN' => $this->displayPaymentReturn(),
'products_json' => json_encode($productsKelkoo),
'sales' => $order->getOrdersTotalPaid(),
'orderid' => $this->id_order
));
/* end Kelkoo Sales Tracking*/
Seguidamente, vá para o directory /themes/xxxx/ (onde xxxx é o nome do tema que escolheu, o padrão é “prestashop”), abra o arquivo order-confirmation.tpl e adicionar Kelkoo Sales Tracking, na parte inferior do arquivo:
<script type="text/javascript">
var _kkstrack = {
merchantInfo: [{ country:"COUNTRY", merchantId:"COM_ID" }],
orderValue: '{$sales}',
orderId: '{$orderid}',
basket: {$products_json}
};
(function() {
var s = document.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://s.kk-resources.com/ks.js';
var x = document.getElementsByTagName('script')[0];
x.parentNode.insertBefore(s, x);
})();
</script>
-
- Os valores em cor Verde são valores fixos ao longo do tag;
- COM_ID : Este é o ID exclusivo que representa a sua loja dentro do sistema Kelkoo. Note que pode entrar em sua Merchant Extranet account e utilizar directamente o JS tag generator que irá atualizar automaticamente o código com o seu [COMID]. Em seguida, só precisa copiar e colar o código gerado.
- COUNTRY (sv1) é o código do país com 2 letras para o país em que nossos produtos estão listados no Kelkoo: : ‘at’ para a Áustria, ‘be’ para a Bélgica, ‘br’ para o Brasil, ‘ch’ para a Suíça, ‘cz’ para a República Checa, ‘de’ para a Alemanha, ‘dk’ para a Dinamarca, ‘es’ para a Espanha, ‘fi’ para a Finlândia, ‘fr’para a França, ‘ie’ para a Irlanda, ‘it’ para a Itália, ‘nb’ para Bélgica flamenga, ‘nl’ para os Holanda, ‘no’ para a Noruega, ‘pl’ para a Polónia, ‘pt’ para Portugal, ‘ru’ ara a Rússia, ‘se’ para a Suécia, ‘uk’ para Reino Unido.
- Valores em Azul são os valores dinâmicos necessários que devem ser “apanhados” da sua solução de loja virtual e, em seguida, repassados na tag. Por favor, note que a programação básica é necessária para esta parte. Como fazê-lo depende da linguagem de programação o seu site é codificado e o nome das variáveis sua plataforma usa para armazenar essas informações. Entre em contato com o webmaster ou equipa técnica Se necessitar de ajuda.
- {$sales}: qualquer número real com um ponto, como um ponto decimal que representa o montante total da ordem
- {$orderid}: qualquer cadeia de identificação da ordem
- Os valores com azul claro são valores dinâmicos adicionais que recomendamos lhe passar ao longo da tag demais para conhecimentos mais detalhados.
- product_name: qualquer sequência
- product_reference: any string identifying the product code
- product_quantity: qualquer número inteiro positivo que representa o número de elementos para esse produto específico
- unit_price_tax_incl: qualquer número real com um ponto como um ponto decimal que representa o preço do produto único
Se feito corretamente, as informações serão passadas para os servidores Kelkoo e será gravado no seu painel de estatísticas.
Se utilize o módulo Paypal para pagamentos
Caso permita o pagamento Paypal, em seguida tem de modificar mais dois aquivos: submit.php e order-confirmation.tpl .
O primeiro aquivo submit.php está localizado em /modules/paypal/controllers/front/.
Pesquisar a seguinte linha dentro da classe PayPalSubmitModuleFrontController (pode encontra-la na linha 46)
$order = new Order($this->id_order);
adicionar este texto
/* Kelkoo Sales Tracking */
$order = new Order($this->id_order);
$products = $order->getProducts();
$productsKelkoo=array();
foreach ($products as $product) {
$productKelkoo=array('productname'=>$product['product_name'],
'productid'=>$product['product_reference'],
'svn1'=>$product['product_quantity'],
'svn2'=>$product['unit_price_tax_incl']);
array_push($productsKelkoo,$productKelkoo);
}
$this->context->smarty->assign(array(
'is_guest' => $this->context->customer->is_guest,
'HOOK_ORDER_CONFIRMATION' => $this->displayOrderConfirmation(),
'HOOK_PAYMENT_RETURN' => $this->displayPaymentReturn(),
'products_json' => json_encode($productsKelkoo),
'sales' => $order->getOrdersTotalPaid(),
'orderid' => $this->id_order
));
/* end Kelkoo Sales Tracking*/
O segundo arquivo order-confirmation.tpl pode ser encontrado em /modules/paypal/views/templates/front/.
Adicionar Kelkoo Sales Tracking na parte inferior do arquivo:
<script type="text/javascript">
var _kkstrack = {
merchantInfo: [{ country:"COUNTRY", merchantId:"COM_ID" }],
orderValue: '{$sales}',
orderId: '{$orderid}',
basket: {$products_json}
};
(function() {
var s = document.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://s.kk-resources.com/ks.js';
var x = document.getElementsByTagName('script')[0];
x.parentNode.insertBefore(s, x);
})();
</script>
-
- Os valores em cor Verde são valores fixos ao longo do tag;
- COM_ID : Este é o ID exclusivo que representa a sua loja dentro do sistema Kelkoo. Note que pode entrar em sua Merchant Extranet account e utilizar directamente o JS tag generator que irá atualizar automaticamente o código com o seu [COMID]. Em seguida, só precisa copiar e colar o código gerado.
- COUNTRY (sv1) é o código do país com 2 letras para o país em que nossos produtos estão listados no Kelkoo: : ‘at’ para a Áustria, ‘be’ para a Bélgica, ‘br’ para o Brasil, ‘ch’ para a Suíça, ‘cz’ para a República Checa, ‘de’ para a Alemanha, ‘dk’ para a Dinamarca, ‘es’ para a Espanha, ‘fi’ para a Finlândia, ‘fr’para a França, ‘ie’ para a Irlanda, ‘it’ para a Itália, ‘nb’ para Bélgica flamenga, ‘nl’ para os Holanda, ‘no’ para a Noruega, ‘pl’ para a Polónia, ‘pt’ para Portugal, ‘ru’ ara a Rússia, ‘se’ para a Suécia, ‘uk’ para Reino Unido.
- Valores em Azul são os valores dinâmicos necessários que devem ser “apanhados” da sua solução de loja virtual e, em seguida, repassados na tag. Por favor, note que a programação básica é necessária para esta parte. Como fazê-lo depende da linguagem de programação o seu site é codificado e o nome das variáveis sua plataforma usa para armazenar essas informações. Entre em contato com o webmaster ou equipa técnica Se necessitar de ajuda.
- {$sales}: qualquer número real com um ponto, como um ponto decimal que representa o montante total da ordem
- {$orderid}: qualquer cadeia de identificação da ordem
- Os valores com azul claro são valores dinâmicos adicionais que recomendamos lhe passar ao longo da tag demais para conhecimentos mais detalhados.
- product_name: qualquer sequência
- product_reference: any string identifying the product code
- product_quantity: qualquer número inteiro positivo que representa o número de elementos para esse produto específico
- unit_price_tax_incl: qualquer número real com um ponto como um ponto decimal que representa o preço do produto único
Se feito corretamente, as informações serão passadas para os servidores Kelkoo e será gravado no seu painel de estatísticas.
2º Passo: empty cache (prestashop version 1.6.x and oldest)
- go to admin page
- go to “advanced” -> “performances”
- click on “empty cache” in top/right
3º Passo: Teste de implementação
Para testar a implementação basta simular um pedido feito no seu site.
- Efetue login na sua conta da Kelkoo Merchant Extranet e clique no link “Ver sua página da loja Kelkoo” no canto superior direito da página inicial
- Clique num dos seus produtos para ser redirecionado para o seu site
- Faça um compra no seu site
- No dia seguinte, aceda novamente á sua conta da Kelkoo Merchant Extranet
- Verifique no menu “estatísticas” se a venda foi registada
- Verifique se todos os detalhes foram registados corretamente;
Importante! Verifique regularmente se as vendas estão sendo registradas. Isto é extremamente importante depois de fazer atualizações ou mudanças no seu site.
Se o teste não for devidamente registado na sua página de estatisticas, por favor anexe no e-mail o codigo fonte da página de confirmação do pedido ((“View”> “View Source”). KST code deve normalmente ser incluído.