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:
|
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:
|
|
Offer Task Type | Options include:
|
|
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:
|
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. |