Sunteți pe pagina 1din 5

Cum se implementează Biano Pixel

Instalare manuala - adaugare cod de pixel la site-ul web


1. Găsiți antetul site-ului web

Găsiți antetul în codul sursa a site-ului Dvs <head>...</head>

2. Copiați următoarul segment de pixel cod și inserati-l în antetul-ul site-ului

Lipește codul de bază în partea de jos a secțiunei antetului, chiar înainte de eticheta de antet de
închidere </head> .

<!-- Biano Pixel Code -->


<script>
// describe configuration options
const bianoPixelConfig = {
consent: true, // required boolean
debug: true, // optional boolean - default false
};

!function(b,i,a,n,o,p,x,s){
if(b.bianoTrack)return;o=b.bianoTrack=function(){o.callMethod?
o.callMethod.apply(o,arguments):o.queue.push(arguments)};o.push=o;o.queue=[];
a=a||{};n=a.consent===void(0)?!0:!!a.consent;o.push('consent',n);
s='script';p=i.createElement(s);p.async=!0;
p.src='https://'+(n?'pixel.biano.biano.ro':'bianopixel.com')+
'/'+(a.debug?'debug':'min')+'/pixel.js';
x=i.getElementsByTagName(s)[0];x.parentNode.insertBefore(p,x);
}(window,document,bianoPixelConfig);

// initialize Biano Pixel with your Merchant ID


bianoTrack('init', '<put-your-merchant-id-here>');

// optionally enable Biano Button


// bianoTrack('init-button');
</script>
<!-- End Biano Pixel Code -->

Notă importantă privind regimul de consimțământ valabil din 1.1.2022.

Există două opțiuni de a seta modul de consimțământ. Prima și cea mai preferată opțiune este să inițializați
scriptul(code snippet) prin bianoPixelConfig object.

A doua opțiune cum să schimbați setarea consimțământului este să utilizați funcția bianoTrack('consent',
true/false); după inițializarea scriptului. Această funcție poate fi utilizată și pentru a modifica modul de
consimțământ în timpul rulării aplicației Este posibil să aveți nevoie de acest lucru numai dacă site-ul dvs. este
JS bazat pe Single Page Application (SPA) sau dacă apelează cereri AJAX, de exemplu atunci când se adăugă
articole în coș. Puteți citi mai multe despre comportamentul modului de consimtamant mai jos în document.

*3. Inserați Merchant ID-ul în script**

Înlocuiți string-ul <put-your-merchant-id-here> în fragmentul de script cu Merchant ID-ul, pe care vi-l oferim
la cerere pe adresa info@biano.biano.ro.
4. Configurare Content Security Policy (CSP) HTTP header

Dacă site-ul dvs. folosește Content Security Policy,trebuie să activați Biano Pixel JavaScript pe site-ul Dvs.
Adăugați următoarele reguli CSP la HTTP response header-ul site-ului Dvs:

Content-Security-Policy: default-src 'self'; script-src 'unsafe-inline'


https://pixel.biano.biano.ro https://ro.bianopixel.com; connect-src 'self'
https://p.biano.biano.ro https://ro.bianopixel.com

A fost deja implementată migrarea pixelului în modul de consimțământ


Dacă aveți deja implementat Biano Pixel, ar trebui să actualizați scriptul de inițializare la versiunea curentă
pentru a vă conforma consimțământului pentru procesarea cookie-urilor. Migrarea se poate face în 2 pași foarte
simpli.

1. Înlocuiți fragmentul actual <!-- Biano Pixel Code --> de pe site-ul Dvs. cu cel nou pe care îl găsiți
mai sus în secțiunea Instalare manuala - adaugare cod de pixel la site-ul web.

2. Furnizați valoarea consimțământului utilizatorului obiectului bianoPixelConfig cu care Biano Pixel


poate funcționa corect

