set_search_channel_final_url_suffix

Set or clear the Final URL Suffix on a wizard campaign's search channel (Google Ads or Microsoft Ads). The suffix is appended to every final URL the platform serves — typically UTM parameters for tracking (utm_source, utm_medium, utm_campaign, ...).

                Matches the platform UI's "Final URL Suffix" input under the Google Ads / Microsoft Ads channel's Advanced Settings section.

                KEYWORDS: final url suffix, final-url-suffix, url suffix, suffix, utm, utm parameters,
                utm source, utm medium, utm campaign, tracking, tracking template, url tracking,
                tracking parameters, google ads, google, microsoft ads, microsoft, bing,
                search channel, search campaign, campaign settings, advanced settings

                WHEN TO USE:
                - Add or change UTM / tracking parameters on Google Ads or Microsoft Ads final URLs
                - Clear an existing suffix (pass empty string "")

                REQUIREMENTS:
                - The campaign MUST already have the target channel enabled (via create_campaign /
                  add_and_edit_campaign_elements with a `google` and/or `microsoft` block).
                - Final URL Suffix is search-channel-only. LinkedIn / Meta / Reddit do NOT support
                  it and the tool will reject other channel types.

                PARAMETERS:
                - campaign_id (required): the wizard campaign ID.
                - channel (required): "GOOGLE_ADS" or "MICROSOFT_ADS".
                - final_url_suffix (required): the suffix string. Max 2048 chars. Format: key=value
                  pairs separated by `&`. Allowed characters: A–Z a–z 0–9 . _ ~ = & { } - or %XX
                  percent-encoded. Spaces and [ ] ( ) # ? must be percent-encoded. Pass empty string
                  "" to clear.

                EXAMPLES:

                Set UTMs on a Google Ads channel:
                set_search_channel_final_url_suffix({
                    "campaign_id": 177214,
                    "channel": "GOOGLE_ADS",
                    "final_url_suffix": "utm_source=metadata&utm_medium=cpc&utm_campaign={campaignid}"
                })

                Clear the suffix on a Microsoft Ads channel:
                set_search_channel_final_url_suffix({
                    "campaign_id": 177214,
                    "channel": "MICROSOFT_ADS",
                    "final_url_suffix": ""
                })

                RESPONSE: {success, campaign_id, channel_id, channel, applied:{final_url_suffix}, errors?}

                INTEGRATION WITH OTHER TOOLS:
                - Use search_campaigns_by_names / get_campaign_by_wizard_id to find the campaign.
                - Google Ads / Microsoft Ads channels are enabled by create_campaign or
                  add_and_edit_campaign_elements with a `google` / `microsoft` block.