Promo codes and tracking

Promo code handling differs between TNEW and Blocks Office. Use the section for the booking journey your site has enabled.

TNEW promo codes

When TNEW features are on 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 in basker_tnew_promo. Your theme reads this value and adds it 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

Your theme carries UTM parameters, such as utm_source, utm_medium, and utm_campaign, into TNEW when it builds the outbound link.

Blocks Office attribution

Blocks Office needs a valid domain. When Blocks Office is on, Basker checks each public URL for the source, promo, or sourcenumber parameter. A URL with one of these parameters 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 keeps 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 is on. Confirm the relevant TNEW or Blocks Office option is also on.
• For TNEW, confirm the page creates basker_tnew_promo. Confirm the theme adds promo to the booking URL.
• For Blocks Office, confirm the configured domain is a valid HTTPS origin. Test with one attribution parameter first.
• Test in a normal public window. Preview deliberately bypasses the Blocks Office handoff.