Document toolboxDocument toolbox

Blueshift Subscription Renewal Flag Update Email

Summary / TL:DR: This article will introduce you to Subscription Renewal Flag Update emails in Blueshift.

3 min read


Table of contents


Capability

Send an email through Blueshift to confirm processing of a customer request to cancel automatic renewal on an active subscription.


Description

When the renewal option on a subscription is changed by a customer, the renewal flag for that customer's subscription record is updated in Advantage. The Advantage workflow captures the update and generates an event to inform Blueshift about the update. This event then triggers a campaign in Blueshift.


Blueshift Event Name

subscription_renewal_flag_update


Event Payload Parameters

Parameter

Description

Parameter

Description

billing_status

Accounts receivable status

circulation_status

Code that indicates if the publication is being sent

customer_firstname

First name of billTo customer

customer_lastname

Last name of billTo customer

email

Email address of billTo customer

event

Name of triggering event

expiration_date

The issue date of the last issue the subscriber will receive, including advance renewals.

issues_to_go

Number of issues left in the subscription

owning_org

Code for the legal entity associated with this subscription

publication_code

Code that identifies the publication

publication_title

Title of the publication associated with the subscription

renewal_flag

Indicates whether a renewal notice should be sent to the subscriber

retailer_customer_id

Concatenation of [Advantage billTo customer number]-[Advantage billTo emailId]

term_length

Number of subscriptions included in the subscription order

billing_status

Accounts receivable status

circulation_status

Code that indicates if the publication is being sent

customer_firstname

First name of billTo customer

customer_lastname

Last name of billTo customer

email

Email address of billTo customer


Sample Payload

 

{ "event":"subscription_renewal_flag_update", "owning_org":"610", "email":"email@14west.us", "customer_firstname":"Firstname", "customer_lastname":"Lastname", "retailer_customer_id":"000106061781-000089668775", "billing_status":"P", "circulation_status":"R", "issues_to_go":2, "term_length":12, "renewal_flag":"D", "publication_title":"Health Sciences Institute", "publication_code":"HSI", "expiration_date":"2020-12-01" }

Setting up a Campaign

  1. Create a triggered campaign using the event ‘subscription_renewal_flag_update’.

  2. Set the condition “Skip Global Inclusion Segment Check” to “Yes”.

  3. Select the associated template for your campaign. A sample email called 'FOR_COPY_SAMPLE subscription_renewal_flag_update' is available in your Blueshift Production instance.

  4. If one campaign is used for setting up mailing for multiple publications, set the condition “User can be in the campaign journey” to “Multiple times concurrently”. This will allow you to send an email to a customer who cancels multiple subscriptions.


Reporting

The publication code in the payload is whitelisted to be passed in the mailing activity events. This will be available in the reporting platform as the list code.


Things to Consider When Planning your Migration and/or Setup

  1. Please follow the Transition Guidelines shared by the MarTech team during your Migration Planning workshop.

  2. If you have an existing Message Central Auto Delivery (BCL) Cancellation workflow on Advantage, your new Blueshift workflow has already been set up on Advantage and is ready to send events.

  3. If you never had an Auto Delivery Cancellation workflow on Advantage, there is no longer a need to share the new campaign ID with the Advantage team during initial set up. The same event category can be used for multiple campaigns, segments, etc. without Advantage configuration support.

  4. The Auto Delivery Cancellation workflow will account for all owning orgs associated with your Blueshift instance. Please note: additions of new owning orgs must be reported to the MarTech team so it can be added to your Blueshift instance.


Wrap up

You should now have a better understanding of Subscription Renewal Flag Update emails in Blueshift.

Still need help?

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

Click here to open a ticket


Related Content


Level up with a Masterclass

Evolve course title

Get started!

Evolve course title

Get started!


 

com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'html-macro' is unknown.