You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Forward Violations

FREE x

TEAM x

BUSINESS ✓

ADDON ✓

You can forward Violations (data that does not conform to your Protocols tracking plan) to a Segment Source to enable custom notifications, dashboards and further analysis in any Segment destination that accepts cloud-mode data.

To set up forwarding, navigate to the settings tab of the Source, then Schema Configuration. Select the source you'll forward events to from the Forwarding Settings Violations dropdown. Similar to Blocked Event forwarding, Segment recommends that you create a new Source for violations.

Screenshot of the Violations setting on the Source settings tab.

Violations are sent to the selected Source as analytics.track() calls. The call payload includes the following properties, along with the context.app and context.library objects to aid in filtering violations.

1    {
2      "context": {
3        "app": null,
4        "library": {
5          "name": "analytics-node",
6          "version": "2.1.0"
7        }
8      },
9      "event": "Violation Generated",
10      "integrations": {},
11      "messageId": "sch-Vir1JNrorwlBmCHrHWuPJekMx5c59T7c",
12      "properties": {
13        "appVersion": "",
14        "eventMessageID": "node-YhqA1DK9mgV55INDzOSd542fCFbIkc1o",
15        "eventName": "Order Completed",
16        "eventSentAt": "2018-08-23T21:35:02.85860964Z",
17        "eventTimestamp": "0001-01-01T00:00:00Z",
18        "eventType": "track",
19        "sourceID": "dInN1HJ4bi",
20        "sourceName": "Acme Store",
21        "sourceSlug": "acme_store_test",
22        "trackingPlanID": "rs_16KrwVbouFLrYbDkGh4LNslkrNp",
23        "trackingPlanName": "Acme Ecommerce TP",
24        "violationDescription": "properties.products is required",
25        "violationField": "properties.products",
26        "violationType": "Required"
27      },
28      "receivedAt": "2018-09-05T23:05:25.862826965Z",
29      "timestamp": "2018-09-05T23:05:25.862826855Z",
30      "type": "track",
31      "userId": "schema-violations",
32      "forwardedFromProject": "dInN1HJ4bi"
33    }

(information)

Info

Enabling Violation forwarding generates 1 additional MTU in your workspace. If you are on an API billing plan, you are charged for the increased API volume generated by the forwarded violations.

(warning)

Violation Generated events

Violation Generated events do not appear in the source's Schema tab, but they do appear as Violation Generated events in the debugger.