Reporting API Metrics and Dimensions

The Offer Wall Reporting API enables you to access all the reporting data from DT Offer Wall. You can query multiple metrics, such as revenue and impressions, across the available dimensions and implement filters. Metrics define what type of data you want to include in your report. Dimensions allow you to filter the data set based on specific values. Names of metrics and dimensions are case-sensitive. Currently, the sources available for the DT Offer Wall Reporting API are Performance or Event:

  • Performance-based view. Every action or revenue metric is attributed to the time of the click and impression. This view provides a clear understanding of how your settings impact performance. All related data is taken from the Performance View in the DT Offer Wall Report.
  • Event-based view (billing). Every action or revenue metric is attributed to the time it happened. This view allows a clear understanding of the periodical revenue conversions and other events as they happened. All related data is taken from the Billing View in DT Offer Wall Report. The data pulled from this view matches your monthly billed invoice.

DT Offer Wall Report Metrics

Metrics are the data types that you want to include in your report. You must include at least one of the following metrics in your report request.

The following table describes the supported metrics available in the DT Offer Wall Reporting API.

GROUP METRIC DESCRIPTION
Delivery Avg. Offers per Container Average offers are presented in the DT Offer Wall container and measured by impressions.
Formula: Sum(Offer Impressions) / Sum(OFW Container Impressions)
Avg. Position Average position the Offer received for each Container Impression.
Container Fill Rate Container Impressions with at least one offer to Container Impressions rate.
Formula: Container Impressions with at least one offer / Container Impressions
Offer Clicks Users that clicked the offer.
Offer Completion Time Average time to complete an offer.
Offer Conversions Amount of conversions generated from offers.
Offer Impressions Individual Offer Impressions count.
Offer Impressions per App Individual Offer Impression counts per app.
Offer Impressions per App Active Users Offer Impressions divided by Daily Active Users.
Formula: Offer Impressions / App Active users
OFW Impressions per OFW Engaged Users Offer impressions divided by Daily Engaged Users.
Formula: Offer Impressions / DEU
Offer Installs Individual Offer Installs count.
Offer Info Click Initial clicks of the offer, which opens the offer info window.
When using the DT Offer Wall API integration type, this will not be available.
Offer Ticket Count Number of reports per offer generated by users.
OFW Container Impressions DT Offer Wall container Impressions count.
OFW Impressions to Clicks Ratio Offer Impressions to Offer Clicks ratio.
OFW Impressions per OFW Engaged Users Offer impressions divided by Daily Engaged Users.
Formula: Offer Impressions / DEU
Offer Unique Users Number of unique users who opened DT Offer Wall.
Publisher App Unique Users Publisher app's unique active users.
This metric is accurate only when a publisher initializes our SDK on app start. When you split it by day, it shows the Daily Active Users.
Validation Response  
Engagement Container CTR Offers clicks to container impressions rate. Publisher's metric.
Formula: Offer click / Container impression
Conversions / Click Rate Offer conversions to offer clicks ratio.
Offer Clicks Clicks that take the user to the app store/landing page.
When using the mobile-wall integration type, this will represent the click after the info window is displayed.
Offer Completion Time Average time to complete an offer.
Formula: Sum(Time to Convert) / Sum(Conversions)
Offer Conversions Offers clicks (that forward user to task landing page) to impressions rate.
Offer CTR Offers clicks (that forward user to task landing page) to impressions rate.
Formula: Offer click / Offer impression
Offer Info Click Initial clicks of the offer, which opens the offer info window.
When using the DT Offer Wall API integration type, this will not be available.
Offer Info CTR The ratio of Offer clicks to the total Offer Impressions.
Formula: Offer Info Click / Offer Impression.
Offer Installs Number of Individual Offer Installs.
Offer Ticket Count The number of reports per offer, generated by users.
OFW Engagement Rate DT Offer Wall's daily engaged users divided by the publisher app's daily active users.
Formula: OFW unique users / DAU × 100
Revenue Publisher ARPDAU Publisher's average revenue per daily active users.
This metric is accurate only when a publisher initializes our SDK on app start.
Publisher ARPDEU Publisher's average revenue per daily engaged user.
Publisher ARPU Publisher's average revenue per user.
Publisher Conversions Amount of conversions generated.
Publisher eCPA Publisher's revenue measures per Publisher's payout.
Formula: Sum(Publisher Revenue) / Sum(Payout)
Publisher Net eCPA Publisher's net revenue measures per Publisher's payout.
Formula: Sum(Publisher Revenue) / Sum(Payout)
Publisher Net eCPM Net effective cost per mille.
Publisher Offer eCPM Publisher's revenue per thousand Offer Impressions.
Formula: Sum(Publisher Revenue) / Sum(Offer Impressions)
Publisher Revenue Total Publisher's payout received from DT.
Formula: Sum(Publisher Payout)

