View source for Firefox/Stub Attribution

= Overview =

== Original Rationale ==

[https://bugzilla.mozilla.org/show_bug.cgi?id=1222258#c0 [breakdown<nowiki>]</nowiki> Allow for attribution of acquired Firefox Desktop users]

== Technical Plan ==

[https://docs.google.com/document/d/1H59-4zfw0OAFyqfJw71dI0jD7Z-NLvLyowPw6pNhAVs/edit?ts=56e9d8db Stub Attribution Technical Details]

== Bugs ==

* [https://bugzilla.mozilla.org/show_bug.cgi?id=1259607 Bug 1259607 - (meta) Stub Attribution]
<bugzilla>
{
"blocked": "1259607",
"include_fields": "id, summary, assigned_to, status",
"resolution": "---",
"maxrows":"50",
"order": "bug_id"
}
</bugzilla>

= Projects =

== Construct and transmit attribution code on mozilla.org ==

[https://bugzilla.mozilla.org/show_bug.cgi?id=1259612 Bug 1259612] [tracking] Construct and transmit attribution code on mozilla.org

When users visit the Mozilla download page, the website will construct an attribution code.
* DRAFT algorithm: https://docs.google.com/document/d/1DzIg19kAdtYEzS_waQNCQBfi8CSGj4cl9N8T24WSiyc/edit#heading=h.883gjcln63zt 
* Example attribution code hashes from real mozilla.org download: https://docs.google.com/spreadsheets/d/1U-0JHpc3INJnBwTFkdrPqpk7yqvpEn16DJtp6d6TRiY/edit#gid=1351498707
* No tracking codes will be used if the user has DNT set.
* A single, encrypted, code.
* Owner: mozilla.org website team

This code will be passed to bouncer via a URL param. For example:
* https://download.mozilla.org/?product=firefox-45.0-SSL&os=win&lang=en-US&stub_attcode=utm_getfirefox
* In the future other stub_ codes may be present, to signal things other than attribution: for example users who opted into telemetry or already saw the “know your rights” privacy notice
* Owner: mozilla.org website team

== Stub installer support for attribution ==

[https://bugzilla.mozilla.org/show_bug.cgi?id=1261140 Bug 1261140] Stub installer support for attribution

Owner: mhowell, bsmedberg, rstrong

* The stub installer will be constructed with a special section that can be modified without invalidating the signing
** For more details about the options, see https://docs.google.com/a/mozilla.com/document/d/1iMkD-tqjHq59ZffFXGRp4aw8wHDENauQ9oaifiRNtNo/edit?usp=sharing 
* Bouncer will point to a modified version of the normal stub installer: the stub_attcode and other stub_* attributes will be passed through as bytes in the stub installer binary.
** pending questions on if this is possible.
* The stub installer self-extractor will pass this info (when present) to the stub installer.
** Owner: install/update team
* The stub_attcode will be sent with the stub installer success ping.
** Owner: install/update team
* The stub_attcode will be saved to disk with the install.
** This is how it gets passed to Firefox for use with Telemetry.
** Owner: install/update team

== We will include the stub_attcode value in the unified telemetry activation ping ==

[https://bugzilla.mozilla.org/show_bug.cgi?id=1120370 Bug 1120370] Implement a Telemetry activation ping

* ... (and potentially ongoing UT main pings)
* First time you run Firefox on a new profile. This is a new bug.
* Questions
** Do we need to send the code with main pings for a specified time period? If so, we’ll need a bug
** If the attribution code is only sent on the activation ping, do we use profileID to correlate a profile with a specific cohort?
* Owner: bsmedberg or install/update team

== Construct a funnel dashboard that for each code lets us monitor the funnel in close-to-realtime ==

[https://bugzilla.mozilla.org/show_bug.cgi?id=1259614 Bug 1259614] [tracking] Construct a funnel dashboard for Stub Attribution that allows us to inspect the funnel in close to realtime

Metrics
* campaign clicks (logs/GA)
* Download clicks (bouncer logs)
* Install success (stub install ping)
* Firstrun (UT activation ping)
* Ongoing churn and engagement (UT main pings)

Owner: Heather team, with kparlante responsible for pings coming through system.

== Make stub attribution script available on the server ==

[https://bugzilla.mozilla.org/show_bug.cgi?id=1273940 Bug 1273940] Make stub attribution script available on the server

Owner: Travis, oremj, relud

= Team =

* Cory Price
* Benjamin Smedberg
* Christopher More
* Katie Parlante
* Matt Howell
* Robert Strong
* Thomas Huelbert
* Travis Blow - tbd
* Jeremy Orem - tbd
* Heather Crince
* Stephen Donner

= Schedule =

2016Q2

= Communications =

* IRC: #stub-attribution
* Email Group: https://groups.google.com/a/mozilla.com/d/forum/stub-attribution