2024-05 Adjust API upgrade
The Adjust API sunset on March 27th, 2024, occurred without prior notification. However, Data Integration responded by implementing an updated API datasource, making essential user interface changes.
Details of changes
- Deprecated the KPI Service and migrated to the Report Service.
- Updated API authentication from Basic to Bearer Authorization.
- Changed reports endpoint from CSV KPI to CSV Reports endpoint.
- Added new metrics and dimensions, deprecated some, and changed the names of existing dimensions.
- Updated required fields: Dimensions (Grouping), Metrics (KPIs), and App Token are now required.
Cohort report
Deprecated configurations
| Configuration Name | Deprecated Fields | Changed Fields (From → To) | New Fields |
|---|
| Dimensions (Grouping) | date | campaigns → campaign | app_token |
| tracker | adgroups → adgroup | |
| event | creatives → creative | |
| | countries → country | |
| Configuration Name | Deprecated Fields |
|---|
| Metrics (KPIs) | conversion_per_active_user |
| converted_user_size |
| events_per_converted_user |
| conversion_per_user |
| events |
| events_per_active_user |
| conversion_distribution |
| converted_users |
| events_per_user |
Overview report
Deprecated configurations
- The Dimensions list was updated.
- Deprecated configurations related to Events Tokens, Events KPIs, and Base Impressions.
| Configuration Name | Deprecated Fields | Changed Fields (From → To) | New Fields |
|---|
| Dimensions (Grouping) | date | campaigns → campaign | app_token |
| tracker | adgroups → adgroup | |
| event | creatives → creative | |
| | countries → country | |
Events report
- The Metrics and Dimensions lists were updated.
- Deprecated configurations related to Events Tokens and Base Impressions.
Deprecated configurations
| Configuration Name | Deprecated Fields | Changed Fields (From → To) | New Fields |
|---|
| Dimensions (Grouping) | date | campaigns → campaign | app_token |
| tracker | adgroups → adgroup | |
| event | creatives → creative | |
| | countries → country | |
| Configuration Name | Deprecated Fields |
|---|
| Metrics (KPIs) | conversion_per_active_user |
| first_events |
| revenue_per_event |
| revenue_per_revenue_event |
SKAdNetwork report
The Dimensions list was updated.
Deprecated configurations
| Configuration Name | Deprecated Fields | Changed Fields (From → To) | New Fields |
|---|
| Dimensions (Grouping) | networks | partners → partner | app_token |
| source_apps | apps → app | |
| redownload | campaigns → campaign | |
| | countries → country | |
What actions should you take?
- Redo the mapping process. If the "Upsert-Merge" mode encounters difficulties, switch to the overwrite mode at least once to ensure successful execution, as various changes in metrics and dimensions might cause issues.
- Currently, "App Token" is considered a dimension. If it's not selected as such, the API won't return data related to "App Token."
- Many users use the combination of "Date" and "App Token" keys for upsert-merge mode. However, Adjust has removed the "Date" dimension. Therefore, tables using upsert-merge with these keys will need to be overwritten. Adjust only removed "Date" but retained "hour," "day," "week," and "month" dimensions.
- Double-check the "App Token"s for the Rivers. They might be refreshed by Adjust and require updating.
