Developer Hub

Our comprehensive guides and documentation will help you to start working with Minna's subscription management services.

Get Started    

Monitoring insights

Monitoring insights are intended to notify the users of the current state of their subscriptions. For example, if the cost of a subscription has increased it will be reflected with a Monitoring insight. Below five insights are explained further, with examples and their trigger logic.

Binding Period Ending

Information

Description

Type

BindingPeriodEnding

Prerequisites

  • Identify product

Trigger Logic

40 days before the end of the binding period for a contract. (Binding period is the time during which the user is bound to a contract with a supplier and can therefore not cancel or improve his/her subscription).

Removal Logic

Either when the Insight is manually dismissed by the user or when the current date is equal to the date when the binding time ends.

Update Logic

This Insight is never updated.

Frequency

The Insight can occur more than once in list of Insights, once for each subscription.

Example BindingPeriodEnding Insight model:

{
  "id": "f632dda4-47b0-46de-87d6-6190f014aa9c",
  "createdAt": "2020-05-18T13:52:18.94Z",
  "acknowledgedAt": "2020-05-20T10:17:21.828Z",
  "userId": "39fc5e58-5697-4b13-b297-84ca87549197",
  "webUiPath": "/insights",
  "content": {
    "type": "BindingPeriodEnding",
    "bindingPeriod": {
      "endsAt": "2020-05-31T00:00:00Z",
      "startedAt": "2020-05-18T12:00:00Z"
    },
    "possibleActions": [
      "Switch",
      "Cancel"
    ],
    "subscriptionId": "3a7c57fe-d9cc-4954-b332-0e8a7eb971b2",
    "serviceProvider": {
      "id": "dc9fe5bc-9408-483e-a313-a74c900e080d",
      "name": "Gigabytes",
      "logotypeUrl": "/api/logotype-images/13779106-29a8-4887-8608-705ecd1d8b72.png"
    },
    "service": "broadband",
    "contractId": "d376ca49-5ff3-4bc2-a003-3533b491b3b1"
  }
}

New Subscription Found

Information

Description

Type

NewSubscriptionFound

Prerequisites

  • Identify Product
  • Subscriptions detected

Trigger Logic

When a new subscription is found during the subscription identification phase and the user was registered at Minna at before yesterday.

Removal Logic

The Insight automatically expires and is removed after 21 days of its creation.

Update Logic

This Insight is never updated.

Frequency

The Insight can occur more than once in list of Insights, once for each subscription.

Example NewSubscriptionFound Insight model:

{
  "id": "4c486098-4823-45d5-b21e-1bd066740aa7",
  "createdAt": "2020-05-18T13:52:18.94Z",
  "acknowledgedAt": "2020-05-20T10:17:21.828Z",
  "userId": "3e4fc9cd-da08-4b59-99c9-253e48b7e34e",
  "webUiPath": "/insights",
  "content": {
    "type": "NewSubscriptionFound",
    "contracts": [
      {
        "id": "15b087ce-5b27-4a37-baa2-501468bcb0ac",
        "service": "broadband",
        "possibleActions": []
      }
    ],
    "paymentInterval": {
      "amount": 1,
      "unit": "month"
    },
    "subscriptionId": "9de279be-a0bf-43a2-ae78-c4fde09cd3ec",
    "serviceProvider": {
      "id": "1a1ae087-887c-4c3a-b92b-9a3057bcb6f4",
      "name": "Northcom",
      "logotypeUrl": "/api/logotype-images/7d8f1b22-2a77-4a2b-a254-2ceba460e040.png"
    },
    "cost": {
      "amount": 62.49,
      "currency": "SEK"
    }
  }
}

Subscription Cost Changed

Information

Description

Type

SubscriptionCostChanged

Prerequisites

  • Identify Product
  • Subscriptions detected

Trigger Logic

If a significant price change (increase or decrease) was observed during the subscription identification phase and the user was registered at Minna before yesterday.

Removal Logic

The Insight automatically expires and is removed after 21 days of its creation. The user can also
dismiss it manually before its expiry to remove it.

Update Logic

This Insight is never updated.

Frequency

