Are Custom Parameters on Ad Objects Immutable?

[Dorian Kind]

Hi all,

as the title says, I was looking for clarification as to whether changing any custom parameters on ad objects also implies having to delete the old ad and create a new one. From my understanding, the answer should be yes, but the documentation isn't quite clear on it:

> Note: Ad objects are immutable. Therefore, any attempt to update the final URL or tracking template of an Ad via a SET operation will be silently ignored.

This is from <https://developers.google.com/adwords/api/docs/guides/upgraded-urls>, and it explicitly mentions only the final URL and tracking template attributes. Am I right in assuming that this also applies to custom parameters?

Thanks and best regards,
Dorian

[Danial Klimkin]

Hello Dorian,

Custom parameters (values) are part of the campaign object, these are mutable. You can't add/remove the parameters (placeholders) to/from the existing ad tracking template though.

-Danial, AdWords API Team.

[Dorian Kind]

Hi Danial,

thanks for the quick response. I was actually talking about the Custom Parameter values that are being set on an individual Ad's level (i.e. the field "urlCustomParameters" as specified at <https://developers.google.com/adwords/api/docs/reference/v201502/AdGroupAdService.Ad>). I suppose those are not part of the campaign. Or are they?

Best regards,

Dorian

[Danial Klimkin]

Hello Dorian,

Oh, you meant CreativeUrlCustomParameters. Right, as per doc:

  https://developers.google.com/adwords/api/docs/guides/upgraded-urls#tracking_template

"To change tracking parameters on any supported entity except an Ad, you only need to update the tracking template. This will trigger no review actions from Google, allowing your ads to continue serving uninterrupted. To change the tracking template of an Ad, you must remove the existing Ad and create a new Ad with the new tracking template."

The same applies to the custom parameters field.

-Danial, AdWords API Team.