Promo codes and tracking

Promo-code handling differs between TNEW and Blocks Office, so use the section for the booking journey your site has enabled.

TNEW promo codes

When TNEW features are enabled and a visitor arrives on a Basker page with ?promo=, Basker stores the value in the basker_tnew_promo browser cookie for 30 minutes.

For example, a visit to remarkable-theatre.example/events/summer-show?promo=12345 stores 12345. A later visit with ?premove=Y clears the cookie.

Add the promo to TNEW links

Basker captures the value for your theme to read from basker_tnew_promo and add as the promo parameter on each outbound TNEW booking URL.

Once the visitor follows that URL, TNEW applies ?promo=. This URL handoff is the supported path for passing the promotion into TNEW.

If a code is captured but does not reach TNEW, ask your implementation team to check this theme step.

Other campaign parameters

Carrying UTM parameters such as utm_source, utm_medium, and utm_campaign into TNEW is handled by your theme when it builds the outbound link.

Blocks Office attribution

When Blocks Office is enabled with a valid domain, an eligible public Basker URL containing source, promo, or sourcenumber redirects the visitor into Blocks Office automatically.

Basker sends the chosen value to Blocks Office as sourceNumber. If a URL contains more than one supported parameter, the priority is:

1. source
2. promo
3. sourcenumber

The redirect also supplies a return path to the original Basker URL. Basker removes those three attribution parameters from the return path but preserves unrelated parameters. Preview requests and service routes such as the API, sitemap, and theme assets do not trigger the handoff.

Promo codes through Basker redirects

Manual Basker redirects preserve query parameters. A redirect from /summer-offer to /events/summer-show therefore carries ?promo=12345&utm_source=flyer to the destination. If the destination already defines a value for the same parameter, the destination's value wins.

See Redirects for the wider redirect workflow.

Troubleshooting checklist

• Confirm that the Tessitura app and the relevant TNEW or Blocks Office option are enabled.
• For TNEW, confirm the page creates basker_tnew_promo and the theme adds promo to the booking URL.
• For Blocks Office, confirm the configured domain is a valid HTTPS origin and test with one attribution parameter first.
• Test in a normal public window: preview deliberately bypasses the Blocks Office handoff.