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.
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'] = [
{'url_containing': '/contul-meu', 'email_selector': '#ctl10_UserName'},
{'url_containing': '/cosul-meu/comanda-rapida', 'email_selector': '#ctl10_tbEmail'}
];
- doar selector (caută în toate paginile)
_nzm_config['autoidentify'] = [
{'email_selector': '#ctl10_UserName'},
{'email_selector': '#ctl10_tbEmail'}
];
Activare tracking pentru userii non identified
_nzm_config['enable_nonidentified'] = 1;
Activare bifă acord abonare newsletter în secţiunea register/checkout pentru un site
_nzm_config['subscribe_checkbox'] = [
{'url_containing': '/contul-meu', 'checkbox_selector': '#opt-in-newsletter'},
{'url_containing': '/cosul-meu/comanda-rapida', 'checkbox_selector': '#opt-in-newsletter-2'}
];
sau
_nzm_config['subscribe_checkbox'] = [
{'checkbox_selector': '#opt-in-newsletter'},
{'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