API Reporting

After creating an SSP or DSP, there are two (2) options available for sharing statistics with partners:

1. API Statistics:

Upon SSP or DSP creation, an API link is automatically generated. You can locate it by navigating to the DSP/SSP settings, specifically the Access to Statistics tab.  

The link template is as follows:

for SSP:

https://{{DOMAIN}}/api/StatApi/stat/ssp?client={{CLIENT_OID}}&apiKey={{KEY}}&DateFrom={{DATE_FROM}}&DateTo={{DATE_TO}}

for DSP:

https://{{DOMAIN}}/api/StatApi/stat/dsp?client={{CLIENT_OID}}&apiKey={{KEY}}&DateFrom={{DATE_FROM}}&DateTo={{DATE_TO}}

Where:

• DOMAIN: Your platform's domain (configured during the integration process).
• CLIENT_OID: Unique ID of your platform (generated automatically).
• KEY: Unique secret key used to secure the API connection (generated automatically).
• DATE_FROM / DATE_TO: Describes the date range of statistics to pull (should be modified by the partner).

For SSPs, you can enhance the granularity of the data retrieved, by including an optional &dimension=[int] parameter in your API query. This parameter allows you to specify additional dimensions for the statistics, providing more detailed insights:

    0 - Default structure with only the date dimension.
    1 - Endpoint: Breaks down statistics by the specific endpoints.
    2 - Country: Provides data segmented by country.
    3 - OS: Offers insights based on the operating system.
    4 - Publisher ID: Segments data by publisher ID.
    5 - TagID: Unique ID for the ad placement.

Additional Notes:

• The standard lifetime of the secret key is 180 days. To extend its validity, simply click the corresponding button on the same tab.
• Statistics are provided in XML format.
• The API will reject more than 1 request per 30 seconds.

2. Partner Dashboard

In addition to direct API links, partners can now view SSP and DSP statistics through the RTB-Stack partner dashboard by inviting users to a specific SSP or DSP entity. This offers a graphical interface for exploring metrics without having to pull XML feeds.

How It Works

User Invitation:

• Navigate to the “Access to Statistics” tab under the SSP or DSP settings.
• Click the “+ New User” button.
• Enter the partner’s email and name.
• An invitation email will be automatically sent. If the email is already tied to an existing user, the access will be linked to that account.  

User Access:

• Invited users can log in to the RTB-Stack dashboard using their credentials.
• Depending on the access granted, they will see the relevant SSP, DSP, or both types of reports.

Statistics View:

• Reports can be generated by selecting the appropriate report type (SSP/DSP).
• Available filters include date range, currency, and the ability to select dimensions, metrics, and additional filters.
• More information about configuring reports is available here: Report Types Guide. 

Managing User Access:

On the “Access to Statistics” you’ll see a list of all users linked to this SSP/DSP. For each user you can:

• Edit their display Name or Email by clicking the pencil icon.
• Unlink the user from this SSP/DSP (without deleting their account) via the unlink icon.
• Delete the user entry entirely by clicking the trash icon.