GTM - Criteo Datalayer - Container¶

Panduan untuk mengimplementasikan Criteo dengan Criteo dataLayer.

Ringkasan¶

Criteo dataLayer adalah variabel yang diimplementasikan melalu kode javascript yang mendorong semua informasi yang dibutuhkan. Kode ini perlu dideklarasikan di dalam source code semua halaman website anda. DataLayer Criteo harus diimplementasikan di dalam 5 jenis halaman yang tertera di bawah:

Homepage
Category / Listing
Product
Basket / Cart
Sales

Jika anda mendownload dan menggunakan plug-in, extension atau snippet kode yang disediakan oleh Criteo untuk membantu implementasi kode atau tags di website klien, klien memahami bahwa mereka bertanggung jawab sepenuhnya untuk melakukan review dan testing di website tersebut dan menyetujui bahwa Criteo tidak bertanggung jawab kepada klien atas error atau kesalahan dalam pelaksanaanya. Implementasi ini membutuhkan keterampilan sorang developer atau software engineer dari pihak klien. Kami harap anda dapat meluangkan waktu tim anda atao third-party tim anda untuk proses implementasi ini.

DataLayer¶

Homepage¶

Implementasikan kode datalayer berikut di halaman homepage anda. Contoh URL: {{homepageurl}}

Field	Rinkasan	Contoh	Syntax
event	Jenis halaman event	crto_homepage	Static string value
email	Plain-text or MD5 Hash	79054025255fb1a26e4bc422aef54eb4	String. Trimmed dan lowercase 32 karakter, encoded in UTF-8

Structure¶

Mohon ganti field yang dikelilingi oleh ## secara dinamis dengan informasi users. Contoh dapat dilihat di bawah

<!-- Criteo Homepage dataLayer -->
<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({  
            'event': 'crto_homepage',
            'crto': {               
                'email': '##Users Email##' //kalau email tidak diketahui, gantikan ini dengan empty string
            }
        });
</script>
<!-- END Criteo Homepage dataLayer -->

Example¶

<!-- Criteo Homepage dataLayer -->
<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({  
            'event': 'crto_homepage',
            'crto': {               
                'email': 'crtotest@test.com'
            }
        });
</script>
<!-- END Criteo Homepage dataLayer -->

Category / Listing¶

Implementasikan kode datalayer berikut di halaman listing, kategori dan hasil pencarian anda. Contoh URL: {{homepageurl}}/category?id=categoryid1

Field	Rinkasan	Contoh	Syntax
event	Jenis halaman event	crto_listingpage	Static string value
email	Plain-text or MD5 Hash	79054025255fb1a26e4bc422aef54eb4	String. Trimmed and lowercase 32 karakter, encoded in UTF-8
Product ID	Produk ID yang unik	ProductID_1	String

Structure¶

Mohon ganti field yang dikelilingi oleh ## secara dinamis dengan informasi users. Contoh dapat dilihat di bawah

<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({            
            'event': 'crto_listingpage',
            'crto': {               
                'email': '##Users Email##', //can be empty string if email not known
                'products': ["##Product ID 1##", "##Product ID 2##", "##Product ID 3##"]
            }
        });
</script>
<!-- END Criteo Category / Listing dataLayer -->

Example¶

<!-- Criteo Category / Listing dataLayer -->
<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({                      
            'event': 'crto_listingpage',
            'crto': {               
                'email': 'crtotest@test.com',
                'products': ["ProductID_1", "ProductID_2", "ProductID_3"]
            }
        });
</script>
<!-- END Criteo Category / Listing dataLayer -->

Product¶

Implementasikan kode datalayer berikut di halaman rincian produk anda. Contoh URL:{{homepageurl}}/product?id=productid_1

Field	Rinkasan	Contoh	Syntax
event	Jenis halaman event	crto_productpage	Static string value
email	Plain-text or MD5 Hash	79054025255fb1a26e4bc422aef54eb4	String. Trimmed and lowercase 32 karakter, encoded in UTF-8
Product ID	Produk ID yang unik	ProductID_1	String

Structure¶

Mohon ganti field yang dikelilingi oleh ## secara dinamis dengan informasi users. Contoh dapat dilihat di bawah

<!-- Criteo Product dataLayer -->
<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({                        
            'event': 'crto_productpage',
            'crto': {               
                'email': '##Users Email##', //can be empty string if email not known
                'products': ["##Product ID 1##"]
            }
        });
</script>
<!-- END Criteo Product dataLayer -->

Example¶

<!-- Criteo Product dataLayer -->
<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({            
            'event': 'crto_productpage',
            'crto': {               
                'email': 'crtotest@test.com',
                'products': ['ProductID_1']
            }
        });
</script>
<!-- END Criteo Product dataLayer -->

Basket/Cart¶

Implementasikan kode datalayer berikut di halaman keranjang anda. Contoh URL:{{homepageurl}}/cart

