Export (0) Print
Expand All

Dynamic Text Substitution

You can use dynamic text placeholders to customize your ad text, title, display URL, and destination URL. For example, if the URL is http://www.northwindtraders.com/{MatchType}/default.aspx?{IfSearch:source=search}{IfContent:source=content}, and if the ad served on the search network via exact match, the destination URL will resolve to http://www.northwindtraders.com/e/default.aspx?source=search.

System_CLiX_important Important

If a placeholder is malformed or misspelled, it will appear as a literal string in the ad and not be substituted.

For information about dynamic text placeholder use cases, see the following sections.

Dynamic Text for Text and Mobile Ad Copy

You can use keyword and parameter placeholders to substitute text dynamically within your ad text, title, and display URL.

System_CLiX_note Note

The keyword and parameter dynamic text placeholders can include default text that the service uses when the resulting string would exceed the maximum string length of the ad title or text. For example, you can include {keyword:my default value} in your ad copy. If you use default text, each dynamic text string in the ad must include a default string; otherwise, the service does not use any of the default strings, which can result in one or more strings exceeding their maximum string length limit.

Keyword Placeholders

Including the keyword that matched a user’s search term in an ad’s text, title, or display URL can help increase the click-through rate (CTR) of the ad and the conversion rate of your ad campaign. To include the keyword that matched the corresponding search term in your ad copy, include the "{keyword}" dynamic text string in your ad’s text, title, or display URL. For example, if the ad’s text is "Order {keyword} today!", the following table shows the resulting ad text based on the keyword and the user’s search term.

Keyword

Search Term

Actual Ad Display

apples

fresh apples

Order apples today!

Rainier cherries

cherries

Order Rainier cherries today!

peaches

Cling peaches

Order peaches today!

You can use the following {keyword} capitalization to affect how the search term appears in the ad.

Capitalization of {keyword} string

How it affects the text in the ad

{keyword:default}

The term appears in all lowercase characters. For example, Order rainier cherries today!

{KeyWord:default} or {KEYWORD:default}

The first character of each word of the term is capitalized. For example, Order Rainier Cherries today!

{Keyword:default}

The first character of the first word of the term is capitalized and all subsequent words appear in all lowercase characters. For example, Order Rainier cherries today!

{keyWord:default}

The first word of the term appears in all lowercase characters and the first character of all subsequent words of the term is capitalized. For example, Order rainier Cherries today!

{keyWORD:default}

The first word of the term appears in all lowercase characters and all subsequent words of the term appear in all uppercase characters. For example, Order rainier CHERRIES today!

{KEYword:default}

The first word of the term appears in all uppercase characters and all subsequent words of the term appear in all lowercase characters. For example, Order RAINIER cherries today!

{KEYWord:default}

The first word of the term appears in all uppercase characters and the first character of all subsequent words of the term is capitalized. For example, Order RAINIER Cherries today!

Parameter Placeholders

To dynamically generate the ad’s text and title using values from the Param1, Param2, and Param3 elements of a Keyword, include the following parameter strings in the ad’s text and title.

  • {param1:default}

  • {param2:default}

  • {param3:default}

The ad will include the keyword's parameter strings if the keyword text matches the user’s search term. For example, assume the following:

  • The ad’s text contains "All {keyword} {param1}".

  • The keyword "dolls" sets Param1 to "10% Off".

  • The keyword "toy boats" sets Param1 to "20% Off".

If the user searches for "Dolls", the ad’s text will be "All dolls 10% off". If the user searches for "Toy Boats", the ad’s text will be "All toy boats 20% off".

Dynamic Text for Text and Mobile Ad Destination URL

The text or mobile ad’s destination URL can include the following dynamic text strings. The strings are case-insensitive, must include the opening and closing braces, and cannot be used in the ad’s title, text, or display URL.

System_CLiX_note Note

If you use Google Analytics, you may choose to manually specify UTM tracking codes. For information on how to set up Bing Ads to automatically append your destination URL with UTM tracking codes, see the ForwardCompatibilityMap element of the Account Data Object.

Dynamic Text

Description

{BidMatchType}

Substitutes one of the following bid match-type codes into the URL.

  • For search ads:

    • be – exact

    • bp – phrase

    • bb – broad

  • For content ads – bc

{MatchType}

Substitutes one of the following delivered match-type codes into the URL.

  • For search ads:

    • e – exact

    • p – phrase

    • b – broad

  • For content ads – c

{OrderItemId}

Substitutes the keyword’s ID into the URL.

{AdId}

Substitutes the ad’s ID into the URL.

{QueryString}

Substitutes the search term that the user entered into the URL.

{IfSearch: string}

If the ad is displayed on the search network, then the string text to the right of the colon will be substituted into the URL.

