Newsletter Widget API

In this document you will learn how to consume the MG2 Newsletter Widget API.

MG2 Newsletter Widget API is a Javascript library which allows you to consume, easily and quickly, every feature in the MG2 Newsletter Widget.

Installation

In order to consume the API, the page needs to include a reference to MG2Widget newsletterwidget.min.jsand a container element as the following example shows:

<head>
    <script id="scriptMg2Widget" src="{Link will be provided by MG2 team}">
    </script>
    … (the others JS references) …
</head>
<body>
     … (the others HTML elements) …
    <div id="mg2Widget-newsletter-container"></div>
</body>

Parameters

Parameter

Description

email

Subscriber’s email. If this param is not specified, it will be looked for in the cookie. If it doesn’t exist, it will be asked to user.

categoryIdsList

List of Category IDs. It needs to be specified as an array list. If this param is not specified, widget will show all the categories. (Omitted in unsubscribe flow)

newsletterIdsList

List of Newsletter IDs. It needs to be specified as an array list.

  • Open widget flow: If this param is not specified, widget will show all the newsletters.

  • Unsubscribe newsletters flow: If this param is not specified, widget will unsubscribe from all the newsletters.

viewMode

This param specifies the view mode in which newsletters are shown. There are two options: Tabs mode (1) or List mode (2). Default mode is Tabs. (Omitted in unsubscribe flow)

defaultCategoryId

This param specifies the category that will be opened by default.

siteCode

If this param is specified, only preferences for that NewspaperId will be displayed.

isModal

If this param is specified and has value 'true' then widget will be displayed in Modal mode

subscriberOnly

If this param is specified and has value 'true' then widget will display only Subscriber available newsletters. Otherwise only non-subscriber newsletters will be displayed.

showAll

If this param is specified and has value 'true' and 'subscriberOnly' has value 'true' then widget will display all newsletters. Otherwise result depends on 'subscriberOnly' flag.

Code Examples

Subscribe Flow

Filtering Preferences

Filtering Categories

Unsubscribe All

Unsubscribe Preference

Close Widget

Subscribe Flow Default Category

Open default category.

View Mode

Force a View Mode for Preferences.

Widget Display Mode

Display widget as modal.

Subscriber/Non-Subscriber Newsletters

Displays newsletters filtered by SubscriberOnly criteria.

Show All Newsletters

Displays all newsletters.

Email Campaign Links

LINKS: Please apply URLEncode to each QueryString parameter.

PreviousPurchase API 3.17.1.2NextInApp API (External Payments)

Last updated

Was this helpful?