The Account object represents an account, a business or department that controls a marketing budget. An account is a collection of campaigns and is associated with a master account. Values set at the account level override corresponding values set at the master account level and apply to all campaigns in the account.
Before you attempt to set the sponsoredSearchON, advancedMatchON, and contentMatchON elements, read Setting Tactics.
A note about the tax code elements (hasFiscalCode, fiscalCode, hasNifCif, nifCif,
hasVatRegistrationNumber, vatRegistrationNumber):
These elements are
set using the AccountService addAccount operation. However, these elements
cannot be viewed or updated using AccountService getAccount, getAccounts,
or updateAccount operations. To view or update these elements, or if you
have other questions about these elements, please contact your Account
Management Team.
| Restrictions * | Element | Data Type | Description | Add | Full-Up | Part-Up |
|---|---|---|---|---|---|
| advancedMatch ON |
boolean | If true, Sponsored Search (advanced match type) is enabled. If you enable advancedMatchON you must also enable sponsoredSearchON. | Opt | Req | Opt |
| businessItem | string | The business item. Used by the KR market only. | Opt | Opt | Opt |
| businessType Code |
string | The business type code. Used by the KR market only. | Opt | Opt | Opt |
| contentMatch ON |
boolean | If true, Content Match® is enabled. | Opt | Req | Opt |
| displayURL | string | The display URL for the account, which appears with other account information in the web application. | Req | Req | Opt |
| fiscalCode | string | The Fiscal tax code. Required by the IT market if hasFiscalCode set to true. | Opt | Opt | Opt |
| hasFiscalCode | boolean | Indicates if the Fiscal tax code is available. Required by the IT market (must set to true or false). | Opt | Opt | Opt |
| hasNifCif | boolean | Indicates if the NifCif tax code is available. Required by the ES market (must set to true or false). | Opt | Opt | Opt |
| hasVatRegistration Number |
boolean | Indicates if the VAT registration number is available. If set to true, EU markets must supply the vatRegistrationNumber. | Opt | Opt | Opt |
| ID | string | The account ID. The ID is automatically assigned by the system when the account is created and cannot be changed. | RO | Req | Req |
| marketID | string | The two-character market ID code for the master account
(see Market IDs).
Currently, the market ID is the same for all accounts under a given master account. To determine which market ID to use, use the AccountService and the getAccount operation to look up the market ID for other accounts under the master account (specified by MasterAccountID). |
Req | RO | RO |
| masterAccount ID |
string | The master account ID the account is associated with. | RO | RO | RO |
| name | string | The account name. | Req | Req | Opt |
| nameFurigana | string | The account name in Furigana. Used by the JP market only. | Opt | Opt | Opt |
| nifCif | string | The NifCif tax code. Required by the ES market if hasNifCif set to true. | Opt | Opt | Opt |
| personalID | string | The user's PIN number. Used by the BR, KR, and TW markets. | Opt | Opt | Opt |
| presidentName | string | The president name of the company. Used by the KR market only. | Opt | Opt | Opt |
| sitePassword | string | The customer-supplied password that is used by Yahoo! staff to review the content of password-protected web sites. | Opt | Opt | Opt |
| siteUserName | string | The customer-supplied username that is used by Yahoo! staff to review the content of password-protected web sites. | Opt | Opt | Opt |
| sponsoredSearch ON |
boolean | If true, Sponsored Search (standard match type) is enabled. | Opt | Req | Opt |
| vatRegistration Number |
string | The value added tax (VAT) registration number. Required by the EU markets if hasVatRegistrationNumber set to true. | Opt | Opt | Opt |
| websiteURL | string | Company web site URL. Used for manual editorial review. | Opt | Opt | Opt |