API Reference

What is ATOM ?

ATOM (or Anonymous Targeting on Mobile) offers privacy-first targeting and monetization capabilities that puts user privacy at the forefront. Mobile app developers can monetise their unaddressable users without relying on persistent and diminishing iOS device identifiers, like IDFA.

ATOM is a small library that is integrated with an ad SDK of the app. ATOM monitors app usage patterns anonymously and enriches the ad requests with relevant cohorts at a time. The enriched ad requests can be targeted by an advertiser seamlessly, when a specific campaign includes the selected cohorts.

Why ATOM ?

So how does ATOM help you, as a developer? ATOM enables marketers to continue reaching the right audiences without compromising on privacy. ATOM also helps publishers and developers like you, monetise effectively in a privacy-safe way.

  • Reclaim Pre-IDFA eCPMs on anonymized users. Monetization with ATOM delivers higher eCPMs, compared to no-IDFA traffic.
  • Enrich bid-level signals for brand targeting. Ensure that 100% of your inventory and your users are addressable by advertisers, even without IDFA.
  • Match anonymous users to relevant cohorts. Further, learn which cohorts and ads drive your users. ATOM currently supports 10+ standard cohorts that are constantly updated frequently.
  • Above all, monetise effectively in a privacy-safe way. ATOM complies with the Apple ATT guidelines and delivers fully anonymous user engagement, requiring no PII (or personally identifiable information).

ATOM and GDPR

ATOM is designed to fully operate without any personal data and strictly adheres to GDPR requirements. By default, an integrated ATOM library does not require MAC-addresses, advertising IDs or any other identifier that can be used to identify the user. The data used for cohort calculations is purely executed on the device. The actual cohort data IDs that enrich bid requests are anonymous with no PII.
To update cohorts, ATOM sends anonymous app usage history to the Verve data center in EMEA. This data is aggregated across all ATOM users and does not include PII and it does not allow to fingerprint or trace back the user.

ATOM Cohorts and Taxonomy

By definition, a cohort is a group of people who have something in common. The ATOM SDK relies on the following anonymous signals to analyse and calculate on-device cohorts.

Device: Device OS, Manufacturer, Model, Timezone, Sensors.
App: Bundle ID / App ID, App starts, Session time, Dayparts.
Ad: Ad events, Clicks, Video started, Cohort affinity.

Behavior-based Cohorts

TargetingIDCategoryDescription
Tech Enthusiasts100002BehaviourA group of people that are excited about technology, new gadgets and software.
Active Gamer100003BehaviourA group of people that play the game of the app actively, more than 75% of the players.
Casual Gamer100004BehaviourA group of people that play the game of the app casually, similarly to most other players.
Impulsive100005BehaviourA group of people that use the app more often and shorter periods than an average app user.
Healthy lifestyle100006BehaviourA group of people that are into a healthy lifestyle and maintain a steady sleeping rhythm.
Employed100007BehaviourA group of people that are employed and uses the app mostly outside of work.
Loyalty100009BehaviourA group of people that frequently use the app.
Bored people100010BehaviourA group of people that have not much else to do than play the app.
Social interaction seekers100011BehaviourA group of people that interact with social media activities.
Information seekers100012BehaviourA group of people that actively look for news and other information throughout the day.
Sports fan100014BehaviourA group of people that follow sports every day.

Demographic-based Cohorts

TargetingIDCategoryDescription
Female100015DemographicWomen who engage with the app.
Male100014DemographicMen who engage with the app.
Age 18-24100012DemographicYoung adults whose app engagement is likely to mirror the vibrancy and evolving interests of this dynamic age group.
Age 24-45100011DemographicAdults whose app engagement is likely to mirror the vibrancy and evolving interests of this dynamic age group.
Age 45+100013DemographicMature adult adults whose app engagement is likely to mirror the vibrancy and evolving interests of this dynamic age group.

Mobility-based Cohorts

TargetingIDCategoryDescription
At Home100031MobilityUsers who engage with the app from their homes.
At Work100032MobilityUsers who engage with the app at work.
Not at Home100033MobilityUsers who use the app in other settings, outside of their home environments.
Not at Work100034MobilityUsers who use the app in other settings, outside of their work environments.

Attention-based Cohorts

TargetingIDCategoryDescription
High Attention100035AttentionThe ad consistently captures and holds the viewer’s attention.
Mid Attention100036AttentionThe ad attracts the viewer’s attention but may not maintain it fully.
Low Attention100037AttentionThe ad briefly draws the viewer’s attention, which fades quickly.
No Attention100038AttentionThe ad does not capture the viewer’s attention at any point.

ATOM Installation Guide


ATOM is compatible with HyBid SDK v2.18.1 and above.
Drag&Drop size: 37.3MB


Currently ATOM can be added into your project via:

  • Cocoapods
  • Drag & Drop

Cocoapods

📘

ATOM comes bundled together with the latest HyBid SDK v3.0 No further installation steps are required. Follow our publisher integration guide to get HyBid for your preferred mediation solution

Drag & Drop

Download a copy of ATOM, or clone its repository and make sure you check out the latest tagged version.

  • Embed the ATOM.xcframework project in your own project.
  • Add the ATOM target in the Target Dependencies section of the Build Phases tab of your application target.
  • Add the ATOM.xcframework to the Embedded Binaries section of the General** tab of your application target.

Usage

Currently ATOM is functioning only when HyBid is installed in your project as well. In this case you only need to install ATOM into your project with one of the above-provided methods. There is no need to add any code to your project to make ATOM run. It will automatically be initialized and run alongside with HyBid.

IMPORTANT

Both HyBid and ATOM has to be installed in the same way, via Cocoapods or Drag & Drop, to function as intended.