LogoLogo
My AppsLive demoNewsArticles
  • Introduction
  • 📌Product updates: 2025
    • 2024
    • 2023
  • Getting Started
    • Registration
    • Adding a space
    • Adding an app to the space
  • Basic Events & Custom Events
  • Integration
    • Expert Tips
      • What to track
      • Payments & Anti-cheat
      • Check your integration
    • Integration of SDK 2.0+
      • SDK Integration
        • Android
        • iOS
        • macOS
        • Windows
        • Web
          • Web SDK Integration
          • Web SDK Releases
        • Unity
        • Unreal Engine
        • Godot Engine
      • Automatic payment tracking
        • App Store
        • Google Play
      • Setting up Events
        • Basic methods
        • Secondary methods
        • User profile
        • Anticheat methods
        • Track sessions
      • Push notifications
        • Android
        • iOS
        • Windows (UWP)
        • Unity
          • Android
          • iOS
          • Windows (UWP/WSA)
        • Unreal Engine
      • A/B testing
        • Description of A/B testing on the SDK side
        • Working with A/B tests in the devtodev interface
        • A/B testing examples
    • Integration of SDK 1.0+ (deprecated)
      • SDK Integration
        • iOS
        • Android
        • Windows 8.1 and 10
        • Web
        • Unity
        • Mac OS
        • Adobe Air
        • UE4
      • Setting up Events
        • Basic methods
        • Secondary methods
        • User profile
        • Anti-cheat Methods
      • Push Notifications
        • IOS
        • Android
        • Windows 8.1 and Windows 10
        • Unity
        • Abode Air
        • UE4
    • Test Devices
    • Server API
      • Data API 2.0
      • Subscription API
      • Push API
        • IOS
        • Android
        • Windows UWP
        • Windows
      • Raw Export
      • Labels API
      • Data API
    • Import historical data via API
    • Data Export
      • Data Export to Cloud Storage (BigQuery / Amazon S3)
  • 3rd Party Sources
    • Attribution Trackers
      • AppsFlyer
      • Adjust
      • Branch.io
      • Kochava
      • Tenjin
      • Tune (MAT)
      • Singular
      • Custom postback API
      • Facebook Ads referral decryption
    • App Marketplace Data
      • App Store Connect Stats
      • App Store Subscriptions
      • Google Play Console Stats
      • Google Play Subscriptions
      • AppGallery Connect Stats
    • Ad revenue
      • AdColony
      • AdMob
      • Facebook
      • MoPub
      • Unity Ads
      • Vungle
      • Ad revenue API
    • Cohort export
  • Reports and Functionality
    • Space-related Reports and Functionality
      • Overview
      • Custom dashboards & Reports
      • SQL
        • SQL tips
        • SQL Query examples
      • Audience overlap
    • Project-related Reports and Functionality
      • Overview
        • Real-Time Dashboard
        • Acquisition reports
        • Engagement reports
        • Monetization reports
        • In-game analysis reports
        • Cohort analysis
      • Reports
      • Push Notifications
        • Android Notifications
        • IOS Notifications
        • Windows Notifications
        • Button Templates
      • Predictions
      • Users & Segments
      • Filters
      • A/B Testing
      • Tuning
      • Settings
  • Metrics and Glossary
    • Ad networks metrics
    • Market Metrics
    • Prediction Metrics
    • SDK Metrics
    • Subscription metrics
  • Space Management
  • User Profile Management
  • Limits
  • Scenarios and Best Practices
    • Analytics use cases
    • Match-3
    • MMORPG Games
    • Hyper-Casual games
    • Social Casino
    • RPG games
    • Farming games
    • Non-gaming app
    • Acquisition Example
  • FAQ
    • Identification
    • Raw Data
    • All about data discrepancies
  • Slack
Powered by GitBook
On this page
  • Path:
  • List of fields

Was this helpful?

Export as PDF
  1. 3rd Party Sources
  2. Ad revenue

Ad revenue API

We created a special Ad revenue API endpoint to allow our customers to send information about revenue earned by ads displayed in their apps.

Do not apply this API if you use ad networks that utilize the server-server protocol for sending ad revenue data (ironSource, AppLovin MAX, and Fyber networks) and you already set up this method of data collection because if you use both data sources, your revenue data may be duplicated.

You need your project's API Key which can be obtained by going to 'Settings -> SDK -> Integration' section in the Application menu.

Path:

https://api.devtodev.com/track/impression/?apikey={API_KEY}

List of fields

Name
Required
Type
Description

timestamp

true

Long

Ad display date, Unix timestamp in milliseconds

ad_network

true

String

Name of the ad network serving the impression

placement

false

String

Banner ad placement

ad_unit

false

String

Banner ad name

advertisingid

if devtodevid is missing

String

User Advertising ID

devtodevid

if advertisingid is missing

Long

User devtodev id if known

country

false

String

Country code, (ISO 3166 alpha 2)

revenue

true

Double

Reward for displaying the banner ad (in USD). The amount is shown for all impressions specified in the impressions field

impressions

false

Long

Number of impressions (for pre-aggregated data)

Example:

{
    "timestamp": 1237651332,
    "ad_network": "Facebook",
    "placement": "End of the round",
    "ad_unit": "TestAdUnit",
    "revenue": 0.3434,
    "impressions": 1,
    "advertisingid": "abcdef12-1234-1234-1234-12345678abcd",
    "counrty":"US"
}jso

Valid query options:

  1. POST:

POST https://api.devtodev.com/track/impression/?apikey={devtodev_api_key}  
{
    "timestamp": 1237651332,
    "ad_network": "Facebook",
    "placement": "End of the round",
    "ad_unit": "TestAdUnit",
    "revenue": 0.3434,
    "advertisingid": "abcdef12-1234-1234-1234-12345678abcd",
    "devtodevid": "123456"
}

2. POST:

POST https://api.devtodev.com/track/impression/?apikey={devtodev_api_key}  
[{
    "timestamp": 1237651332,
    "ad_network": "Facebook",
    "placement": "End of the round",
    "ad_unit": "TestAdUnit",
    "revenue": 0.3434,
    "advertisingid": "abcdef12-1234-1234-1234-12345678abcd"
},
{  
  ...
},
...
]
PreviousVungleNextCohort export

Last updated 5 days ago

Was this helpful?