Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Summary / TL:DR: This article will show you how list unsubscribes function in the refactored instance of custom and relevant campaign parameters are added to all links that are sent from Blueshift.

...

Custom

...

vid2 Parameter

In the refactored instances of Blueshift a custom query parameter will be added to all triggers and therefore all links that get sent out of Blueshift will have it included by default. This query parameter is defined at the trigger level and so it eliminates the need to manually add the necessary query parameters at the template level in order for list unsubscribes to workthe verification id. Below shows the key-value pair:

...

Blueshift Feature Documentation

Info

If you would like to add additional default custom parameters please submit that request to Global Support.

Blueshift Parameters

...

If you would like to update existing triggers that do not include the newly added default parameter(s), you will first have to manually add it/them to the trigger in order to save the update, otherwise Blueshift will throw a validation error.

...

How it Works

The vid2 variable is comprised of the advantage customer number, list code, email address and delimiters which are then AES-256 encrypted within a single liquid object.

This variable is then decrypted by 14West systems to be used in things such as reporting, unsubscribes, and order form auto-pop.

The decrypted value will look something like the following:

000123456789@@LISTCODE@@emailadress@14west.us

Because this will be added to all links including unsubscribe links, there is no need to manually add any query parameters within the template as this will be done programmatically.

...

Blueshift Parameters

Blueshift will also automatically include link parameters relevant to the campaign itself. They are as follows:

Parameter

What is it?

bsft_clkid

Unique identifier generated when clicking a link

bsft_uid

Unique identifier assigned to the Blueshift profile

bsft_mid

Unique message identifier*

bsft_utid

Unique identifier assigned to the profile with the transaction list code appended to it

bsft_mime_type

Indicates the type non-ASCII components of a message

bsft_tv

Template version

bsft_aaid

Unique identifier of the adapter used in the campaign

bsft_eid

Unique identifier for the triggerof experiment. Even if there is a single template on a trigger, it will generate a unique bsft_eid.

bsft_ek

Campaign execution timetimestamp

bsft_lx

Identifies the instance of the URL when the same URL is used in multiple locations in the template.

bsft_pid

Unique ID of a Blueshift catalog item

bsft_pp

When using an array of catalog items, this indicates the ordinal number in which the item was surfaced

pk

This is the profile key which is comprised of the affiliate id and email address which is MD5 hashed. You can read more about this parameter here.

...

vid2

Encrypted concatenation of advantage_customer_number, list or item code, and email_address joined by ‘@@’

utm_campaign

Name of the campaign

utm_source

Blueshift

utm_medium

Channel that is used in Blueshift (Email, SMS, Push)

The last three parameters of bsft_eid, bsft_ek, and bsft_lx are used by Data and Analytics to associate orders with a campaign and so again, there is no need to manually add any query parameters to promotion links within the template.

Info

Please keep in mind that these URL parameters are added automatically so there is no need to add them within the template. We have seen issues where the value is missing from the URL if any of the above parameters are added within the template.

Tip

Wrap up

You should now know how list unsubscribes and promo links will work in the refactored instance of Blueshift.

Info

Still need help?

We know this can be frustrating. To get further help please open a Support ticket.

Click here to open a ticket the vid2 custom parameters work and what other parameters are included in Blueshift links.

...

Note

Cannot find the article you’re looking for?

Suggest a new article here!