Firefox/Stub Attribution
Contents
- 1 Overview
- 2 Projects
- 2.1 Construct and transmit attribution code on mozilla.org
- 2.2 Stub installer support for attribution
- 2.3 We will include the stub_attcode value in the unified telemetry activation ping
- 2.4 Construct a funnel dashboard that for each code lets us monitor the funnel in close-to-realtime
- 2.5 Make stub attribution script available on the server
- 3 Team
- 4 Schedule
- 5 Communications
Overview
Original Rationale
[breakdown] Allow for attribution of acquired Firefox Desktop users
Technical Plan
Stub Attribution Technical Details
Bugs
ID | Summary | Assigned to | Status |
---|---|---|---|
1689106 | The attribution is not added fore new users if the Firefox stub installer is downloaded directly from the Mozilla "download/thanks/" page | NEW |
1 Total; 1 Open (100%); 0 Resolved (0%); 0 Verified (0%);
Projects
Construct and transmit attribution code on mozilla.org
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
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
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
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
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