Mailchimp setup
Create a Mailchimp account.
Create a Mailchimp API key and send to Magine Pro. 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”, copy the key and send it securely to Magine Pro.
Now you can create a 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 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 is what will enable us to populate each user with a lot of 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 be of predefined names by Magine PRO. See a separate article for names and descriptions of all our predefined “Merge tags” that can be used.
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. The data is synchronised once every 24h.
This list may be expanded later on and if you want 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). Name is split on space as a separator, then takes the last item. 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 (i.e if the user first registered their account first through Web, it will be email) | text |
PPLATFORM | Purchase Platform | The store through which the current payment method is registered (i.e. Web = Adyen / Batch = Back End Job) | 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 me multiple Product IDs) | 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. | text |
PCANCELED | Paid Canceled Products | The Product ID, of the Paid Products that has been cancelled, and the subscription is no longer active (can me multiple Product IDs) | text |
TACTIVE | Trial Active Products | Product ID, of the Trial Products during the trial period (can me multiple Product IDs) | 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) | text |
TCANCELED | Trial Canceled Products | Product ID, of the Trial Product, that has been cancelled, and the subscription is no longer active (can me multiple Product IDs) | text |
CHECKOUT | Last Visit Of Checkout Page | Last Visit of the checkout page (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. e.g. not users that are in trial or have a discount that reduce 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 console) | text |
PROMOCODES | Promo Codes | Current / last promo code applied to the user / offer | text |
FAVCHAN | Favourite Channel | Most watched channels by the user, the last 365 days | text |
FAVDEVICE | Favourite Device | 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) |