Shoper¶

Setup guides.

Przegląd¶

Instrukcja wprowadzenia rozwiązania Criteo na platformie Shoper.

[[disclaimer-nonplugin]]

Criteo Product Feed¶

Na platformie Shoper, feed produktów może być wygenerowany na panelu administracyjnym wykonując następujące kroki.

Zaloguj się do panelu administracyjnego Shoper.
Przejdź do opcji Assortment > Products (Asortyment > Produkty).
Kliknij Export (Eksportuj).
Kliknij opcję Create a CSV profile (utwórz profil CSV).
Uzupełnij profil tak, jak poniżej i kliknij Save (Zapisz).
Wybierz pola i nazwy jak poniżej, zachowaj zmiany.

Field (Pole)	Name in the file (Nazwa w pliku)
Product code (Kod produktu)	id
Barcode (Kod kreskowy)	gtin
Category (Kategoria)	categoryid1
Currency (Waluta)	currency
Name (Nazwa)	name
Description (Opis)	description
Price (Cena)	price
Wholesale price (Cena hurtowa)	retailprice
Availability (Dostępność)	availability
Photos (Zdjęcia)	bigimage
URL	producturl

Kliknij Export (Eksportuj).
Kliknij Export. Aby pobrać .CSV file kliknij opcję download file (pobierz plik).

Ustawienie Criteo OneTag¶

Zaloguj się do panelu administracyjnego Shoper.
Przejdź do opcji Configuration > Integrations > Own Integrations (Konfiguracja > Integracje > Integracje własne ).
Utwórz kopię zapasową skryptów w sekcji Page footer, before closing < / body> (Stopka strony, przed zamknięciem < / body>).
Kopiuj i wklej następujący Javascript kod do sekcji Page footer, before closing < / body> (Stopka strony, przed zamknięciem < / body>) i zachowaj zmiany.

{if context == "index" }

<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript" src="https://cdn.dcsaas.net/js/front-api-1.0.3.min.js"></script>
<script type="text/javascript">
frontAPI.getUser(function (userInfo) { 
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q = window.criteo_q || [];
window.criteo_q.push(  
        { event: "setAccount", account: {{accountid}} },
        { event: "setEmail", email: userInfo.email },
        { event: "setSiteType", type: deviceType },
        { event: "viewHome", "ecpplugin": "shoper"}
);
},{ lang: 'pl_PL' });
</script>
{/if}

{if context == "product_list" }

<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript" src="https://cdn.dcsaas.net/js/front-api-1.0.3.min.js"></script>
<script type="text/javascript">
frontAPI.getUser(function (userInfo) { 
var productIds = [];

{products}
    productIds.push("{products.product_id}");
{/products}

var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q = window.criteo_q || [];
window.criteo_q.push(
        { event: "setAccount", account: {{accountid}} },
        { event: "setEmail", email: userInfo.email },
        { event: "setSiteType", type: deviceType },
        { event: "viewList", item: productIds, "ecpplugin": "shoper"}
);
},{ lang: 'pl_PL' });
</script>
{/if}

{if context == "product_promo" }

<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript" src="https://cdn.dcsaas.net/js/front-api-1.0.3.min.js"></script>
<script type="text/javascript">
frontAPI.getUser(function (userInfo) { 
var productIds = [];

{products}
    productIds.push("{products.product_id}");
{/products}

var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q = window.criteo_q || [];
window.criteo_q.push(
        { event: "setAccount", account: {{accountid}} },
        { event: "setEmail", email: userInfo.email },
        { event: "setSiteType", type: deviceType },
        { event: "viewList", item: productIds, "ecpplugin": "shoper"}
);
},{ lang: 'pl_PL' });
</script>
{/if}

{if context == "product"}

<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript" src="https://cdn.dcsaas.net/js/front-api-1.0.3.min.js"></script>
<script type="text/javascript">
frontAPI.getUser(function (userInfo) { 
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q = window.criteo_q || [];
window.criteo_q.push(  
        { event: "setAccount", account: {{accountid}} },
        { event: "setEmail", email: userInfo.email },
        { event: "setSiteType", type: deviceType },
        { event: "viewItem", item: {product_id}, "ecpplugin": "shoper"}
);
},{ lang: 'pl_PL' });
</script>

{/if}


{if context == "basket" }
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript" src="https://cdn.dcsaas.net/js/front-api-1.0.3.min.js"></script>
<script type="text/javascript">
frontAPI.getUser(function (userInfo) { 
frontAPI.getBasketInfo(function (basket) {

var items = [];
var i;

for(i=0; i<basket.products.length; i++){
    var basketItem = new Object();
    basketItem.id = basket.products[i].product_id;
    basketItem.price = basket.products[i].price_float;
    basketItem.quantity = basket.products[i].quantity;
    items.push(basketItem);
}
var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q = window.criteo_q || [];
window.criteo_q.push(   
        { event: "setAccount", account: {{accountid}} },
        { event: "setEmail", email: userInfo.email },
        { event: "setSiteType", type: deviceType },
        { event: "viewBasket", item: items, "ecpplugin": "shoper"});

});
},{ lang: 'pl_PL' });
</script>
{/if}

