UtmParameters

Where a visit came from, as marketing links carry it: source, medium and campaign.

Use it to record a campaign with a sign-up or an order. For a whole address, use Url.

Shape

Write every field when you build one, and give a field that isn't required as none.

Example

UtmParameters {    source: "mailing"    medium: "email"    campaign: "autumn_sale"    term: none    content: none}

text.parse(raw, as: UtmParameters) reads one from text that comes from outside. Text that isn't one at all fails malformed, such as utm_source=mailing.

Good to know

• As text, parameters must be in the standard's order, utm_source first.
• == tells you whether two are the same. < and list.sort_by don't take it, so sort by one of its parts instead.

In JSON

An object of its parts, in a request, a response or json.write:

{"source":"mailing","medium":"email","campaign":"autumn_sale","term":null,"content":null}{"source":"search","medium":"cpc","campaign":"spring","term":"running shoes","content":"banner"}

When you read one, a field that isn't required may be left out, or sent as null.

Details