Like Jitsu? Give us a star on ā­ GitHub!

šŸ“œ Server Configuration

šŸ‘©ā€šŸ”¬ Extending Jitsu

Overview
Destination Extensions
API Specs

Jitsu Internals

Destination Tags

Destination Tag is a type of destination that installs configured HTML/Javascript tag to the website page on receiving an event from Javascript SDK.

The required version of Jitsu Server >= 1.41.0
The required version of Javascript SDK >= 2.5.0

How it works

You need to provide HTML/Javascript code of your tag and link the destination to an API key.

When Javascript SDK sends an event to the Jitsu Server, and a Destination Tag is linked to the API key, Jitsu Server synchronously processes HTML/Javascript code template and returns the resulting code block to the Javascript SDK.

Javascript SDK parses code block:

  • All <script> tags from the code will be appended to the <head> block of you website and javascript code will be executed by browser.
  • Other html tags will be appended to the end of <body> of you website.

Configuration

ParameterDescription
tagid (optional)Unique ID of Tag. Can be used for debugging.
By default tagid = destinationId
filter (optional)JavaScript expression to filter events so tag will be triggered for certain events only. E.g.:
$.event_type == "pageview"
template (required)HTML/Javascript code of your tag. Be sure to wrap Javascript snippets with <script></script>
You can use variables from incoming event. E.g.:
{{ .user.id }}

Example:

destinations:
  my_tag:
    only_tokens:
      - abc.123
    type: tag
    config:
      filter: $.event_type == "pageview"
      tagid: "tag123"
      template: |-
        <script>
        console.log("Hello {{ .user.id }} from Jitsu!")
        </script>

Filtering

You can use JavaScript expressions to filter events so tags will be triggered for certain events only. Here are few example of such JavaScript expressions for typical cases:

Only for "pageview" events

$.event_type == "pageview"

For "pageview" or "conversions" events

$.event_type == "pageview" || $.event_type == "conversions"

For authorized users only:

$.user.email

For "pageview" events from authorized users:

$.event_type == "pageview" && $.user.email