Skip to content

trackBrochureUsage ​

Tracks brochure usage info back to the SAM at both the TRACKING_EVENT and ACCESSED_EVENT level.

Request ​

http
POST /rest/brochures/track

Headers ​

HeaderRequiredDescription
x-nextinteract-authtokenYesAuth token returned from loginUser

Parameters ​

ParameterTypeRequiredDescription
mestring 100NoThe "Method" related with the tracking event. Current methods are pushnotification, usernotification, newsletter, homebanner. NOTE: this field relates to deeplink param it_method.
mistring 100NoThe "Metadata Id" associated with the method (usually the PK Key Id so we can link it back to its source. For UserNotification it would be the PK of the top-level Notification record. NOTE: this field relates to deeplink param it_metadata_id.
castring 100NoThe "Campaign" (if any) that the tracking event relates to. For "newsletters" this is the "Newsletter Tag". For pushnotification this is the PK of the Notification record. NOTE: this field relates to deeplink param it_campaign.
kmstring 256NoThe optional "Key Message" that is associated with for example a specific IVA page or event e.g. "Drug Efficacy".

SAMPLE REQUEST

json
[
  {
    "lo": 151.2089645862579,
    "to": 28800,
    "id": 3,
    "dt": "2011-12-14T06:31:39.000Z",
    "nm": "TestPDF",
    "bf": "pdf",
    "bt": 0,
    "vd": 345,
    "aa": [
      {
        "st": "2011-12-14T06:31:39.000Z",
        "ai": "1",
        "em": 1,
        "vd": 231,
        "km": "Drug Efficacy",
        "smartEntryId": 456
      }
    ],
    "dv": 1,
    "ns": 1,
    "es": 0,
    "bv": "3",
    "dn": "TestPDF",
    "pt": "iOS",
    "hw": "2",
    "os": "4.3.1",
    "ni": "2.1.16",
    "la": -33.8713419939655,
    "ip": "192.168.0.1",
    "si": "MYSESSIONID_64 chars max",
    "sd": "My Long Session Description1_256 chars max",
    "me": "pushnotification",
    "mi": "123",
    "ca": "My Push Campaign"
  },
  {
    "lo": 151.2089645862579,
    "to": 28800,
    "id": 3,
    "dt": "2011-12-14T06:32:19.000Z",
    "nm": "TestPDF",
    "bf": "pdf",
    "bt": 0,
    "vd": 300,
    "aa": [
      {
        "st": "2011-12-14T06:32:19.000Z",
        "ai": "1",
        "em": 0,
        "vd": 91,
        "km": "Product Info"
      }
    ],
    "dv": 1,
    "ns": 1,
    "es": 0,
    "bv": "3",
    "dn": "TestPDF",
    "pt": "Android",
    "la": -33.8713419939655,
    "ip": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
    "si": "MYSESSIONID_64 chars max",
    "sd": "My Long Session Description1_256 chars max",
    "me": "newsletter",
    "mi": "456",
    "ca": "My Newsletter Campaign"
  }
]

Response ​

200 OK ​

Errors ​

ExceptionDescription
WSInvalidParameterExceptionSee Error Definitions
WSInvalidAuthTokenExceptionSee Error Definitions
WSInsufficientPermissionsExceptionSee Error Definitions
WSUserServiceExceptionSee Error Definitions
WSBrochureVersionNotFoundExceptionSee Error Definitions
WSBrochureServiceExceptionSee Error Definitions
WSCacheServiceExceptionSee Error Definitions