Filters

You can set and include a filter on any value(s) within a dimension. This means all the data presented in the report relates only to the values defined in the filter.

For example:
Dimension = Country
Filtered Value = US or CA

As a result of these filters, the report will contain data relevant to the Unites States and Canada.

DT Offer Wall Report Dimensions

The following table describes the dimensions you can specify for your DT Offer Wall Report.

GROUP DIMENSION DESCRIPTION
Date Date Date Range Specification for the report:
  • Specify the start and end date in ISO 8601 format. For example, 2019-10-03.
  • The interval between the start and end date should not exceed 90 days.
  • The start date must be earlier than or equal to the end date.
  • The start date must be within the previous 18 months.
  • The end date cannot be a date beyond the current date.
  • The time zone is UTC, and the start and end dates are from midnight to midnight.
Delivery Offer Actual Position The actual displayed position of the Offer in the container when it was presented.
Demand Affiliate Network Name Legacy offer aggregators.
Campaign ID Unique identifier for the campaign or offer ID (as defined in the DT system).
Campaign Name Unique identifier for the campaign or offer name (as defined in the DT system).
Campaign Title Unique identifier for the campaign or offer title (as defined in the DT system).
Campaign Type [CPI / CPE / CPL (also includes survey) / CPS (Sales)]
Demand ID Unique identifier for the demand or advertiser ID (as defined in the DT system).
Demand Name Unique identifier for the demand or advertiser name (as defined in the DT system).
Dynamic Payout Enabled [Yes / No]
Offer Actual Position The actual displayed position of the Offer in the container when it was presented.
Offer Completion Range

Options include:

  • up to 1 minute
  • 1–5 minutes
  • 5–20 minutes
  • 20 minutes to 1 hour
  • 1–3 hours
  • 3–10 hours
  • 10–24 hours
  • 1–3 days
  • 3–7 days
  • 7–14 days
  • 14 days or more
Offer Task Type Options include:
  • Video View
  • Download / App Install
  • Survey Completion
  • Social Media Engagement Registration
  • Lead Generation
  • Mobile Subscription
  • Purchase / Payment Required
  • Free Trial
  • In-App Action.
Publisher App Category Publisher's app category information. Options may include sports, lifestyle, social, etc.
Program ID Unique identifier for the advertiser's app identifier (as defined in the DT system).
Program Name Unique identifier for the advertiser's app name (as defined in the DT system).
Device Device Manufacturer Device manufacturer of the device on which the impression was served.
Device OS Device OS of the device on which the impression was served (Android / iOS).
Device OS Version Device OS version on which the impression was served.
SDK Version The SDK version which is running on the device in which the impression was served.
Engagement Offer Completion Range

Options include:

  • up to 1 minute
  • 1–5 minutes
  • 5–20 minutes
  • 20 minutes to 1 hour
  • 1–3 hours
  • 3–10 hours
  • 10–24 hours
  • 1–3 days
  • 3–7 days
  • 7–14 days
  • 14 days or more
Inventory App Store Name The Publisher's app name as it appears in the app store.
City The city in which the impression was served.
Country The country in which the impression was served.
DT Publisher App ID Publisher's app identifier as defined in the DT system.
DT Publisher App Name Publisher's app name as defined in the DT system.
Integration Type API / Mobile integration.
Publisher Account Name Publisher's account name as defined in the DT system.
Publisher App Bundle Bundle ID from the app store.
Publisher App Store Category Publisher's app category information from the app store. Options may include sports, lifestyle, social…
Publisher ID Publisher's ID as defined in the DT system.
System Conversion Type Organic or Customer Support Generated.

 

Back to Top ⇧