Documentation | dataslayer | Tag management and analytics ...

dataslayer does not listen to any of your data for a page until you have opened the dataslayer developer tools panel, and never processes your data anywhere ...   dataslayer Download Documentation GitHub Support Contact InstallationRequiredpermissionsAccessingdataslayerUsingdataslayerOverviewDatalayers&tagmanagementsystemsThree-columnviewTagsActionbardataslayersettingsGeneralTagsIgnoredIDsAdditionaldatalayerobjectsReleasenotes Installationdataslayerisavailablefrom: ChromeWebStore:https://chrome.google.com/webstore/detail/dataslayer/ikbablmmjldhamhcldjjigniffkkjgpo FirefoxAdd-ons:https://addons.mozilla.org/en-US/firefox/addon/dataslayer-firefox/ Requiredpermissionsdataslayerrequirestwotypesofpermissions: Readandchangeallyourdataonthewebsitesyouvisit:dataslayerneedsthislevelofpermissionbecausetagdetectionisdonebylisteningtothenetworkforpixelsbeingfired,whiledatalayerdetectionisdonebyinjectingcodeintothedebuggedpage.dataslayerdoesnotlistentoanyofyourdataforapageuntilyouhaveopenedthedataslayerdevelopertoolspanel,andneverprocessesyourdataanywhereotherthanonyourcomputer. Displaynotifications:thisisusedonlytodisplayanotificationoninitialinstallationandonfutureupgrades. AccessingdataslayerOnceyou’veinstalleddataslayer,youcanaccessitviayourDeveloperTools(Ctrl+Shift+IonLinux/Windows,Command+Option+IonMac).Ifinstallationwassuccessful,you’llseeanewtabtitled‘dataslayer’.Clickintothistabtobeginyoursession.Ifyouneedtodebugthesiteyou’realreadyon,youmayneedtorefreshthepageafteropeningdataslayertoensureyoucapturealldata. Usingdataslayer OverviewEachURLvisitedwhiledataslayerisactivewilldisplayasagroupwithindataslayer.Theseappearinreverse-chronologicalorder(newestattop).ClicktheURLtocollapseorexpandthegroup;groupsautomaticallycollapsewhenyounavigatetoanewpage. Ifatagmanagementsystemisfound,theappropriatelogoappearsnexttotheURL;ifnosupportedtagmanagementsystemisfound,aredXappearsinstead. DatalayersandtagsforeachpagelivewithinthegroupdesignatedbythepageURL-datalayersontheleft,tagsontheright.Notethatverticalalignmentofadatalayerentryandatagdoesnotindicatethatthetagwasfiredbythedatalayerentry.It’ssimplyseparatecolumnsofdata. Datalayers&tagmanagementsystems Thedatalayerviewdisplaysvariouslevelsofinformationdependingonwhattagmanagementsystemisinuse: GoogleTagManager:containerID(s)andstateofthedatalayer AdobeLaunch:buildandenvironmentinformation,stateofalldataelements,andanytriggeredrules AdobeDTM:buildandenvironmentinformation,aswellasanytriggeredloadrules Tealium:containerIDandstateofthedatalayer TagCommander:stateofthedatalayer additionaldatalayerobjects(seeSettings):stateoftheobject Forarray-typedatalayers(e.g.GTM),eacharrayentry(dataLayer.push)willappearasablockseparatedbyalightborder.Thisisalsothecaseforloadrules.Object-typedatalayerswillgenerallyappearasasingleentity.Nestedentriescanbeexpandedorcollapsedbyclickingthe+or-nexttotheentry;shift-clickthe+toexpandallthewaydown. Note:Ifmultipletagmanagementsystemsarefoundonthesamepage,informationonallofthemwillbedisplayedsequentially.IfmultipleGTMcontainersarefoundonthesamepage,adropdownwillallowyoutotoggleamongthem. Three-columnviewAsofversion1.2.0,thisisthedefaultviewforpagescontainingGoogleTagManagerorAdobeLaunch. ForsupportedTMSs(GTMandLaunch),three-columnviewprovidesamoreeffectiveviewintothedistinctionbetweenthecurrentstateofdataandthehistoryoffiredevents.RatherthanputtingTMSinfoinonecolumnandtagsinanother,thisviewprovides: onecolumnforthedatalayer(GTM)orfiredrules(Launch) onecolumnforthecomputedstateofthedatalayer(GTM)ordataelements(Launch) onecolumnfortags ThecomputedstateoftheGTMdatalayerreflectsthelatestvalueforeachkey,acrossallpushes(e.g.afteraseriesofclicks,the“ClickText”valuewillbethatofthelastelementclicked).Thinkofitasadictionaryofwhatvalueyou’dreceiveifyoureferredtothedatainitatthecurrenttime,whilethedatalayerwillshowthehistoryofthatdata. WhiletheorderoftheTMScolumnscanbeswitchedinthesettings,tags(ifpresent)willalwaysappearintherightmostcolumn. Tagsdataslayersupportssomeanalyticsandothertags: GoogleAnalytics(App+Web,Universalandclassic) AdobeAnalytics Floodlight Eachtagblockcontainsthefollowinginformation,whenavailable: UA-IDorreportsuiteID Tagtype(e.g.Universal,AdobeAnalytics) Taghittype(incertaincases,e.g.timinghit,Adobeclickevent) (GoogleAnalyticsonly)calloutsforGTM-firedtagsandnon-interactiveevents Asubsetofallinformationmostrelevantforthehittype,e.g.: AdobeAnalyticspageview:props,eVars,campaign,pageName,sitesection,events,etc. AdobeAnalyticstrack-linkcall:allstandard,pluslinkname GoogleAnalyticspageview:URLorpath;anycustomdimensions GoogleAnalyticsevent:eventcategory,action,andlabel;anycustomdimensions Clickthe+nexttothetagbrandtoviewthefulllistofqueryparametersandvaluesinthetag. ActionbarTherightsideofdataslayerallowsaccesstosomeadditionalactions: Thegearicon(“Options”)providesaccesstoyoursettings. TheredXicon(“ClearHistory”)willclearyourhistory,withtheexceptionofpreservingsomeinfoaboutthecurrentlyactivepage. Thediskicon(“Import/Export”)willallowyoutoexportasessiontoaJSONfile,orimportandreview/addtoaprevioussession. Themagnifyingglassicon(“ToggleSearch”)togglesthesearchbar,whichwillfilteryourdataasyoutypeyoursearchphrase.Notethatsearchiscase-insensitive.SearchcanalsobetoggledwiththekeyboardshortcutCtrl+Alt+F. dataslayersettingsSettingsareautomaticallysavedasyoueditthem. General usethree-columnlayoutwhereavailable:enable(default)ordisableside-by-sideviewsintoGoogleTagManagerandAdobeLaunchdata. swapTMScolumns:reversetheorderoftheTMScolumnsinthree-columnlayout. showdatalayerpresence:enable(default)ordisabletheTMSlogo/Xineachpagegroup. auto-collapsenesteddatalayervariables:whenthisoptionisenabled(default),nestedvariablessuchasGoogleAnalyticsenhancedecommercewillautomaticallybecollapsedtosavespace. auto-collapsegtm.*events:whenthisoptionisenabled,datalayereventslikegtm.clickandgtm.scrollDepthwillbecollapsedbydefault;clicktheeventtotoggleit. hideemptydatalayervariables:whenenabled,ifnovalueissetforakey,hideitentirely. showarrayindices:whenenabled,showafaintindicatorofthearrayindexforvaluesinsidearray-likedatalayers. shownavigationtimestamps:whenenabled,showafainttimestampforeachpageload. blocktagsfromfiring:requiresuseoftheChromedevorbetachannels.Whenthisoptionisenabled,supportedtagswillbeblockedfromactuallysendingtotheanalyticsplatform.NotethatblockingdoesnottaketheTagsselectionsintoaccount(i.e.allsupportedtagsareblocked,regardlessofwhetherornottheyareshown). don’tdecodequerystringvalues:whenenabled,tagparameters(e.g.aURIof‘/test/value’)willbepresentedinoriginal,encodedformat(e.g.‘%2Ftest%2Fvalue’) updateinterval(seconds):thevaluesofallnon-GTMdatalayers(includingLaunchdataelements)areupdatedonatimer-settheintervalofthetimerhere(e.g.“5”forevery5seconds),ordisableitentirelybysettingitto0.NotethatLaunchdataelementswillupdateafteraruleisfiredregardlessofthevalueofthissetting.NotethatifyourLaunchdataelementshavesideeffectsthatwouldbeundesirableforongoingpolling(e.g.acustomcodeelementthatalsomakesafetchrequest)youshoulddisableautoupdatebysettingthisto0. don’tupdateLaunchelementsonrules:enabletopreventLaunchdataelementsfromautomaticallyupdatingwhenaruleiscompleted. TagsAllsupportedtagtypesareshownbydefault;thesecanbeindividuallydisabled. IgnoredIDsTofilterouttagshittingspecificanalyticsproperties,enterthepropertyIDshere. AdditionaldatalayerobjectsAddglobalJavascriptobjectstowatchhere(e.g.digitalData). ReleasenotesReleasenotesandhistoryareavailablehere.