RSA Headline Pin

121 views

Skip to first unread message

Yonatan

unread,

Mar 26, 2023, 12:42:11 PM3/26/23

to Google Ads API and AdWords API Forum

Hi!

How can I get the pin settings for a headline/description in a responsive search ad?

In Google ads scripts I was able to get it like this:
var headlines = ad.getHeadlines();

var pin1 = headlines[1].pinning;

Google Ads API Forum Advisor

unread,

Mar 27, 2023, 6:43:01 AM3/27/23

to yon...@upsolver.com, adwor...@googlegroups.com

Hello,

I'm from the Google Ads API team.

You may refer here to learn about Responsive Search Ads in Google Ads API. Based on this section, Headlines and descriptions are represented as arrays of a resource called an AdTextAsset. Furthermore, if you want a specific headline to always show first, you can set that AssetLink to have a pinnedField of HEADLINE_1. Then, whenever that ad is served, that specific text will be in the first headline position and the other fields will be drawn from the pool of remaining assets. If more than one asset is pinned to a specific position, then that position will rotate text between all assets that are pinned to that position.

In order to get the pin settings of an existing ad, you may use AdService's getAd method then check its ResponsiveSearchAdInfo to access the AdTextAsset which contains the ServedAssetFieldType.

I hope this helps. Let us know if you have any further clarifications.

Regards,

Google Ads API Team