NewsMAN Documentație API
REST API Remarketing JS API OAuth API
en ro

Remarketing Javascript API pentru dezvoltatori

Încărcarea codului Newsman Remarketing

Copiază codul Javascript de mai jos pe fiecare pagină din site, înainte de tag-ul </body>.
Fiecare listă are un cod Remarketing diferit!

Codul de mai jos este unul general, cu valori de exemplu (cele evidențiate). Valorile listei tale le găsești în contul NewsMAN, la Setări > Remarketing.

cod general 
<script type="text/javascript">
    var _nzm = _nzm || [];
    var _nzm_config = _nzm_config || [];
    (function(w, d, e, f, c, l, n) {
        ["identify", "track", "run"].map(function(m) {
            w[f][m] = function() {
                w[f].push([m].concat([].slice.call(arguments)));
            };
        });
        l = d.createElement(e);
        l.async = 1;
        l.src = (w[c].js_prefix || "https://t.newsmanapp.com") + "/jt/t.js";
        l.setAttribute("data-site-id", "SITE_ID-LIST_ID-FORM_ID-CONTROL_HASH");
        n = d.getElementsByTagName(e)[0];
        n.parentNode.insertBefore(l, n);
    })(window, document, "script", "_nzm", "_nzm_config");
</script>

Folosești una din platformele ecommerce de mai jos? Instalează plugin-ul corespunzător și codul Javascript va fi inserat automat. În plus, ai gata implementate și acțiunile ecommerce, pe care le poți urmări și folosi în automatizări.

NewsMAN Remarketing ID-ul listei tale, împreună cu restul opțiunilor - dezactivare tracking, consent mode, conversii email, Javascript propriu - le găsești în interfața de administrare NewsMAN, la Setări > Remarketing.

Javascript API

Metodele de mai jos sunt disponibile în orice pagină care încarcă codul Remarketing de mai sus.

Dezactivare tracking pentru un site

_nzm_config['no_tracking'] = 1;

Dezactivare tracking pentru user/browser

_nzm.setTracking(0);

Setează cookie de forma _nzm_tr_10200-1 cu valoarea 0. Se poate apela în logica unui "cookie banner".

Activare tracking pentru user/browser

_nzm.setTracking(1);

Șterge cookie de forma _nzm_tr_10200-1. Se poate apela în logica unui "cookie banner".

Identificarea unui user/client

_nzm.identify( { email: 'ion@company.com', first_name: 'John', last_name: 'Doe' } );

sau

_nzm.identify( { email: 'ion@company.com'} );

Acest lucru are loc de obicei după ce un utilizator se loghează în aplicația dumneavoastra.

Pentru cazuri speciale, trebuie specificat câmpul email cu valoarea căruia să se facă autoidentify. Codul se pune în interfața de administrare Newsman, secțiunea "Setari" > "Remarketing". Se poate specifica doar selectorul sau selectorul și pagina pe care să facă search la selector.

_nzm_config['autoidentify'].push({'url_containing': '/contul-meu', 'email_selector': '#ctl10_UserName'});
_nzm_config['autoidentify'].push({'url_containing': '/cosul-meu/comanda-rapida', 'email_selector': '#ctl10_tbEmail'});
_nzm_config['autoidentify'].push({'email_selector': '#ctl10_UserName'});
_nzm_config['autoidentify'].push({'email_selector': '#ctl10_tbEmail'});

Activare tracking pentru userii non identified

_nzm_config['enable_nonidentified'] = 1;

Activare abonare newsletter în paginile register și checkout pentru un site, la bifare checkbox

_nzm_config['subscribe_checkbox'].push({'url_containing': '/contul-meu', 'checkbox_selector': '#opt-in-newsletter'});
_nzm_config['subscribe_checkbox'].push({'url_containing': '/cosul-meu/comanda-rapida', 'checkbox_selector': '#opt-in-newsletter-2'});

sau

_nzm_config['subscribe_checkbox'].push({'checkbox_selector': '#opt-in-newsletter'});
_nzm_config['subscribe_checkbox'].push({'checkbox_selector': '#opt-in-newsletter-2'});

Verificați dacă un user/client a fost identificat

_nzm.get_tracking_id();

Setarea unei variabile custom pentru un abonat Newsman

_nzm.run( 'user:setProp', { 'skill': 3000 } );

Tracking pentru un event custom, cu sau fără callback

function my_callback(param) {
    console.log("This is a callback");
}
_nzm.track('good_luck', { luck_level: 10 }, 'my_callback');
_nzm.track('good_luck', { luck_level: 10 });

Deschiderea / închiderea unui modal de abonare (dacă există unul)

_nzm.run('modal:show');
_nzm.run('modal:hide');

Modalul se poate afișa și embedded în DOM node on demand: <div class="show-here-class">modal</div>