{if context == "basket_done" }
<script type="text/javascript" src="//static.criteo.net/js/ld/ld.js" async="true"></script>
<script type="text/javascript" src="https://cdn.dcsaas.net/js/front-api-1.0.3.min.js"></script>
<script type="text/javascript">
frontAPI.getUser(function (userInfo) { 
var items = [];

{products}
    var transaction = new Object();
    transaction.id = {products.product_id};
    transaction.price = {products.float_price};
    transaction.quantity = {products.quantity};
    items.push(transaction);
{/products}

var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
window.criteo_q = window.criteo_q || [];
window.criteo_q.push(   
        { event: "setAccount", account: {{accountid}} },
        { event: "setEmail", email: userInfo.email },
        { event: "setSiteType", type: deviceType },
        { event: "trackTransaction", id: {order_id}, item: items, "ecpplugin": "shoper" }
);
},{ lang: 'pl_PL' });
</script>
{/if}

Verification¶

[[accurate]]

Field	Overview	Example	Syntax	Required
Email Address	Email address in plain text (if allowed by the law in your country), sha256 hashed email address or MD5 hashed email address.	79054025255fb1a26e4bc422aef54eb4...	- Plain text emails - Sha256 and md5 hashed emails	Required
Hash Method	The hashing method used for the email. - Doesn't need to be included for plain text emails - For sha265 hashed emails: "sha256" - For md5 hashed emails: "md5"	sha256	String	Required

Field

Overview

Example

Syntax

Required

Email Address

Email address in plain text (if allowed by the law in your country), sha256 hashed email address or MD5 hashed email address.

79054025255fb1a26e4bc422aef54eb4...

- Plain text emails
- Sha256 and md5 hashed emails

Required

Hash Method

The hashing method used for the email.
- Doesn't need to be included for plain text emails
- For sha265 hashed emails: "sha256"
- For md5 hashed emails: "md5"

sha256

String

Required

<script type="text/javascript"> window.criteo_q = window.criteo_q || []; var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d"; window.criteo_q.push( { event: "setAccount", account: YOUR_PARTNER_ID}, { event: "setEmail", email: "useremail@somedomain.com" }, { event: "setEmail", email: "", hash_method: "sha256" }, { event: "setEmail", email: "", hash_method: "md5" }, { event: "setSiteType", type: deviceType}, { event: "viewPage" } ); </script>

<script type="text/javascript"> window.criteo_q = window.criteo_q || []; var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d"; window.criteo_q.push( { event: "setAccount", account: YOUR_PARTNER_ID}, { event: "setEmail", email: "" }, { event: "setEmail", email: "79054025255fb1a26e4bc422aef54eb4...", hash_method: "sha256" }, { event: "setEmail", email: "3242asd342421...", hash_method: "md5" }, { event: "setSiteType", type: deviceType}, { event: "viewPage" } ); </script>

필드	개요	예시	구문	필수
Email Address	sha256 해시된 이메일 주소와 MD5 해시된 이메일 주소.	79054025255fb1a26e4bc422aef54eb4....	- sha256 및 md5 해시된 이메일	필수
Hash Method	이메일에 사용된 해싱 방법. - sha256 및 md5로 이메일을 해시화 할 것 - sha265 해시된 이메일의 경우: "sha256" - md5 해시된 이메일의 경우: "md5"	sha256, md5	문자열	필수

필드

개요

예시

구문

필수

Email Address

sha256 해시된 이메일 주소와 MD5 해시된 이메일 주소.

79054025255fb1a26e4bc422aef54eb4....

- sha256 및 md5 해시된 이메일

필수

Hash Method

이메일에 사용된 해싱 방법.
- sha256 및 md5로 이메일을 해시화 할 것
- sha265 해시된 이메일의 경우: "sha256"
- md5 해시된 이메일의 경우: "md5"

sha256, md5

문자열

필수

<script type="text/javascript"> window.criteo_q = window.criteo_q || []; var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d"; window.criteo_q.push( { event: "setAccount", account: YOUR_PARTNER_ID}, { event: "setEmail", email: "79054025255fb1a26e4bc422aef54eb4...", hash_method: "sha256" }, { event: "setEmail", email: "3242asd342421...", hash_method: "md5" }, { event: "setSiteType", type: deviceType}, { event: "viewPage" } ); </script>

Shoper¶

Przegląd¶

Criteo Product Feed¶

Ustawienie Criteo OneTag¶

Verification¶

Plain text example

Hashed Emails Example

해시된 이메일 예시