Skip to main content

​
Intro

Centro (formerly called SiteScout) is the first and largest self-serve advertising platform for buying online banner ad space (in real time) across the web and on mobile devices. They help advertisers and agencies streamline the digital media buying process. For more information about the Centro API, visit their website (https://www.centro.net/products/dsp-…ic-advertising). The Centro connector is a “Cloud App” connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking Cloud App in the toolbar at the top of the window. You connect to your Centro account in the Data Center. This topic discusses the fields and menus that are specific to the Centro connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Connector.

​
Prerequisites

To connect to your Centro account, you must have the following:
  • A Centro client ID, and
  • A Centro client secret.
For information about obtaining these credentials, please visit http://www.Centro.com/blog/2013/0…Centro-api/.
Note: The authentication and authorization processes are performed in accordance with the OAuth 2 specification. At this time Centro only supports the Client Credentials grant type. This grant type is ideal for API clients that require access to their own resources (as opposed to the client acting as a third party and requesting access on behalf of another user). One of the key advantages of this grant type is a simplified authentication flow that allows the client to proceed directly to token generation with the authorization grant being assumed. It must be noted that the Client Credentials grant type must exclusively be implemented with applications that guarantee the security of their client credentials.

​
Connecting to Your Centro Account

This section enumerates the options in the Credentials and Details panes in the Centro Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Connector.

​
Credentials Pane

This pane contains fields for entering credentials to connect to your Centro account. The following table describes what is needed for each field:

Field

Description

Centro Client ID

Enter your Centro Client ID.

Centro Client Secret

Enter your Centro Client Secret.

Once you have entered valid Centro credentials, you can use the same account any time you go to create a new Centro DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Manage Connector Accounts.

​
Details Pane

This pane contains a primary Report menu in which you select a report type.

Menu

Description

Report

Select a Centro report. The following reports are available:

Report Name

Description

All Brand Stats

Returns statistics for all brands such as clicks, conversions, and impressions won.

All Group Stats

Returns statistics for a specific brand for all groups.

Audience Rules

Returns audience targeting rules for the selected campaigns.

Audiences Stats

Returns statistics for the specific audience such as total visitors and new visitors.

Campaign

Returns data about campaigns for a given time frame, such as campaign name, budget amount, number of clicks, etc.

Campaign, per Creative

Returns creative data for campaigns for a given time frame, such as creative name, number of clicks, revenue amount, etc.

Campaign, per Creative (with Partition)

Returns the campaign statistics per creative. This report supports partition when granularity is ’ DAILY ’.

Campaign, per Offer

Returns offer data for campaigns for a given time frame, such as number of clicks, number of conversions, revenue, etc.

Campaign Statistics By App/Domain

Retrieves the Campaign Statistics by App or Domain.

Contextual Details

Returns contextual targeting data.

Demographic Details

Returns demographic targeting data.

Device Report

Returns data for a given device.

Geographic Coordinates

Returns latitude/longitude rules.

Geographic Rules

Returns geographic targeting rules.

Group Campaign Stats

Returns statistics for campaigns in the group.

Listing Domain Rules

Returns a campaign’s current domain targeting.

Page Position

Returns page position targeting data.

Reports

Returns custom reports.

Targeting Devices

Returns the current device’s target settings for the campaign.

Custom Report

Select the Centro CSV report you want to import into Domo.

Report Type

Select the desired report type for your “Device Report.”

Advertiser ID

Enter the advertiser ID you want to return data for.

Campaign

Select the campaign you want to return data for.

Campaign Selection

Specify whether you want to pull data for all campaigns or a specific campaign.

Audience

Select all audiences you want to return data for.

Folders

Select the campaign folder you want to return data for.

Brand

Select the brand you want to return data for.

Campaign Group

Select the campaign group you want to return data for.

Site Reference

Enter the URL for the website you want to return data for.

Creative ID

Enter the ID of the creative you want to return data for.

Campaign Status

Select a campaign status to filter your report data by.

Filter (Optional)

Enter a keyword to filter campaign names by in your “All Campaigns” report.

Granularity

Select the date grain for your data. For the “Campaign per Creative” report, if you select Daily here, one API call will be made per day per campaign.

Backfill Days for Historical Data

Enter the number of past days you want to retrieve historical data for. This will only occur the first time you run the report.

Aggregate By

Select whether to aggregate data by day or hour, or not at all.

Dimensions (Optional)

Enter a value to filter creative dimensions by, expressed as width x height (e.g. 300 x 250 ).

Duration

Select whether you want to pull data for a specific date or a date range.

Report Date

Select whether the report data is for a specific date or for a relative number of days back from today.

Select Specific Date

Select the date for the report.

Days Back

Enter the number of past days that should appear in the report.

Start Date

Specify whether the first date in your date range is a specific or relative date. You select the last date in your range in End Date .

End Date

Specify whether the second date in your date range is a specific or relative date. You select the first date in your range in Start Date .

Select Specific Start Date

Select the first date in your date range.

Select Specific End Date

Select the second date in your date range.

Days Back to Start From

Enter the number of the farthest day back that should be represented in the report. Combine with Days Back to End At to create a range of represented days.

For example, if you entered 10 for Days Back to Start From and 5 for Days Back to End At , the report would contain data for 10 days ago up until 5 days ago.

Days Back to End At

Enter the number of the most recent day back that should be represented in the report. Combine with Days Back to Start From to create a range of represented days.

For example, if you entered 10 for Days Back to Start From and 5 for Days Back to End At , the report would contain data for 10 days ago up until 5 days ago.

​
Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Connector.

​
FAQs

Yes.
As often as needed.
No.