Learn about the thinking behind eyeo Chromium SDK.
This page contains the eyeo Chromium SDK's architectural decision records (ADRs), which summarize the most important software design choices made during the development of the eyeo Chromium SDK.
These decisions address functional and non-functional requirements that eyeo finds architecturally significant.
Patching these limitations requires significant tradeoffs, some of which include the following:
- More conflicts to solve after Chromium updates
- Less flexibility to introduce new features and optimizations
- Irreconcilably different objectives between eyeo and Chrome's authors
Chromium authors control subresource filter development. As a result, they may have different (ad-related) business objectives that could take subresource filtering in a direction that doesn't fit with eyeo's vision.
For these reasons, the eyeo team chose not to build on top of the subresource filter, opting for an implementation with ad-filtering capabilities built from scratch.
In previous implementations of our ad-filtering core, eyeo used minified filter lists to reduce memory consumption for mobile users. More recent implementations achieved this reduction by adopting FlatButters as a filter list file format and by moving from V8 to a native implementation.
eyeo now uses full filter lists, which allow for more filter rules. This improves user experience and blocks a greater number of intrusive ads. More Acceptable Ads are also allowed, which increases for publishers who adhere to the Acceptable Ads standard.
Filter lists aren't consumed in plain text format right after download. Instead, they are converted from plain text into the FlatBuffers format, which offers the following advantages:
- Reduced memory consumption, down to approximately 15 MB
- Reduced startup time, from seconds down to milliseconds
- No negative impact on page load time, except for sites with long URLs
- Facilities for multi-threading and synchronous popup blocking
- No required deserialization, because FlatBuffers is already in a binary format
- FlatBuffers can be memory-mapped and accessed as memory directly from disk.
- Accessing data in a flatbuffer is as fast as dereferencing pointers to memory.
A FlatBuffers file contains only one filter list, for the following reasons:
- Filter lists updated at different times can be downloaded independently.
- Less time consumed in conversion than if all selected filter lists are combined in one file
- For long-term distribution of FlatBuffers files, having to provide a file containing all selected filter lists would cause excessive combinations.
Coupling the user counting service with filter lists downloads gives eyeo insight into SDK usage across Chromium, OS, and platform versions.
As a dedicated service, it also allows eyeo to monitor Acceptable Ads opt-out rate, while enabling partners to serve and monetize filter lists from their own servers.