Skip to content

Conversation

@ValentinPostindustria
Copy link
Collaborator

@ValentinPostindustria ValentinPostindustria commented Nov 17, 2025

Closes #33.

Breaking changes:

  • Remove app path parameter.
  • Add tenant and originSlug query parameters.
  • Make host dynamic and apply path v2.

Other features:

  • Support apiKey.
  • Move all configuration parameters in Config class and reuse it everywhere.
  • Separate GoogleAdIdManager and LocalStorage logic from the network client.
  • Rename Client to NetworkClient.
  • Move hash logic to separate TypeHasher class.
  • Separate network interceptors.
  • Demo apps are built using local SDK.
  • Unit tests with mock web server.
  • Build WebView for user agent only once and cache the result.
  • Apply automatic IDEA aligning.

Remove `app` path parameter. Add `tenant` and `originSlug` parameters. Make host dynamic and apply path `v2`. Move all configuration parameters in Config class and reuse it everywhere. Separate `GoogleAdIdManager` and `LocalStorage` logic from the network client. Rename `Client` to `NetworkClient`. Move hash logic to separate `TypeHasher` class. Separate network interceptors. Refactor SDK code.
Support secret api keys. Fetch user agent only once. Write unit tests with the mock web server.
@ValentinPostindustria ValentinPostindustria marked this pull request as ready for review November 21, 2025 09:07
ValentinPostindustria and others added 15 commits December 18, 2025 12:35
Remove custom network Adapter. Use native Retrofit adapter. Add Kotlin suspension.
Migrate from TypeHasher to IdentifiersEncoder. Add all identifier types. Cover with unit tests.
Use callbacks API. Rewrite demo apps to make the examples more readable. Use shorter logs.  Create Optable SDK instance once during application creation and reuse everywhere. Move fragments to one folder.
Add missed "reg" query param. Make Consents mutable. Provide `receiveGaidAutomatically` property. Refactor main methods javadoc.
private void applyOptableToGam(AdManagerAdRequest.Builder builder, @Nullable OptableTargeting targeting) {
if (targeting == null) return;

Map<String, List<String>> audiences = targeting.getAudiences();
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this (incorrect) code of generating a GAM kv pair is repeated - perhaps it should become part of the Optable SDK library gamTargeting() function?

Copy link
Collaborator Author

@ValentinPostindustria ValentinPostindustria Jan 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After renaming audiences to gamTargeting, maybe should I introduce some OptableSDK.applyGamTargeting(gamAdRequestBuilder, optableResult)?

result.addIfNotNull(IPV4, ids.ipv4Address, ::removeWhitespaces)
result.addIfNotNull(IPV6, ids.ipv6Address, ::normalize)
result.addIfNotNull(IDFA, ids.appleIdfa, ::normalize)
result.addIfNotNull(GAID, ids.googleGaid, ::normalize)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do we need to normalize GAID - maybe it is worth passing it as is, as system returns it?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It can be received from OptableSDK.tryIdentifyFromUrl(), so it can be uppercased or with some wrong characters. And that's how the legacy logic worked.

* We first convert the Uri to a lowercase string then re-parse it so that we are
* not dependent on case-sensitivity of the "oeid" query parameter
*/
fun eidFromUrl(urlString: String): String? {
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this name is a bit confusing, as eid is an extended id in OpenRTB, here we talk rather about a prefixed ID param

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Renamed to prefixedIdFromUrl.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rework Optable Real-time APIs configuration and request forming

4 participants