Mailchimp set up
Please follow these steps to set up your MailChimp account:
- Create a Mailchimp account.
- Create a Mailchimp API key and add it in the configuration section of the Magine Pro console. To generate the API key you press on your user name, and then on Account. When you're on the account page you then click "Extras" and then "API keys". Then you press "Create A Key".
- Now you can create an Audience. This will be the audience of all users that are registered on the Magine Pro platform for your service.
- When the audience is created, add the Audience ID in the configuration section in the field List ID of the Magine Pro Console. This is needed so we know which audience we should synch with. To find the Audience ID go to your Audience tab in Mailchimp, then click "View Contacts" and then click "Settings" and "Audience name and defaults". You will be able to find the ID under Audience ID.
- The last step is to configure the MERGE tags. Merge tags enable us to populate each user with user attributes. To configure the "Merge tags", go to the audience you have created, then click "View Contacts" and then click "Settings" and "List fields and *| MERGE |* tags". To add a new field, press "Add a Field" and select the data type. The "Field label" can be set to anything, but the "MERGE tag" needs to use the predefined names by Magine PRO.
Note: If you want to use Mailchimp to also get in touch with persons that don't have an account with your service yet. Please create a separate audience for them. Our system will archive all unknown email addresses in Mailchimp.
Mailchimp MERGE tags
Merge tags are used to populate different attributes for users in Mailchimp. These are the Merge tags that our system sends to your Mailchimp account once connected. You can choose which MERGE tags you want to use if you add an existing MERGE tag later on the data will be added with the next synchronisation. Most of this data is synchronised once every 24h. Data on the user object, e.g. name, country or contact email will be synchronised instantly when the change is done.
This list may be expanded later on and if you want to use the new attributes, you will need to add that Merge tag as well.
MERGE tag (Put this tag in the corresponding field) | Commonly used as "Field label" | Example & Details | Format |
Email Address | Email Address of the User. Note, that if the user updates their "contact address", this will also be updated in the Mailchimp Platform. | text | |
FNAME | First Name | First Name (uses the Name field from Console, and splits the first name & second name - if multiple names are used) | text |
LNAME | Last Name | Second Name (uses the Name field from Console, and splits the first name & second name). The name is split on space as a separator, then takes the last item. For e.g. "Jane Austen Doe" would result in "Doe" | text |
CREATED | User Created | When the user was created on the platform | date (MM/DD/YYYY) |
HWATCHED | Hours Watched | Total number of hours watched by the user, the last 365 days | number |
MARKET | Market | The country ISO code that the user first subscribed from | text |
CANCELDATE | Cancel Date | The date that the user cancelled the subscription | date (MM/DD/YYYY) |
LASTSEEN | Last Seen | The last time the user was active (either when the user was first created, or any viewing events, or any platform events - i.e. login, browse etc) | date (MM/DD/YYYY) |
REGMETHOD | Registration Method | The user registration method | text |
PPLATFORM | Purchase Platform | The store through which the current payment method is registered | text |
REGDEVICE | Device Of First Streaming | The device that the user streamed from the first time they used the service | text |
FIRSTSUB | First Subscription | The first subscription date | date (MM/DD/YYYY) |
PACTIVE | Paid Active Productids | The Product ID, of the current Paid Products (can be multiple Product IDs) * Web Subscriptions only | text |
PACTIVEN | Paid Active Subscription Product Names | The Product Names, of the current Paid Subscription Products (can be multiple Product names) * Web Subscriptions only | text |
PCANCELING | Paid Canceling Products | The Product ID, of the current Paid Products, that has been cancelled, but the subscriptions are still active until the end of the period. * Web Subscriptions only | text |
PCANCELINN | Paid Canceling Subscription Product Names | The Product Names, of the current Paid Products, have been cancelled, but the subscriptions are still active until the end of the period. * Web Subscriptions only | text |
PCANCELED | Paid Canceled Products | The Product ID of the Paid Products that were cancelled, and the subscription is no longer active (can be multiple Product IDs) * Web Subscriptions only | text |
PCANCELEDN | Paid Canceled Subscription Product Names | The Product Names, of the Paid Products that have been cancelled, and the subscription is no longer active (can be multiple Product IDs) * Web Subscriptions only | text |
TACTIVE | Trial Active Products | Product ID, of the Trial Products during the trial period (can be multiple Product IDs) * Web Subscriptions only | text |
TACTIVEN | Trial Active Subscription Product Names | Product Names, of the Trial Products during the trial period of the subscription (can be multiple Product Names) * Web Subscriptions only | text |
TCANCELING | Trial Canceling Products | Product ID, of the Trial Products during the trial period, that has been cancelled, but the subscription is still active until the end of the period (can me multiple Product IDs) * Web Subscriptions only | text |
TCANCELINN | Trial Canceling Subscription Product Names | Product Names, of the Trial Products during the trial period, that has been cancelled, but the subscription is still active until the end of the period (can me multiple Product Names) * Web Subscriptions only | text |
TCANCELED | Trial Canceled Products | Product ID, of the Trial Product, that has been cancelled, and the subscription is no longer active (can be multiple Product IDs) * Web Subscriptions only | text |
TCANCELEDN | Trial Canceled Subscription Product Names | Product Names, of the Trial Product, that has been cancelled, and the subscription is no longer active (can be multiple Product Names) * Web Subscriptions only | text |
ENTOFFERN | Entitled Offers Name | Offers that the user is currently entitled to. Maximum 3 exported. Ordered by the date the entitlement was added in descending order * All entitlements from all purchase flows (Web, In-App Purchase, Console, APIs) | text |
LENTOFFERN | Last Entitled Offers Name | The last 3 offers that the user was entitled to. * All entitlements from all purchase flows (Web, In-App Purchase, Console, APIs) | text |
CHECKOUT | Last Visit Of Checkout Page | Last Visit of the checkout page on the web (a page with an URL that ends with "/checkout" | date (MM/DD/YYYY) |
YCHECKOUT | Visited The Checkout Page | Was the checkout page visited (a page with an URL that ends with "/checkout") | text |
ISFREE | Is Free | Is the user a Free User (user have access to the service, but does not have any products that cost money. excluded: users that are in trial or have a discount that reduces the price to zero) | text |
TAGS | User Tags | User tags of the user from the backend (the tags that can be set and edited in the console) | text |
PROMOCODES | Promo Codes | User tags of the user from the backend (the tags that can be set and edited in the console) | text |
FAVCHAN | Favourite Channel | Most watched channels by the user, the last 365 days | text |
FAVDEVICE | Favourite Device | The most used device by the user, the last 365 days | text |
FAVGENRE | Favourite Genre | Most watched genre by the user, the last 365 days | text |
LTRANSS | Last Transaction | Date of last successful transaction (i.e. registration, first transaction, recurring transaction etc) | date (MM/DD/YYYY) |
ZIPCODE | Zipcode | The saved zipcode for the user | text |
GENDER | Gender | The saved gender for the user | text |
BIRTHDATE | Birthdate | The saved birthdate for the user | text |