Saltar al contenido principal

Domo University Videos

Domo

Centro Connector

Important: When referencing this page outside of Knowledge Base, use this link: http://knowledge.domo.com?cid=sitescout

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

Note: The user interface for building this connector is not yet available in our Connectors listing in the Data Center, meaning you will not be able to configure the connector on your own. However, we at Domo are more than happy to configure the connector for you so you can begin using it to pull your data into Domo. Please don't hesitate to reach out to your CSM or Domo Support. For contact information, see Getting Help.

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 Data 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 Data 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 Managing User Accounts for Connectors.

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:

All Ad Exchanges

Returns a list of ad exchanges.

All Campaigns

Returns a list of campaigns. 

All Providers

Returns the name and ID for all providers.

Campaign

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

Campaign, per Site

Returns site data for campaigns for a given time frame, such as site name, URL, number of clicks, revenue amount, 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 Offer

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

Campaign, for a Particular Site

Returns campaign data for a specified site for a given time frame, such as number of clicks, video completion rate, etc.

Campaign, for a Particular Site, per Placement

Returns campaign data for a specified site for a given time frame broken down by placement, such as number of clicks, video completion rate, etc.

Campaign, for a Particular Site, per Creative

Returns campaign data for a specified site for a given time frame broken down by creative, such as number of clicks, video completion rate, etc.

Campaign, for a Particular Creative

Returns campaign data for a specified creative for a given time frame, such as number of clicks, video completion rate, etc.

Provider's Demographics

Returns demographic data for data providers, such as name, price, description, etc.

Provider's Contextual Entries

Returns contextual entry data for data providers, including parent ID, external ID, and contextual ID.

 

From Date 

Enter the start date of the statistics collection you want to retrieve.

To Date

Enter the end date of the statistics collection you want to retrieve.

Time Zone

Enter the time zone to serve statistics in, expressed as either a UTC offset (+-HH:mm) or time zone name (e.g. CET). If you do not provide a time zone, it defaults to EST.

Status

Indicates whether only campaigns with a specified status should be returned. Accepted values are online, offline, and archived.

CampaignIDs

Enter a comma-separated list of campaign IDs to retrieve statistics for. If provided, Filter and Status parameters are ignored.

Filter

For the "All Campaigns" report, enter a value to filter campaign names. For the "Campaign, per Site" report, enter a value to filter domains and site references.  

Aggregate Statistics By

Specify whether statistics are aggregated by day or hour. If not provided, this defaults to none (in which case statistics are aggregated over the provided date range).

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 Data Connector.