Ad Customizer Feeds for Responsive Search Ads
With ad customizers for responsive search ads, your ads will dynamically update themselves in real-time to appeal to specific customers' web searches and will adapt at scale.
Your ad customizers for responsive search ads will inherit the targeting settings of the campaigns, ad groups, and keywords that you associate with them.
Why use ad customizer for responsive search ads?
- Save time. Transform a single responsive search ad into hundreds of variations without having to manually update the ad.
- More relevant ads. Leverage dynamic content to customize ads based on what potential customers are searching for.
- Better results. See higher click-through (CTR) and conversion rates.
Upload ad customizer Attribute
You can upload your ad customizer attribute for responsive search ads with the Bulk service.
The Ad customizer attribute record defines the name and data type of attributes that are allowed for the file upload.
Tip
Local storage of these entities is useful in cases where the Campaign, AdGroup and Keyword level records require updates. Learn more.
Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Website,Sync Time,Client Id,Bid Strategy Id,Bid Strategy Name,Bid Strategy Type,Bid Strategy MaxCpc,Bid Strategy TargetCpa,Bid Strategy TargetRoas,Bid Strategy TargetAdPosition,Bid Strategy TargetImpressionShare,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Time Zone,Budget Id,Budget,Budget Type,Campaign Type,Priority,Country Code,LocalInventoryAdsEnabled,Ad Schedule Use Searcher Time Zone,Start Date,End Date,Network Distribution,Ad Rotation,Cpc Bid,Language,Target Setting,Bid Option,Bid Boost Value,Ad Group Type,Title,Text,Display Url,Domain,Destination Url,Business Name,Phone Number,Promotion,Editorial Status,Editorial Appeal Status,Editorial Justification,Device Preference,Ad Format Preference,Keyword,Match Type,Bid,Param1,Param2,Param3,Transaction Id,Target,Physical Intent,Bid Adjustment,OS Names,Radius Target Id,Name,AdCustomizer DataType,AdCustomizer AttributeValue
Format Version,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,6,,
Campaign,Active,-1,232000627,,myCampaign,,,,,,,,,,,,,,,,,,,KuwaitRiyadh,,278.12,DailyBudgetAccelerated,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Ad Group,Active,-2,-1,,myCampaign,myAdGroup,,,,,,,,,,,,,,,,,,,,,,,,,,,,,OwnedAndOperatedAndSyndicatedSearch,,6.55,French,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Keyword,Active,-3,-2,,myCampaign,myAdGroup,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,YXkNHeEwy0i9IpR2AsXnV,Phrase,1.59,,,,,,,,,,,,
Adcustomizer Attribute,Active,-4,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,StringAttribute,String,StringValue
Adcustomizer Attribute,Active,-5,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,NumberAttribute,Number,10
Adcustomizer Attribute,Active,-6,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,PriceAttribute,Price,12.12
Adcustomizer Attribute,Active,-7,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,PercentAttribute,Percent,9.9
Campaign Adcustomizer Attribute,,-4,-1,,myCampaign,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,StringAttribute,,CampaignStringValue
Campaign Adcustomizer Attribute,,-5,-1,,myCampaign,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,NumberAttribute,,100
Campaign Adcustomizer Attribute,,13200021,9876521,,exisingCampaign,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,ExistingNumberAttribute,,delete_value
Adgroup Adcustomizer Attribute,,-5,-2,,myCampaign,myAdGroup,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,NumberAttribute,,1000
Keyword Adcustomizer Attribute,,-5,-3,,myCampaign,myAdGroup,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,YXkNHeEwy0i9IpR2AsXnV,Phrase,1.59,,,,,,,,,,NumberAttribute,,10000
For a AdCustomizer Attribute record, the following attribute fields are available in the Bulk File Schema.
For a Campaign AdCustomizer Attribute, AdGroup AdCustomizer Attribute, KeyWord AdCustomizer Attribute record, the following attribute fields are available in the Bulk File Schema.
Ad Group
The name of the existing ad group to which you are assigning attribute value.
Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.
Delete: Read-only
AdCustomizer DataType
The data type of each custom attribute. You define the data type in the feed record, and then set values in the feed item. So long as each custom attribute name is unique within the feed you can define multiple attributes with the same data type.
There are four different custom attribute data types you can set for ad customizer responsive search ads:
| Custom attribute type | Examples | Accepted values |
|---|---|---|
| Text | Product names, product categories, descriptions | Any letters, numbers, or symbols. Requirements: 90-character limit |
| Number | Inventory count, number of colors available | Any whole number |
| Price | Product cost, sale discount | Any number (including decimals) and valid currency characters. Example: $15, USD 15 |
| Percent | Discount rate, interest rate | Any number (including decimals) and the percent symbol[%] Example: 15% |
AdCustomizer Attributevalue
Attribute value at different entity level. The possible entity levels are Account, Campaign, Keyword and AdGroup
Add: Optional
Update: Optional
Delete: Read-only
Campaign
The name of the campaign to which you are assigning the AdCustomizer attribute value.
Add: Read-only
Update: Optional. If no value is set for the update, this setting is not changed.
Delete: Read-only
Id
The identifier of the ad customizer that is associated or removed.
Add: Read-only
Update: Read-only and Required
Delete: Read-only and Required
Keyword
The keyword of the ad customizer that is associated or removed.
Add: Read-only
Update: Optional. If no value is set for the update, this setting is not changed.
Delete: Read-only
Name
The name of your ad customizer attribute.
- Each ad customizer attribute must have a unique name.
- Attribute names can be up to 40 characters.
- You can have a maximum of 40 attributes per account.
- Attribute names cannot contain the following characters: {, }, (, ), :, /, ”, '
Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.
Delete: Read-only
Parent Id
The identifier of the account where this ad customizer is associated or removed. This bulk field maps to the Id field of the Account record.
Add: Read-only
Delete: Read-only
Status
Represents the ad customizer attribute status.
Possible values are Active and Deleted. If the ad customizer attribute is associated with the account, this field's value is Active.
Add: Read-only
Delete: Required. The Status must be set to Deleted.
Adding ad customizers to responsive search Ads
You can add ad customizers to these responsive search ad text fields: Headlines, Descriptions, and your Display URL's first and second paths (Path 1 and Path 2).
The ad customizer will appear in Microsoft Advertising in the following syntax: {CUSTOMIZER.Attribute name:default text}. So, if your attribute name is "Count" and your default text is "10," the syntax will be {CUSTOMIZER.Count:10}.
See Also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for