ZenDesk - Revision history

Aaron.trevellick: /* Tracking In Tag Manager */

2025-01-23T10:00:08Z

Tracking In Tag Manager

← Older revision		Revision as of 11:00, 23 January 2025
Line 15:		Line 15:
	dataLayer.push({'event' : 'zendesk-' + eventName});		dataLayer.push({'event' : 'zendesk-' + eventName});
	}		}


	zE('webWidget:on', 'chat:connected', function(){ zendeskDataLayerEvent('connected'); });		zE('webWidget:on', 'chat:connected', function(){ zendeskDataLayerEvent('connected'); });
Line 23:		Line 22:
	zE('webWidget:on', 'chat:unreadMessages', function(number){ zendeskDataLayerEvent('unread-msg'); });		zE('webWidget:on', 'chat:unreadMessages', function(number){ zendeskDataLayerEvent('unread-msg'); });
	zE('webWidget:on', 'chat:end', function(){ zendeskDataLayerEvent('chat-ended'); });		zE('webWidget:on', 'chat:end', function(){ zendeskDataLayerEvent('chat-ended'); });

	</script>		</script>
	</pre>		</pre>

Aaron.trevellick: /* Legacy */

2019-07-19T16:06:23Z

Legacy

← Older revision		Revision as of 17:06, 19 July 2019
Line 55:		Line 55:
	var dataLayer = window.dataLayer \|\| [];		var dataLayer = window.dataLayer \|\| [];
	dataLayer.push({'event' : 'zendesk-' + eventName});		dataLayer.push({'event' : 'zendesk-' + eventName});
			console.log( 'Datalayer: zendesk-' + eventName );
	}		}

			var waitForZopim = setInterval(function () {

	zE(~~'webWidget:on', 'chat:connected',~~ function(){ zendeskDataLayerEvent('connected'); });		if (window.$zopim === undefined \|\| window.$zopim.livechat === undefined) {
	zE(~~'webWidget:on', 'open',~~ function(){ zendeskDataLayerEvent('on-show'); });		return;
	zE(~~'webWidget:on', 'close',~~ function(){ zendeskDataLayerEvent('on-hide'); });		}
	zE(~~'webWidget:on', 'chat:start',~~ function(){ zendeskDataLayerEvent('chat-started'); });
	zE(~~'webWidget:on', 'chat:unreadMessages',~~ function(~~number~~){ zendeskDataLayerEvent('unread-msg'); });		$zopim(function() {
	zE(~~'webWidget:on', 'chat:end',~~ function(){ zendeskDataLayerEvent('chat-ended'); });		$zopim.livechat.setOnConnected( function() {
			zendeskDataLayerEvent('connected');
			});
			$zopim.livechat.window.onShow( function() {
			zendeskDataLayerEvent('on-show');
			});
			$zopim.livechat.window.onHide( function() {
			zendeskDataLayerEvent('on-hide');
			});
			$zopim.livechat.setOnChatStart( function() {
			zendeskDataLayerEvent('chat-started');
			});
			$zopim.livechat.setOnUnreadMsgs( function() {
			zendeskDataLayerEvent('unread-msg');
			});
			$zopim.livechat.setOnChatEnd( function() {
			zendeskDataLayerEvent('chat-ended');
			});
			});

			clearInterval( waitForZopim );

			}, 100);

	</script>		</script>

Aaron.trevellick: Created page with "== Tracking In Tag Manager == ZenDesk has an API for tracking. https://developer.zendesk.com/embeddables/docs/widget/chat To use this, create a custom HTML tag In tag manag..."

2019-07-19T16:05:58Z

Created page with "== Tracking In Tag Manager == ZenDesk has an API for tracking. https://developer.zendesk.com/embeddables/docs/widget/chat To use this, create a custom HTML tag In tag manag..."

New page

== Tracking In Tag Manager ==

ZenDesk has an API for tracking.

https://developer.zendesk.com/embeddables/docs/widget/chat

To use this, create a custom HTML tag In tag manager and trigger it on any pages the ZenDesk chat runs on.

Add this script to the custom HTML:

<pre>
<script>
function zendeskDataLayerEvent( eventName ) {
var dataLayer = window.dataLayer || [];
dataLayer.push({'event' : 'zendesk-' + eventName});
}

zE('webWidget:on', 'chat:connected', function(){ zendeskDataLayerEvent('connected'); });
zE('webWidget:on', 'open', function(){ zendeskDataLayerEvent('on-show'); });
zE('webWidget:on', 'close', function(){ zendeskDataLayerEvent('on-hide'); });
zE('webWidget:on', 'chat:start', function(){ zendeskDataLayerEvent('chat-started'); });
zE('webWidget:on', 'chat:unreadMessages', function(number){ zendeskDataLayerEvent('unread-msg'); });
zE('webWidget:on', 'chat:end', function(){ zendeskDataLayerEvent('chat-ended'); });

</script>
</pre>

This sets up the events in the datalayer to be used in triggers:

<pre>
zendesk-connected
zendesk-on-show
zendesk-on-hide
zendesk-chat-started
zendesk-unread-msg
zendesk-chat-ended
</pre>

*note there is no way to track offline form submits (when no one is there to chat)

=== Legacy ===

Legacy ZenDesk has an API for tracking.

https://api.zopim.com/files/meshim/widget/controllers/LiveChatAPI-js.html

To use this, create a custom HTML tag In tag manager and trigger it on any pages the ZenDesk chat runs on.

Add this script to the custom HTML:

<pre>
<script>
function zendeskDataLayerEvent( eventName ) {
var dataLayer = window.dataLayer || [];
dataLayer.push({'event' : 'zendesk-' + eventName});
}

zE('webWidget:on', 'chat:connected', function(){ zendeskDataLayerEvent('connected'); });
zE('webWidget:on', 'open', function(){ zendeskDataLayerEvent('on-show'); });
zE('webWidget:on', 'close', function(){ zendeskDataLayerEvent('on-hide'); });
zE('webWidget:on', 'chat:start', function(){ zendeskDataLayerEvent('chat-started'); });
zE('webWidget:on', 'chat:unreadMessages', function(number){ zendeskDataLayerEvent('unread-msg'); });
zE('webWidget:on', 'chat:end', function(){ zendeskDataLayerEvent('chat-ended'); });

</script>
</pre>

This sets up the events in the datalayer to be used in triggers:

<pre>
zendesk-connected
zendesk-on-show
zendesk-on-hide
zendesk-chat-started
zendesk-unread-msg
zendesk-chat-ended
</pre>

*note there is no way to track offline form submits (when no one is there to chat)