Implementare și debugging
În timpul implementării, utilizați versiunea debug a scriptului Biano Pixel, acest lucru vă ajută la implementarea
cu succes.Pentru a ofolosi, setați proprietatea debug: true în obiectul bianoPixelConfig . Când utilizați
versiunea debug , veți găsi erori de validare a datelor de intrare în Browser Developer Console .
Implementare cu succes este realizată atunci, când în niciunul dintre evenimentele declanșate nu apare nicio
eroare. După implementarea cu succes, dezactivați modul debug pentru a utiliza codul sursă minimizat,
adecvat pentru producție.
Tracking events
Noi acceptăm patru evenimente - Page View , Product View , Add to Cart și Purchase . Pentru a
declanșa eventul, apelați la bianoTrack('track', <event-name>, <data-object>) javascript function cu
argumentele necesare. Primul argument este întotdeauna 'track' și al doilea event este name. Ultimul
argument este un obiect de date simplu și este cerut doar de unele evenimente. La încărcarea paginii ar trebui
să declanșați un singur bianoTrack('track', ...); event indicând tipul paginii (product_view, purchase, ...
sau page_view pentru orice altceva). Dacă procesul de comanda este mai interactiv (de exemplu, adăugarea
articolelor în coșul de cumpărături via AJAX calls),puteți declanșa evenimente suplimentare după necesitate.

1. Page View
Utilizați acest evenimentatunci când un utilizator vizitează site-ul dvs. și nu există un alt eveniment mai
potrivit.

<script>bianoTrack('track', 'page_view');</script>

2. Product View
Utilizați cest eveniment atunci când un utilizator vizualizează detaliile despre produs pe site-ul dvs. web.

Evenimentul necesită un obiect ca al treilea argument cu o singură proprietate id a cărui valoare este Product
ID. Trebuie să utilizați aceleași ID-uri care sunt utilizate în feed-ul de produse!

Product:

Property Description Data Type Example

id Product ID string PRODUCT-1234

<script>
bianoTrack('track', 'product_view', {id: 'PRODUCT-1234'});
</script>

3. Add to Cart
Utilizați acest evenimet atunci când un utilizator adaugă un produs în coșul de cumpărături.

Product in Cart:

Property Description Data Type Example

id Product ID string PRODUCT-1234

quantity Quantity integer 10

unit_price Unit Price float 123.45

currency Currency string RO

<script>
bianoTrack('track', 'add_to_cart', {
id: 'PRODUCT-1234',
quantity: 10,
unit_price: 123.45,
currency: 'RO',
});
</script>
4. Purchase
Utilizați acest eveniment după ce utilizatorul a efectuat cu succes o comandă.

Order:

Property Description Data Type Example

id Order ID string ORDER-9876

order_price Total Order Price float 327.12

currency Currency string RO

items Array of Order Items array<item>

Order Item:

Property Description Data Type Example

id Product ID string PRODUCT-1234

quantity Quantity integer 1

unit_price Unit Price float 123.45

<script>
bianoTrack('track', 'purchase', {
id: 'ORDER-9876',
order_price: 327.12,
currency: 'CZK',
items: [
{id: 'PRODUCT-1234', quantity: 1, unit_price: 123.45},
{id: 'PRODUCT-5789', quantity: 3, unit_price: 67.89},
]});
</script>

Comportamentul modului de consimtamant


Modul de consimțământ vă permite să ajustați modul în care se comportă evenimentele Biano Pixel în funcție de
starea consimțământului utilizatorilor. Puteți indica dacă a fost acordat consimțământul pentru Biano Pixel și
funcțiile sale.

Odată implementat Modul de Consimțământ va ajusta comportamentul tuturor evenimentelor urmărite. Vedeți
diferențele mai jos:

consinţământ: adevărat consințământ: fals

SDK este încărcat din


SDK este încărcat din cookie-less https://bianopixel.com
https://pixel.biano.biano.ro

Sunt create cookie-uri de la 1a și 3a parte Cookie-urile de la 1a și 3a parte nu sunt create

Evenimentele Pixel sunt trimise către Evenimentele Pixel sunt trimise către cookie-less
https://p.biano.biano.ro https://ro.bianopixel.com

Adresele IP sunt folosite pentru a determina country IP și


Adresele IP sunt colectate
apoi sunt anonimizate

Sunt colectați identificatorii cookie-urilor Cookie-urile nu sunt transferate deloc

Se colectează URL-ul complet al paginii web Se colectează URL-ul complet al paginii web

S-ar putea să vă placă și