|
|
Getting Started Guide: MasterAccountService Overview
MasterAccountService provides operations for managing master accounts and for enrolling new customers with Yahoo! Search Marketing.
About Master Accounts
A master account is a collection of one or more accounts. A master account defines the currency, time zone, and market for all accounts under the master account.
Note: An initial master account, an account under that master account, and a user who assumes the role of master account administrator are created when customers enroll with Yahoo! Search Marketing.See Enrollment.
Note: The initial master account, and all subsequent master accounts that you create, are assigned to specific colocations. See the LocationService Overview.
Master Account Management
MasterAccountService provides operations for updating, reviewing, and checking the status of master accounts.
Update Master Accounts
To update a master account, use the updateMasterAccount operation.
Review Master Accounts
To get information about a master account, use the getMasterAccount operation. To determine whether a master account is Mobile Sponsored Search master account, use the isMobileMasterAccount operaion.
Master Account Status
To determine the status of a master account, use the getMasterAccountStatus operation.
Note: You cannot change the status of a master account using the Marketing API. A master account is enabled, status set to "Active" when it is created. To disable a master account, set status to "Inactive" contact your Technical Account Management team.
Tagging and Tracking
Tagging and tracking are enabled or disabled at the master account level. Contact your Technical Account Management team to learn more about these features.
Note: Tagging and tracking are not enabled on some of the Master Accounts inspite of it being set to "enabled". In this case you will see the default values for the attributes taggingOn and trackingOn, and not what you have set. However, if you still want to get the values that you have set for these attributes, use the getMasterAccount operation.
Tagging
Tagging allows you to embed special JavaScript tags onto specific pages on your web site which will send analytics data from your Sponsored Search and Content Match® traffic back to Yahoo! Search Marketing. This data is made available in the advanced and multichannel reports (see the BasicReportService Overview) and is used for campaign optimization (see the CampaignService Overview).
Two types of analytics are available:
- Conversion Only (Conversion Counter) - Tracks conversions and revenue and is available to all users.
- Full Analytics - Tracks visitor state and session information as well as conversions and revenue. Available only to certain users.
Note: Tagging is enabled or disabled through the web application only and not the Marketing API.
Tracking
Tracking allows you to obtain information about advertising click traffic using special parameters appended to the URL served with your ad that provides information about the search term, bidded keyword, and search tactic, match type - "standard", "advanced", or "content".
For example, suppose you have an ad with this URL http://mysite.com/item=123 and that the ad group includes two keywords, “ketchup" and “mustard". Someone reads an article about “picnic condiments" and Content Match® serves the “ketchup" ad through Yahoo! Publisher Network. When you receive the click, it will contain the string &ovmtc="content? appended to the URL.
Or, suppose someone searches for "tomato ketchup" on Yahoo! Search and your ad is served.
The tracking URL would look like this: http://mysite.com/item=123&ovraw=tomato%20ketchup&ovkey=ketchup&ovmtc=advanced.
You can then parse the string to extract the parameter values.
Tracking also includes support for Advanced Tracking URLs, which allow you to specify your own parameter names for the tracking URL values, for example: http://www.whatever.com/product?searchterm=%7bOVRAW%7d&biddedkeyword=%7bOVKE Y%7d&matchtype=%7bOVMTC%7d. In this case, your parameter named searchterm will contain the value for the raw keyword query, biddedkeyword will contain the value for the keyword you bid on, and matchtype will contain the value for the search tactic, match type - for Sponsored Search with the standard match type, Sponsored Search with the advanced match type, or Content Match®.