CPC (Cost per Click) Sources (Urchin 6.5+)

CPC (Cost per Click) Sources (Urchin 6.5+)

Urchin 6.5 features a new type of data source: Cost Per Click (CPC) Source. Somewhat similar to log sources, CPC Sources enable automatic extraction of CPC Campaign Data from external sources. Linked with existing profiles like Log Sources and Filters, CPC sources enable automatic inclusion of CPC Data into Urchin reports. CPC Sources may be created for Google AdWords (Urchin 6.5+) and Yahoo! Search Marketing (Urchin 6.6+).

Note: Due to AdWords Starter Edition limitations, CPC Sources will not work for AdWords Starter Edition accounts. To use CPC Sources, you'll need to upgrade to the AdWords Standard Edition.

Important Note regarding 6.500 to 6.501 upgrades: When upgrading from 6.500 to 6.501, you must manually delete your old CPC data. To do this, delete all contents of the following directories:

 

<path_to_urchin_6500_installation>/data/cpc/...
<path_to_urchin_6500_installation>/data/history/cpc/...

CPC Source Manager

The CPC Source Manager section can be found in the Configuration > Urchin Profiles section (Urchin 6.5 +).

The CPC Source Manager displays a list of Cost Per Click (CPC) Sources that have been configured on the current Urchin instance and contains UI controls that enable an Administrator to create and modify CPC Sources.

Creating a New CPC Source

To add and configure new CPC Source click the Add button at the top-right of the CPC Source Manager.

This launches the "Add CPC Source Wizard" which will walk you through the steps of adding/configuring a CPC Source.

On the first Wizard step, fill in the following data:

- Optional Account - specify which Account newly added CPC Source will be linked to (Data Center Mode only).

- CPC Source Name – name of CPC Source;

- CPC Source Type:

• Google AdWords

  • Email* - login e-mail of an AdWords Account being accessed or an My Client Center (MCC) account login;

  • Password* – password of the login account;

  • Developer Token – This is the unique string that identifies an authorized developer of the AdWords API (optional). Urchin comes with a default Developer Token, therefore unless you have an intention to use your own Developer Token you leave this field blank.

  • Application Token -This is the Application Token that will be used when accessing the AdWords API. As with the Developer Token, you can leave this field blank.

  • Client E-mail – In case of MCC login (Email is a login of an MCC account), contains the login e-mail of the client account being accessed.

  • Customer ID – In case of MCC login, a Customer ID of an AdWords account being accessed (a number such as 123-456-7890 seen at the top-right corner of the screen in Google AdWords) . This element can be provided instead of Client E-mail.

You can validate your CPC Source settings by pressing the "Test CPC Source" button.

• Yahoo! Search Marketing

  • Username* - This is the username for the YSM account being accessed. It can be the advertiser's email address or the email address of the agency accessing the report on behalf of the advertiser;
  • Password* – This is the password for the YSM account being accessed;
  • Master Account ID* – This is the advertiser's master account ID;
  • Account ID* - This is the advertiser's account ID;
  • License Key - This is the license key for the user that is logging-in, the advertiser or the agency;
  • On-Behalf-of Username - This is the advertiser's on-behalf-of username. It is only required if the agency username was provided instead of the advertiser username (optional);
  • On-Behalf-of Password - This is the advertiser's on-behalf-of password (optional).

Click 'Finish' button to complete the procedure.

Editing the CPC Source

Once the CPC Source has been added, you can modify its settings, delete or schedule it for download.

To edit the existing CPC Source settings, click the 'Edit' button near the desired CPC Source.

You can modify the login settings for an AdWords or YSM account as well as enable or disable the future downloads of this CPC Source. NOTE: Even if you select to disable future report downloads, the profiles linked with this CPC Source will keep using already downloaded reports.

On the 'Profiles' tab, you can link your CPC Source to one or more existing profiles. The list of profiles available for linking is limited to the current Urchin account. The CPC data from the linked CPC Sources will appear in these profiles' reports.

Scheduling the CPC Source

On the Schedule tab of the Edit CPC Source screen, you’ll be able to define your CPC Source Download settings:

• - Schedule – Download Interval – CPC Download is split into two distinct stages. In first stage, the CPC credentials are validated and the report request is made to the CPC server. In the second stage, report availability is checked periodically until it becomes available. The second stage ends with the actual download of the report. It takes some time before a report becomes available on the server, depending upon the number of campaigns in the account, the amount of data retrieved, the current load of the servers, etc. This interval determines when Urchin starts checking the availability of report after it has been requested. The general suggestion here is to set this interval to higher values for very large accounts that have a large amount of click traffic.

  - Download - Hour of the Day – here you can configure the time of the day when the updated report for this CPC Source should be downloaded. IMPORTANT: Since CPC data is extracted on a daily (and not hourly) schedule, we highly recommend that you allow at least 2 hours after the full day is complete in your AdWords or YSM account timezone before downloading. This will ensure that all CPC data for the day is available on AdWords and YSM servers. It's best to schedule profiles with CPC Sources so that they process after the CPC data has been downloaded. This way, you'll get the latest CPC data in your reports.

  - Account Data - Download Interval (only for AdWords in Urchin 6.6+) - use this option to set the Download Interval for the AdWords account structure download. The AdWords Account structure must be downloaded before you can view Campaign and Keyword metadata or use the Keyword Generator, Copy Campaign, and AdWords Tag Manager tools.

On the CPC Source Update tab of Global Settings screen, you can define default global CPC Source Download settings.