Class awCampaignTargetService

Description

AdWords Lib CampaignTarget Service Class

Use this service to set targeting options&mdash;filters that determine when and where ads will display&mdash;for a campaign. A campaign's targeting options are represented by a series of {@linkplain TargetList target lists}, where each list holds zero or more of the following target types: <p class="note">Note: As of v201109, only AdScheduleTarget is available in CampaignTargetService; for all other campaign-level target types, refer to the {@linkplain CampaignCriterionService.Criterion Criteria} in CampaignCriterionService.</p> <dl> <dt>{@linkplain AdScheduleTarget} (AdScheduleTargetList)</dt> <dd>Specifies days and times at which to set a bid multiplier that increases (if {@code bidMultiplier} > 1), decreases (if {@code bidMultiplier} &lt; 1), or prevents ({@code bidMultiplier} = 0) the chance of your ads being displayed. An empty AdScheduleTargetList means that all days and times are targeted equally.</dd>

<dt>{@linkplain AgeTarget}, {@linkplain GenderTarget} (DemographicTargetList)</dt> <dd>Specifies gender and age groups for which to set a bid modifier. An empty DemographicTargetList means that all demographics are targeted equally.</dd>

<dt>{@linkplain CityTarget}, {@linkplain CountryTarget}, {@linkplain MetroTarget}, {@linkplain PolygonTarget}, {@linkplain ProvinceTarget}, {@linkplain ProximityTarget} (GeoTargetList)</dt> <dd>Specifies geographic regions to either target or exclude. You can target or exclude regions of varying granularity. An empty GeoTargetList indicates that your ads will be served everywhere.</dd>

<dt>{@linkplain LanguageTarget} (LanguageTargetList)</dt> <dd>Specifies languages to target. An empty LanguageTargetList indicates that all languages will be targeted.</dd>

<dt>{@linkplain MobileCarrierTarget}, {@linkplain MobilePlatformTarget} (MobileTargetList)</dt> <dd>Specifies mobile carriers or mobile platforms to target. An empty MobileTargetList means that all mobile carriers and platforms will be targeted.</dd>

<dt>{@linkplain NetworkTarget} (NetworkTargetList)</dt> <dd>Specifies networks to target (Google Search Network, Google Display Network, etc.). Unlike other target lists, an empty NetworkTargetList means that <em>no</em> networks will be targeted.</dd>

<dt>{@linkplain PlatformTarget} (PlatformTargetList)</dt> <dd>Specific which platforms (desktop computers or high-end mobile devices) to target. An empty PlatformTargetList means that both will be targeted.</dd> </dl>

Located in /services/CampaignTargetService.php

awService
   |
   --awCampaignTargetService
Variable Summary
Method Summary
 page get (awCampaignTargetSelector $selector)
 the mutate (operations $campaignTargetOperations)
Variables
Methods

Returns the targets for each of the campaigns identified in the campaign target selector.

page get (awCampaignTargetSelector $selector)
  • selector $selector: a list of campaigns' ids and optional filter of target types.

Mutates (sets) targets for specified campaign identified in the campaign operations.

<p class="note">Note: When a campaign is created, its targeting options are also created. To add or remove targets, call {@code mutate} with the {@code SET} operator to update the target lists accordingly. The {@code ADD} and {@code REMOVE} operators are not supported.</p>

the mutate (operations $campaignTargetOperations)
  • operations $campaignTargetOperations: list of operations associating targets with campaign ids.

Inherited Methods

Inherited From awService

 awService::__construct()
 awService::callService()
 awService::checkArray()
 awService::checkArrayOf()
 awService::checkObjectOf()
 awService::getAuthToken()
 awService::getClientCustomerId()
 awService::getClientEmail()
 awService::getDeveloperToken()
 awService::getPartialFailure()
 awService::getResponseHeaders()
 awService::getServiceHeaders()
 awService::getServiceName()
 awService::getServiceUrl()
 awService::getSoapClient()
 awService::getUserAgent()
 awService::getValidateOnly()
 awService::isUsingSandbox()
 awService::returnResponseAsArrayOf()
 awService::returnResponseAsObjectOf()
 awService::setAuthToken()
 awService::setClientCustomerId()
 awService::setClientEmail()
 awService::setDeveloperToken()
 awService::setPartialFailure()
 awService::setServiceHeaders()
 awService::setUserAgent()
 awService::setValidateOnly()
 awService::useSandbox()

Documentation generated on Fri, 23 Mar 2012 13:43:51 +0200 by phpDocumentor 1.4.3