Thrift module: tracker

Module	Services	Data types	Constants
tracker		BulkSubmission BulkSubmissionType IndividualSubmission IndividualSubmissionMetadata SubmissionMetadata TrackerSubmission

Enumerations

Enumeration: BulkSubmissionType

`APPLE_NEWS_RTA`	`1`

Data structures

Struct: SubmissionMetadata

Key	Field	Type	Description	Requiredness	Default value
1	uniqueSubmissionId	`string`	Unique id associated with this submission. Ophan never makes better than at-least-once delivery promises, so you must ensure that processing two events with the same uniqueRawTrackerSubmissionId has no effect Note that for web submissions, this id is likely passed though as the unqiue event id for the events, but as native mobile submissions may represent multiple events, each event contained within this submission must have a diffrentiated id.	required
2	receivedDateTime	`i64`	The date time (in millis since epoch UTC) at which this submission was received by the tracker.	required

Struct: IndividualSubmissionMetadata

Key	Field	Type	Description	Requiredness	Default value
1	browserId	`event.AssignedId`	The unique id associated with this browser. Currently this is maintained by setting a cookie for web events, or otherwise determined for native apps.	optional
2	xForwardedForHeader	`string`	The full value of the X-Forwarded-For header supplied. We need this for both Web & Native app submissions, because the Slab will use it to establish the IP address of the user, and then use IP address to geo-locate the user	optional

Struct: IndividualSubmission

Key	Field	Type	Description	Requiredness
1	metadata	`IndividualSubmissionMetadata`		required
2	nativeAppSubmission	`nativeapp.NativeAppSubmission`	Detail of a Native App submission, as opposed to a Web submission	optional
3	webSubmission	`websubmission.WebSubmission`	Detail of a Web submission, as opposed to a Native App submission	optional

This struct is for submissions that have come from an individual device,
e.g. a single WebSubmission, or a number of submissions from a single Native
App user

Struct: BulkSubmission

Key	Field	Type	Description	Requiredness	Default value
1	type	`BulkSubmissionType`		required
2	submissionData	`binary`		required

This struct is for submissions that have come from multiple devices,
e.g. a set of submissions sent by Apple News for multiple article view events.

Struct: TrackerSubmission

Key	Field	Type	Requiredness
15	metadata	`SubmissionMetadata`	required
16	individualSubmission	`IndividualSubmission`	optional
17	bulkSubmission	`BulkSubmission`	optional

This struct is intended for private consumption inside ophan only.

It represents the raw data collected by the tracker, passed onto The Slab for
enhancement into ophan events.