The Insight can occur more than once in list of Insights, once for each subscription.

Example SubscriptionCostChanged Insight model:

{
  "id": "dcb72b14-603c-4d84-a6b7-a1f741bfe0e8",
  "createdAt": "2020-05-18T13:56:04.597Z",
  "userId": "3e4fc9cd-da08-4b59-99c9-253e48b7e34e",
  "webUiPath": "/insights",
  "content": {
    "type": "SubscriptionCostChanged",
    "contracts": [
      {
        "id": "d28ed7f2-8306-49c7-bb83-c5a90a9db9de",
        "service": "fitness",
        "possibleActions": [
          "Switch",
          "Cancel"
        ]
      }
    ],
    "oldPaymentInterval": {
      "amount": 1,
      "unit": "month"
    },
    "subscriptionId": "31100b36-6dc4-4a11-8d9a-5b0ee3daa3aa",
    "serviceProvider": {
      "id": "90bb633d-6407-4793-96d2-7fc3caf18eeb",
      "name": "Happyfit",
      "logotypeUrl": "/api/logotype-images/47b0d957-e38f-4573-a937-9e54e4c03ff9.png"
    },
    "newPaymentInterval": {
      "amount": 1,
      "unit": "month"
    },
    "newCost": {
      "amount": 499,
      "currency": "SEK"
    },
    "oldCost": {
      "amount": 700,
      "currency": "SEK"
    },
    "oldCostWasLastActiveAt": "2020-04-27T12:00:00Z"
  }
}

Unresolved Subscription

Information

Description

Type

UnresolvedSubscription

Prerequisites

  • Identify Product
  • Subscriptions detected
  • Onboarding Insight resolved

Trigger Logic

When a new subscription is found during the subscription identification phase and the subscription has multiple services. The Insight reappears on the 20th every month if no action has been taken.

Removal Logic

The Insight is removed when the user resolves or removes the subscription. The user can also dismiss it manually.

Update Logic

This Insight is never updated.

Frequency

The Insight can occur more than once in list of Insights, once for each subscription.

Example UnresolvedSubscription Insight model:

{
  "id": "e90f126a-5fa5-451c-9b8d-449941b1ccf4",
  "userId": "20d1b149-6c47-4f7d-8686-413aaad8bde1",
  "createdAt": "2020-04-20T18:43:57.940571+02:00",
  "acknowledgedAt": "2020-04-24T18:43:57.940571+02:00",
  "webUiPath": "/subscription/88726e16-3aaf-4668-ab02-5fc28711cedf/details",
  "content": {
    "type": "UnresolvedSubscription",
    "subscriptionId": "88726e16-3aaf-4668-ab02-5fc28711cedf"
  }
}

Unreviewed Action

Information

Description

Type

UnreviewedAction

Prerequisites

  • Identify Product
  • Subscriptions detected
  • Onboarding Insight resolved

Trigger Logic

When a new subscription is found during the subscription identification phase and the subscription can be improved. The Insight reappears on the 20th every month if no action has been taken.

Removal Logic

The Insight is removed when the user completes a guide, removes improvable contract or removes subscription. The user can also dismiss it manually.

Update Logic

This Insight is never updated.

Frequency

The Insight can occur more than once in list of Insights, once for each subscription.

Example UnreviewedAction Insight model:

{
  "id": "e90f126a-5fa5-451c-9b8d-449941b1ccf4",
  "userId": "20d1b149-6c47-4f7d-8686-413aaad8bde1",
  "createdAt": "2020-04-20T18:43:57.940571+02:00",
  "acknowledgedAt": "2020-04-24T18:43:57.940571+02:00",
  "webUiPath": "/subscription/88726e16-3aaf-4668-ab02-5fc28711cedf/contract/645da340-faa3-8f53-20ba-6fc28731cedf/details",
  "content": {
    "type": "UnreviewedAction",
    "subscriptionId": "88726e16-3aaf-4668-ab02-5fc28711cedf",
    "contractId": "645da340-faa3-8f53-20ba-6fc28731cedf"
  }
}

Updated 8 months ago


What's Next

API reference

Monitoring insights


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.