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)

Delivery - Avg. Position

Average position the Offer received for each Container Impression.

Delivery - Container Fill Rate

Container Impressions with at least one offer to Container Impressions rate. Formula: Container Impressions with at least one offer / Container Impressions

Delivery - Offer Clicks

Users that clicked the offer.

Delivery - Offer Completion Time

Average time to complete an offer.

Delivery - Offer Conversions

Amount of conversions generated from offers.

Delivery - Offer Impressions

Individual Offer Impressions count.

Delivery - Offer Impressions per App

Individual Offer Impression counts per app.

Delivery - Offer Impressions per App Active Users

Offer Impressions divided by Daily Active Users. Formula: Offer Impressions / App Active users

Delivery - OFW Impressions per OFW Engaged Users

Offer impressions divided by Daily Engaged Users. Formula: Offer Impressions / DEU

Delivery - Offer Installs

Individual Offer Installs count.

Delivery - 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.

Delivery - Offer Ticket Count

Number of reports per offer generated by users.

Delivery - OFW Container Impressions

DT Offer Wall container Impressions count.

Delivery - OFW Impressions to Clicks Ratio

Offer Impressions to Offer Clicks ratio.

Delivery - OFW Impressions per OFW Engaged Users

Offer impressions divided by Daily Engaged Users. Formula: Offer Impressions / DEU

Delivery - Offer Unique Users

Number of unique users who opened DT Offer Wall.

Delivery - 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.

Delivery - Validation Response

Engagement - Container CTR

Offers clicks to container impressions rate. Publisher's metric. Formula: Offer click / Container impression

Engagement - Conversions / Clicks Rate

Offer conversions to offer clicks ratio.

Engagement - 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.

Engagement - Offer Completion Time

Average time to complete an offer. Formula: Sum(Time to Convert) / Sum(Conversions)

Engagement - Offer Conversions

Offers clicks (that forward user to task landing page) to impressions rate.

Engagement - Offer CTR

Offers clicks (that forward user to task landing page) to impressions rate. Formula: Offer click / Offer impression

Engagement - 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.

Engagement - Offer Info CTR

The ratio of Offer clicks to the total Offer Impressions. Formula: Offer Info Click / Offer Impression.

Engagement - Offer Installs

Number of Individual Offer Installs.

Engagement - Offer Ticket Count

The number of reports per offer, generated by users.

Engagement - 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.

Revenue - Publisher ARPDEU

Publisher's average revenue per daily engaged user.

Revenue - Publisher ARPU

Publisher's average revenue per user.

Revenue - Publisher Conversions

Amount of conversions generated.

Revenue - Publisher eCPA

Publisher's revenue measures per Publisher's payout. Formula: Sum(Publisher Revenue) / Sum(Payout)

Revenue - Publisher Net eCPA

Publisher's net revenue measures per Publisher's payout. Formula: Sum(Publisher Revenue) / Sum(Payout)

Revenue - Publisher Net eCPM

Net effective cost per mille.

Revenue - Publisher Offer eCPM

Publisher's revenue per thousand Offer Impressions. Formula: Sum(Publisher Revenue) / Sum(Offer Impressions)

Revenue - 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 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.

Demand - Campaign ID

Unique identifier for the campaign or offer ID (as defined in the DT system).

Demand - Campaign Name

Unique identifier for the campaign or offer name (as defined in the DT system).

Demand - Campaign Title

Unique identifier for the campaign or offer title (as defined in the DT system).

Demand - Campaign Type

[CPI / CPE / CPL (also includes survey) / CPS (Sales)]

Demand - Demand ID

Unique identifier for the demand or advertiser ID (as defined in the DT system).

Demand - Demand Name

Unique identifier for the demand or advertiser name (as defined in the DT system).

Demand - Dynamic Payout Enabled

[Yes / No]

Demand - Offer Actual Position

The actual displayed position of the Offer in the container when it was presented.

Demand - 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

Demand - 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.

Demand - Publisher App Category

Publisher's app category information. Options may include sports, lifestyle, social, etc.

Demand - Program ID

Unique identifier for the advertiser's app identifier (as defined in the DT system).

Demand - 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 - Device OS

Device OS of the device on which the impression was served (Android / iOS).

Device - Device OS Version

Device OS version on which the impression was served.

Device - 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.

Inventory - City

The city in which the impression was served.

Inventory - Country

The country in which the impression was served.

Inventory - Fyber Publisher App ID

Publisher's app identifier as defined in the DT system.

Inventory - Fyber Publisher App Name

Publisher's app name as defined in the DT system.

Inventory - Integration Type

API / Mobile integration.

Inventory - Publisher Account Name

Publisher's account name as defined in the DT system.

Inventory - Publisher App Bundle

Bundle ID from the app store.

Inventory - Publisher App Store Category

Publisher's app category information from the app store. Options may include sports, lifestyle, social…

Inventory - Publisher ID

Publisher's ID as defined in the DT system.

System - Conversion Type

Organic or Customer Support Generated.

Last updated