Field	Rinkasan	Contoh	Syntax
event	Jenis halaman event	crto_basketpage	Static string value
email	Plain-text or MD5 Hash	79054025255fb1a26e4bc422aef54eb4	String. Trimmed and lowercase 32 character, encoded in UTF-8
Product ID	Produk ID yang unik	ProductID_1	String
price	Harga produk per unit	200.99	String or Integer, tidak termasuk simbol mata uang
quantity	Jumlah unit yang ditambahkan di keranjang	2	Integer

Structure¶

Mohon ganti field yang dikelilingi oleh ## secara dinamis dengan informasi users. Contoh dapat dilihat di bawah

<!-- Criteo Basket/Cart dataLayer -->
<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({
            'event': 'crto_basketpage',
            'crto': {               
                'email': '##Users Email##',  //can be empty string if email not known                         
                'products': [{
                    id: '##Product ID 1##',
                    price: '##Product Unit Price##',              
                    quantity: '##Number of Units##'
                }] //add new object for each product added to cart.
            }
        });
</script>
<!-- END Criteo Basket/Cart dataLayer -->

Example¶

<!-- Criteo Basket/Cart dataLayer -->
<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({
            'event': 'crto_basketpage',            
            'crto': {               
                'email': 'crtotest@test.com',                           
                'products': [{
                    id: 'ProductID_1',
                    price: '200.99',              
                    quantity: '2'
                },
                {
                    id:'ProductID_2',
                    price: '50.00',                                       
                    quantity: '1'
                }]
            }
        });
</script>
<!-- END Criteo Basket/Cart dataLayer -->

Sales¶

Implementasikan kode datalayer berikut di halaman konfirmasi penjualan atau terima kasih anda. Contoh URL:{{homepageurl}}/thankyou

Field	Rinkasan	Contoh	Syntax
event	Jenis halaman event	crto_transactionpage	Static string value
email	Plain-text or MD5 Hash	79054025255fb1a26e4bc422aef54eb4	String. Trimmed and lowercase 32 character, encoded in UTF-8
Product ID	Produk ID yang unik	ProductID_1	String
price	Harga produk per unit	200.99	String or Integer, tidak termasuk simbol mata uang
quantity	Jumlah unit yang ditambahkan di keranjang	2	Integer
transactionid	Confirmation atau Order #	7654322	Integer. Id unik

Structure¶

Mohon ganti field yang dikelilingi oleh ## secara dinamis dengan informasi users. Contoh dapat dilihat di bawah

<!-- Criteo Sales dataLayer -->
<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({
            'event': 'crto_transactionpage',
            'crto': {               
                'email': '##Users Email##',  //can be empty string if email not known   
                'transactionid':'##Order Number##',                                       
                'products': [{
                    id: '##Product ID 1##',
                    price: '##Product Unit Price##',              
                    quantity: '##Number of Units##'
                }] //add new object for each product added to cart.
            }
        });
</script>
<!-- END Criteo Sales dataLayer -->

Example¶

<!-- Criteo Sales dataLayer -->
<script type="text/javascript">
        var dataLayer = dataLayer || [];
        dataLayer.push({
            'event': 'crto_transactionpage',            
            'crto': {               
                'email': 'crtotest@test.com',   
                'transactionid':'ORD00001',                                        
                'products': [{
                    id: 'ProductID_1',
                    price: '200.99',              
                    quantity: '2'
                },
                {
                    id:'ProductID_2',
                    price: '50.00',                                       
                    quantity: '1'
                }]
            }
        });
</script>
<!-- END Criteo Sales dataLayer -->

Download¶

Klik disini untuk mendownload GTM Container

Import Container¶

Akses GTM platform > ADMIN > Import Container
Pilih file container
Pilih Merge > Rename conflicting tags, triggers and variables. Klik Confirm.

Verifikasi¶

Jika anda mempunyai akses ke Criteo Integrate Platform, mohon login dan tes melalui Tags Validation Dashboard
Anda juga dapat mendowload Criteo Accurate chrome extension untuk melakukan tes kepada tags
Mohon dicatat bahwa kami menggunakan harga per unit untuk produk anda di Criteo OneTag. Kami mengalikan harga satuan dengan jumlah produk untuk menghitung harga total yang ditampilkan di report kami. Jika anda mengajukan kode berupa shipping, pajak, voucher, diskon atau promo code apa pun maka klien bertanggung jawab untuk melakukan verifikasi bahwa kode tersebut dapat dan sudah diterapkan kepada harga total dengan benar.

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>

GTM - Criteo Datalayer - Container¶

Ringkasan¶

DataLayer¶

Homepage¶

Structure¶

Example¶

Category / Listing¶

Structure¶

Example¶

Product¶

Structure¶

Example¶

Basket/Cart¶

Structure¶

Example¶

Sales¶

Structure¶

Example¶

Download¶

Import Container¶

Verifikasi¶

Plain text example

Hashed Emails Example

해시된 이메일 예시