Some implementations don’t want to include all variables in all link tracking image requests. Use the linkTrackVars
and linkTrackEvents
variables to selectively include dimensions and metrics in tl()
calls.
This variable is not used for page view calls (t()
method).
The Web SDK does not exclude certain fields for link tracking calls. However, you can use the onBeforeEventSend
callback to clear or set desired fields before data is sent to Adobe. See Modifying events globally in the Web SDK documentation for more information.
Adobe Experience Platform automatically includes defined events in link tracking hits if you do not use custom code.
If you set events in Analytics extension’s custom code editor, you must include the event in linkTrackEvents
using custom code as well.
The s.linkTrackEvents
variable is a string containing a comma-delimited list of events that you want to include in link tracking image requests (tl()
method). The following three criteria must be met to include metrics in link tracking hits:
events
variable. For example, s.events = "event1";
.events
variable in linkTrackVars
. For example, s.linkTrackVars = "events";
.linkTrackEvents
variable. For example, s.linkTrackEvents = "event1";
.s.linkTrackEvents = "event1,event2,event3,purchase";
The default value for this variable is an empty string. If this variable is not defined, all events are included in link tracking image requests. Note that Data Collection automatically populates this variable based on events set in the interface, so it is always set for implementations that use tags in Adobe Experience Platform.
Avoid using the Analytics object identifier (s.
) when specifying events in this variable. For example, s.linkTrackEvents = "event1";
is correct, while s.linkTrackEvents = "s.event1";
is incorrect.
The following link tracking function includes only event1
(not event2
) in the image request sent to Adobe:
s.events = "event1,event2";
s.linkTrackVars = "events";
s.linkTrackEvents = "event1";
s.tl(this,"o","Example Custom Link");