What's new
Ads and ad formats
The
description2
andheadlinePart3
fields were added toExpandedTextAd
.The
description2
field was added toExpandedDynamicSearchAd
.The maximum character count was increased from 80 to 90 for
description1
anddescription2
ofExpandedTextAd
,ExpandedDynamicSearchAd
, andCallOnlyAd
.The
adStrengthInfo
field was added toAdGroupAd
to indicate the strength of each ad and the actions you can take to improve it.Attempts to add a
CallOnlyAd
orCALL
extension will fail with the error reasonCUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
if the Call & Messaging Ads Terms are released for your account, but you have not yet acknowledged the terms.Mutate requests for
AdGroupAdService
andAdService
will now fail with aCertificateDomainMismatchConstraint
if a certificate does not include the correct domain. Previously, these requests failed with anInternalApiError
.The
youTubeVideos
field was added to support video assets hosted on YouTube forMultiAssetResponsiveDisplayAds
. This feature is only available to whitelisted users.
General
The
trafficSplitType
field was added toTrial
to give you greater control over how traffic is split between base and trial campaigns.AdGroupService
validation was modified and theUniversalAppAd
ad type was added to allow whitelisted users to create ad groups and ads in Universal App campaigns.Any CampaignService request that attempts to add a
Campaign
with a shared budget to aCampaignGroup
will now fail with the errorCampaignError
and reasonCAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP
. Previously, such a request would fail but with a less informative error.
Shopping
The validation for
campaignPriority
ofShoppingSetting
was simplified as follows:Smart Shopping campaigns no longer require
campaignPriority
. Previously, these campaigns required acampaignPriority
of3
.In this case, the AdWords API now applies the appropriate value instead of requiring the user to specify the one permitted value for each case.
The error reasons
SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE
andPURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
were removed fromCampaignError
since they can no longer be thrown.
Targeting
The read-only
destinationUrl
field was removed fromBiddableAdGroupCriterion
. This field was deprecated with the introduction of upgraded URLs.The following
ContentLabelType
enum values were removed:AFE
ALLOWED_GAMBLING_CONTENT
CONFLICT
SIRENS
UGC_FORUMS
UGC_IMAGES
UGC_SOCIAL
UGC_VIDEOS
Attempts to target placements on Search campaigns will now fail with the error
CriterionError
and reasonCANNOT_ADD_POSITIVE_PLACEMENTS_TO_SEARCH_CAMPAIGNS
.The error reason
PLACEMENT_LIST_TYPE_ONLY_ALLOWED_FOR_XBID
was removed fromCustomerNegativeCriterionError
since it can no longer be thrown.Any request that attempts to exclude a
Placement
target with aurl
equal toadsenseformobileapps.com
will now fail with the error reasonADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED
. Previously, such requests failed with error reasonINVALID_PLACEMENT_URL
. Check out the related blog post for more details.
Reporting
Removed reports
The DESTINATION_URL_REPORT
was removed. The FINAL_URL_REPORT
replaced this
report when upgraded URLs were added
to the AdWords API.
New report fields
ConversionAttributionEventType
field was added to the CAMPAIGN_PERFORMANCE_REPORT. This field allows you to segmentAllConversions
and related metrics by event type (impression or interaction).The
ConversionAdjustment
andConversionAdjustmentLagBucket
fields were added to multiple reports. TheConversionAdjustment
indicates whether a conversion was adjusted, and theConversionAdjustmentLagBucket
segments report results according to the number of days between the impression and either a conversion or an adjustment.The
AdStrengthInfo
field was added to the AD_PERFORMANCE_REPORT so you can retrieve the ad strength information mentioned above in reports as well.The following fields were added to the CLICK_PERFORMANCE_REPORT to allow you to monitor the performance of your ad variations:
AdVariationControlTrialArmId
AdVariationTreatmentTrialArmId
AdVariationTrialId
Migration guide
Breaking changes introduced in this version are summarized in the v201809 migration guide.
API changes
-
=
AccountLabelService (no changes) -
=
AdCustomizerFeedService (no changes) -
≠
AdGroupAdService (4 new, 7 changed, 0 removed)-
+
type CertificateDomainMismatchConstraint -
+
type MediaBundleAsset -
+
type UniversalAppAd -
+
type YoutubeVideoAsset -
≠
enum Ad.Type-
+
value UNIVERSAL_APP_AD
-
-
≠
enum AdError.Reason -
≠
type AdGroupAd-
+
field adStrengthInfo
-
-
≠
enum Asset.Type-
+
value YOUTUBE_VIDEO -
+
value MEDIA_BUNDLE
-
-
≠
type ExpandedDynamicSearchAd-
+
field description2
-
-
≠
type ExpandedTextAd-
+
field description2 -
+
field headlinePart3
-
-
≠
type MultiAssetResponsiveDisplayAd-
+
field youtubeVideos
-
-
-
≠
AdGroupBidModifierService (0 new, 1 changed, 0 removed)-
≠
enum CriterionError.Reason
-
-
≠
AdGroupCriterionService (0 new, 3 changed, 0 removed)-
≠
type BiddableAdGroupCriterion-
−
field destinationUrl
-
-
≠
enum BiddingErrors.Reason -
≠
enum CriterionError.Reason
-
-
≠
AdGroupExtensionSettingService (1 new, 2 changed, 0 removed)-
+
type CertificateDomainMismatchConstraint -
≠
enum CriterionError.Reason -
≠
enum ExtensionSettingError.Reason
-
-
=
AdGroupFeedService (no changes) -
≠
AdGroupService (0 new, 1 changed, 0 removed)-
≠
enum BiddingErrors.Reason
-
-
=
AdParamService (no changes) -
≠
AdService (4 new, 6 changed, 0 removed)-
+
type CertificateDomainMismatchConstraint -
+
type MediaBundleAsset -
+
type UniversalAppAd -
+
type YoutubeVideoAsset -
≠
enum Ad.Type-
+
value UNIVERSAL_APP_AD
-
-
≠
enum AdError.Reason -
≠
enum Asset.Type-
+
value YOUTUBE_VIDEO -
+
value MEDIA_BUNDLE
-
-
≠
type ExpandedDynamicSearchAd-
+
field description2
-
-
≠
type ExpandedTextAd-
+
field description2 -
+
field headlinePart3
-
-
≠
type MultiAssetResponsiveDisplayAd-
+
field youtubeVideos
-
-
-
=
AdwordsUserListService (no changes) -
≠
AssetService (3 new, 1 changed, 0 removed)-
+
type MediaBundleAsset -
+
type YoutubeAdVideoRegistrationError -
+
type YoutubeVideoAsset -
≠
enum Asset.Type-
+
value YOUTUBE_VIDEO -
+
value MEDIA_BUNDLE
-
-
-
=
BatchJobService (no changes) -
≠
BiddingStrategyService (0 new, 1 changed, 0 removed)-
≠
enum BiddingErrors.Reason
-
-
=
BudgetOrderService (no changes) -
≠
BudgetService (0 new, 1 changed, 0 removed)-
≠
enum BudgetError.Reason
-
-
≠
CampaignBidModifierService (0 new, 1 changed, 0 removed)-
≠
enum CriterionError.Reason
-
-
≠
CampaignCriterionService (0 new, 2 changed, 0 removed)-
≠
enum ContentLabelType-
−
value AFE -
−
value CONFLICT -
−
value UGC_FORUMS -
−
value UGC_IMAGES -
−
value UGC_SOCIAL -
−
value UGC_VIDEOS -
−
value SIRENS -
−
value ALLOWED_GAMBLING_CONTENT
-
-
≠
enum CriterionError.Reason
-
-
≠
CampaignExtensionSettingService (1 new, 2 changed, 0 removed)-
+
type CertificateDomainMismatchConstraint -
≠
enum CriterionError.Reason -
≠
enum ExtensionSettingError.Reason
-
-
=
CampaignFeedService (no changes) -
=
CampaignGroupPerformanceTargetService (no changes) -
=
CampaignGroupService (no changes) -
≠
CampaignService (2 new, 4 changed, 0 removed)-
+
type CertificateDomainMismatchConstraint -
+
type UniversalAppCampaignInfo -
≠
enum BiddingErrors.Reason -
≠
enum BudgetError.Reason -
≠
type Campaign-
+
field universalAppCampaignInfo
-
-
≠
enum CampaignError.Reason-
+
value CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP -
−
value SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE -
−
value PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
-
-
-
=
CampaignSharedSetService (no changes) -
=
ConstantDataService (no changes) -
=
ConversionTrackerService (no changes) -
≠
CustomAffinityService (0 new, 1 changed, 0 removed)-
≠
enum CriterionError.Reason
-
-
≠
CustomerExtensionSettingService (1 new, 2 changed, 0 removed)-
+
type CertificateDomainMismatchConstraint -
≠
enum CriterionError.Reason -
≠
enum ExtensionSettingError.Reason
-
-
=
CustomerFeedService (no changes) -
≠
CustomerNegativeCriterionService (0 new, 3 changed, 0 removed)-
≠
enum ContentLabelType-
−
value AFE -
−
value CONFLICT -
−
value UGC_FORUMS -
−
value UGC_IMAGES -
−
value UGC_SOCIAL -
−
value UGC_VIDEOS -
−
value SIRENS -
−
value ALLOWED_GAMBLING_CONTENT
-
-
≠
enum CriterionError.Reason -
≠
enum CustomerNegativeCriterionError.Reason-
−
value PLACEMENT_LIST_TYPE_ONLY_ALLOWED_FOR_XBID
-
-
-
=
CustomerService (no changes) -
=
CustomerSyncService (no changes) -
=
DataService (no changes) -
≠
DraftAsyncErrorService (0 new, 4 changed, 0 removed)-
≠
enum AdError.Reason -
≠
enum BiddingErrors.Reason -
≠
enum CampaignError.Reason-
+
value CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP -
−
value SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE -
−
value PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
-
-
≠
enum CriterionError.Reason
-
-
≠
DraftService (0 new, 1 changed, 0 removed)-
≠
enum BiddingErrors.Reason
-
-
≠
FeedItemService (1 new, 1 changed, 0 removed)-
+
type CertificateDomainMismatchConstraint -
≠
enum CriterionError.Reason
-
-
≠
FeedItemTargetService (0 new, 1 changed, 0 removed)-
≠
enum CriterionError.Reason
-
-
=
FeedMappingService (no changes) -
=
FeedService (no changes) -
=
LabelService (no changes) -
=
LocationCriterionService (no changes) -
=
ManagedCustomerService (no changes) -
=
MediaService (no changes) -
=
OfflineCallConversionFeedService (no changes) -
≠
OfflineConversionAdjustmentFeedService (0 new, 1 changed, 0 removed)-
≠
enum OfflineConversionAdjustmentError.Reason-
−
value ATTRIBUTED_CONVERSION_NOT_SUPPORTED
-
-
-
=
OfflineConversionFeedService (no changes) -
≠
OfflineDataUploadService (0 new, 1 changed, 0 removed)-
≠
enum AdError.Reason
-
-
≠
ReportDefinitionService (0 new, 1 changed, 0 removed)-
≠
enum ReportDefinition.ReportType-
−
value DESTINATION_URL_REPORT
-
-
-
≠
SharedCriterionService (0 new, 1 changed, 0 removed)-
≠
enum CriterionError.Reason
-
-
=
SharedSetService (no changes) -
≠
TargetingIdeaService (0 new, 3 changed, 0 removed)-
≠
enum BudgetError.Reason -
≠
enum ContentLabelType-
−
value AFE -
−
value CONFLICT -
−
value UGC_FORUMS -
−
value UGC_IMAGES -
−
value UGC_SOCIAL -
−
value UGC_VIDEOS -
−
value SIRENS -
−
value ALLOWED_GAMBLING_CONTENT
-
-
≠
enum CriterionError.Reason
-
-
≠
TrafficEstimatorService (0 new, 1 changed, 0 removed)-
≠
enum ContentLabelType-
−
value AFE -
−
value CONFLICT -
−
value UGC_FORUMS -
−
value UGC_IMAGES -
−
value UGC_SOCIAL -
−
value UGC_VIDEOS -
−
value SIRENS -
−
value ALLOWED_GAMBLING_CONTENT
-
-
-
≠
TrialAsyncErrorService (0 new, 4 changed, 0 removed)-
≠
enum AdError.Reason -
≠
enum BiddingErrors.Reason -
≠
enum CampaignError.Reason-
+
value CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP -
−
value SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE -
−
value PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
-
-
≠
enum CriterionError.Reason
-
-
≠
TrialService (0 new, 4 changed, 0 removed)-
≠
enum BiddingErrors.Reason -
≠
enum BudgetError.Reason -
≠
enum CampaignError.Reason-
+
value CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP -
−
value SHOPPING_MERCHANT_NOT_ALLOWED_FOR_PURCHASES_ON_GOOGLE -
−
value PURCHASES_ON_GOOGLE_NOT_SUPPORTED_FOR_SHOPPING_SALES_COUNTRY
-
-
≠
type Trial-
+
field trafficSplitType
-
-