System_CLiX_note Note

Conditional placeholders {IfSearch}, {IfContent}, {IfMobile}, and {IfNotMobile} may be used independently or together in the same destination URL, and only one will be substituted depending on the ad distribution medium.

{IfContent: string}

If the ad is displayed on the content network, then the string text to the right of the colon will be substituted into the URL.

System_CLiX_note Note

Conditional placeholders {IfSearch}, {IfContent}, {IfMobile}, and {IfNotMobile} may be used independently or together in the same destination URL, and only one will be substituted depending on the ad distribution medium.

{IfMobile: string}

If the ad is displayed on a mobile device, then the string text to the right of the colon will be substituted into the URL.

System_CLiX_note Note

Conditional placeholders {IfSearch}, {IfContent}, {IfMobile}, and {IfNotMobile} may be used independently or together in the same destination URL, and only one will be substituted depending on the ad distribution medium.

{IfNotMobile: string}

If the ad is displayed on a desktop, laptop, or tablet device, then the string text to the right of the colon will be substituted into the URL.

System_CLiX_note Note

Conditional placeholders {IfSearch}, {IfContent}, {IfMobile}, and {IfNotMobile} may be used independently or together in the same destination URL, and only one will be substituted depending on the ad distribution medium.

{Device}

Substitutes one of the following device codes into the URL, depending on whether the click came from a device classified as mobile, tablet, or desktop or laptop.

  • m – mobile device

  • t – tablet device

  • c – desktop or laptop computer

{keyword:default}

Substitutes the keyword that matched the user's search term.

System_CLiX_note Note

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the URL.

For more information, see Dynamic Text for Ad Copy.

{param1:default}

Substitutes {Param1} in the URL with the value of the Param1 element of the Keyword that matched the user's search term.

System_CLiX_note Note

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the URL.

For more information, see Dynamic Text for Ad Copy.

{param2:default}

Substitutes {Param2} in the URL with the value of the Param2 element of the Keyword that matched the user's search term.

System_CLiX_note Note

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the URL.

For more information, see Dynamic Text for Ad Copy.

{param3:default}

Substitutes {Param3} in the URL with the value of the Param3 element of the Keyword that matched the user's search term.

System_CLiX_note Note

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the URL.

For more information, see Dynamic Text for Ad Copy.

Dynamic Text for Product Ad Destination URL

If you advertise with Product Ads, the destination URL can contain dynamic text strings. The product ad’s destination URL can include the following dynamic text strings. The strings are case-insensitive, must include the opening and closing braces, and cannot be used in the ad’s title, text, or display URL.

Dynamic Text

Description

{AdId}

Replaces {AdId} in the URL with the Id of the ProductAd inherited from the Ad object.

{CriterionId}

Replaces {CriterionId} in the URL with the Id of the BiddableAdGroupCriterion inherited from AdGroupCriterion.

{param1:default}

Replaces {Param1} in the URL with the value of the Param1 element of the BiddableAdGroupCriterion.

System_CLiX_note Note

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the URL.

{param2:default}

Replaces {Param2} in the URL with the value of the Param2 element of the BiddableAdGroupCriterion.

System_CLiX_note Note

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the URL.

{param3:default}

Replaces {Param3} in the URL with the value of the Param3 element of the BiddableAdGroupCriterion.

System_CLiX_note Note

You should provide a default string that the system will use if including the substitution value will cause the expanded string to exceed the string limit of the URL.

{QueryString}

Replaces {QueryString} in the URL with the user’s search term.

{lpurl}

Replaces {lpurl} with the full destination URL from Bing Merchant Center.

{lpurlpath}

Replaces {lpurlpath} with the destination URL path (without domain) from Bing Merchant Center.

{unescapedlpurl}

Replaces {unescapedlpurl} with the destination URL from Bing Merchant Center, and with special characters such as ‘?’ and ‘&’ preserved instead of escaped.

{ProductId}

Replaces {ProductId} in the URL with the ID of the product from Bing Merchant Center.

{IfMobile: string}

If the ad is displayed on a mobile device, then the string text to the right of the colon will be substituted into the URL.

System_CLiX_note Note

Conditional placeholders {IfMobile} and {IfNotMobile} may be used independently or together in the same destination URL, and only one will be substituted depending on the ad distribution medium.

{IfNotMobile: string}

If the ad is displayed on a desktop, laptop, or tablet device, then the string text to the right of the colon will be substituted into the URL.

System_CLiX_note Note

Conditional placeholders {IfMobile} and {IfNotMobile} may be used independently or together in the same destination URL, and only one will be substituted depending on the ad distribution medium.

Community Additions

ADD
Show:
© 2014 Microsoft