_nzm.run('modal:show', '.show-here-class');

<div id="show-here-id">modal</div>

_nzm.run('modal:show', '#show-here-id');
_nzm.run('modal:show', '#show-here-id', 'insert');
_nzm.run('modal:show', '#show-here-id', 'append');
_nzm.run('modal:show', '#show-here-id', 'replace');
_nzm.run('modal:show', '#show-here-id', 'insert_before');
_nzm.run('modal:show', '#show-here-id', 'insert_after');

Se poate afișa un anume modal, după form_id:

_nzm.run('modal:show:1c2c635b96eeeb3e8ee4756vc6c889163f2', '#show-here-id', 'insert_before');

Event-uri

_nzm.run('on:scroll.to50', function () { console.log('Scrolled to mid page') } );
_nzm.run('on:seconds-passed', function () { console.log('It passed 5 seconds after page loaded') }, 5);

Metoda _nzm.run() folosind callback

_nzm.run( 'send', 'event', 'UX', 'click', 'add to cart', null, _nzm.createFunctionWithTimeout(function() {
    console.log('Produsul a fost pus in cos')
}));

Metoda trebuie folosită când imediat după tracking se face redirect (de exemplu: add to cart cu redirect spre cart). Dacă nu funcționează _nzm.run, callback-ul tot ruleaza (are timeout o secundă).

Debugging

_nzm.debug();

Modulul ecommerce

Modulul ecommerce este foarte asemanator cu Google's Enhanced Ecommerce. Astfel, cel mai rapid mod de a integra Newsman Remarketing pentru ecommerce cu aplicațiile dumneavoastra este să clonați integrarea Google Enhanced Ecommerce, dacă deja aveți una, modificați loading script și înlocuiți "ga(" cu "_nzm.run(" în cod.

Următoarele secțiuni vă vor arăta cum se pot implementa și măsura urmatoarele activități:

Încărcarea modulului ecommerce

_nzm.run( 'require', 'ec' );

Specificarea monedei locale

_nzm.run( 'set', 'currencyCode', 'RON' );

Marcarea vizualizării unei pagini de produs

_nzm.run( 'require', 'ec');
_nzm.run( 'set', 'currencyCode', 'USD' );
_nzm.run( 'ec:addProduct', {
	'id': 'S-003',
	'name': 'Elkton Jacket',
	'category': 'Longsleeves/Men\'s Clothing/Other/Pants/T-shirts',
	'price': '249',
} );
_nzm.run( 'ec:setAction', 'detail' );
_nzm.run( 'send', 'pageview' );

Marcarea vizualizării produselor dintr-o pagină de categorie

_nzm.run( 'require', 'ec' );
_nzm.run( 'set', 'currencyCode', 'EUR' );
_nzm.run( 'ec:addImpression', {
	'id': '266',
	'name': 'Spencer Cadet',
	'category': 'Climbing Equipment',
	'list': 'Product List',
	'position': '1'
} );
_nzm.run( 'ec:addImpression', {
	'id': '259',
	'name': 'E.C.O. Yoga Mat',
	'category': 'Climbing Equipment',
	'list': 'Product List',
	'position': '2'
} );
_nzm.run( 'send', 'pageview' );

Adăugarea unui produs în coș

_nzm.run( 'require', 'ec');
_nzm.run( 'set', 'currencyCode', 'RON' );
_nzm.run( 'ec:addProduct', {
	'id': '035pp',
	'name': 'Pantalonis Trouser',
	'price': '44.11',
	'brand': 'Pantalonis',
	'category': 'Trousers',
	'quantity': 1
} );
_nzm.run( 'ec:setAction', 'add' );
_nzm.run( 'send', 'event', 'UX', 'click', 'add to cart' );

Ștergerea unui produs din coș

_nzm.run( 'require', 'ec');
_nzm.run( 'set', 'currencyCode', 'RON' );
_nzm.run( 'ec:addProduct', {
	'id': '035pp',
	'quantity': '1',
} );
_nzm.run( 'ec:setAction', 'remove' );
_nzm.run( 'send', 'event', 'UX', 'click', 'remove from cart' );

Măsurarea achizițiilor

_nzm.run( 'require', 'ec');
_nzm.run( 'set', 'currencyCode', 'RON' );
_nzm.run( 'ec:addProduct', {
	'id': 'T-03',
	'name': 'Spencer Cadet',
	'category': 'Climbing Equipment',
	'price': '84.00',
	'quantity': '1'
} );
_nzm.run( 'ec:setAction', 'purchase', {
	'id': '758',
	'affiliation': 'RetroMod',
	'revenue': '84.00',
	'tax': '0',
	'shipping': '4.00'
} );
_nzm.run('send', 'pageview');

Merită citite și articolele de mai jos: