API-ul nostru ajută programatorii să realizeze integrările rapid și ușor.
Încarcarea codului Newsman Remarketing
<!-- Newsman Remarketing -->
<script type="text/javascript">
var _nzm = _nzm || [];
var _nzm_config = _nzm_config || [];
(function() {
if (!_nzm.track) {
var a, methods, i;
a = function(f) {
return function() {
_nzm.push([f].concat(Array.prototype.slice.call(arguments, 0)));
}
};
methods = ["identify", "track", "run"];
for(i = 0; i < methods.length; i++) {
_nzm[methods[i]] = a(methods[i])
};
s = document.getElementsByTagName("script")[0];
var script_dom = document.createElement("script");
script_dom.async = true;
script_dom.id = "nzm-tracker";
script_dom.setAttribute("data-site-id", "10200-1-000000000000000000000000-5b1fd5a903da5b81321b78e55507c78d");
script_dom.src = "https://retargeting.newsmanapp.com/js/retargeting/track.js";
s.parentNode.insertBefore(script_dom, s);
}
})();
</script>
<!-- End Newsman Remarketing -->
Înlocuiți “10200-1-000000000000000000000000-5b1fd5a903da5b81321b78e55507c78d” cu propriul ID din “Setari” > “Remarketing” din interfața de administrare Newsman.
Dezactivare tracking pentru un site:
_nzm_config['no_tracking'] = 1;
Dezactivare tracking pentru user/browser:
_nzm.setTracking(0);
Setează cookie de forma _nzm_tr_10100-54 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_93783-8273. 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.
- selector + pagina
_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'});
- doar selector (caută în toate paginile)
_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');
insert – adaugă modal în #show-here-id, înainte de conținut
append – adaugă modal în #show-here-id, dupa conținut
replace – adaugă modal în #show-here-id, înlocuind conținutul
insert_before – adaugă modal inainte de #show-here-id
insert_after – adaugă modal după #show-here-id
Se poate afișa un anume modal, după form_id:
_nzm.run('modal:show:1c2c635b96eeeb3e8ee4756vc6c889163f2', '#show-here-id', 'insert_before');
Event-uri
on:scroll
on:scroll.up
on:scroll.down
on:scroll.toTop
on:scroll.toBottom
on:scroll.to25
on:scroll.to50
on:scroll.to75
on:unload
on:seconds-passed
_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:
- Încarcarea modulului ecommerce
- Moneda
- Vizualizările produselor
- Vizualizările detaliilor produsului
- Adăugarea în coș
- Ștergerea din coș
- Achiziții
Încarcarea modulului ecommerce
_nzm.run( 'require', 'ec' );
Specificarea monedei locale
_nzm.run( 'set', 'currencyCode', 'RON );
Măsurarea vizualizarilor produselor
_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' );
Măsurarea vizualizărilor detaliilor produsului
_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' );
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:
https://developers.google.com/analytics/devguides/collection/protocol/v1/devguide
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters