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
Unsubscribe Link
The following unsubscribe link should be used in the refactored instance:
https://signupapp2.YOURDOMAIN.com/signupapp/unsubs/v2?
Once clicked on the link should look something like the following:
https://signupapp2.YOURDOMAIN.com/signupapp/unsubs/v2?vid2=007434f6116c1b262cacae4def1de9707cd16a57217e3eaec65f6d7903976d36&bsft_clkid=cf45cd3a-c34f-4f00-9dbb-e5419e6b4c2f&bsft_uid=09127a6e-0c13-4238-a94f-be92b5ab08fc&bsft_mid=222108b4-db68-4b7b-b5e1-8a1e939a1757&bsft_eid=175c8b10-1af2-4b63-b3a7-b8f6056e268f&bsft_utid=09127a6e-0c13-4238-a94f-be92b5ab08fc-e460f020dc7c9738cfd104c681d57894&bsft_mime_type=html&bsft_ek=2022-02-09T14%3A45%3A24Z&bsft_aaid=e7db2710-78ab-4f64-94d2-0f2b270fcc83&bsft_lx=3&bsft_tv=38
Blueshift Parameters
As you can see in the link above, Blueshift will also automatically include link parameters relevant to the campaign itself. There are three important parameters to note:
...
Parameter
...
What is it?
...
bsft_eid
...
| Info |
|---|
If you would like to add additional default custom parameters please submit that request to Global Support. |
...
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 of 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 upYou 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! |
...