update_linkedin_channel_settings

Update the LinkedIn channel settings of an existing DRAFT wizard campaign: native objective, bidding optimization goal (including Reach), bid strategy with manual bid amount, and the LinkedIn conversion actions the campaign optimizes toward.

                These are the settings the platform UI shows in the LinkedIn channel drawer of the
                campaign draft page (Native Objective, Bidding Optimization Goal, Bid, Conversion
                Actions). The campaign MUST already have its LinkedIn channel enabled (via
                create_campaign / add_and_edit_campaign_elements with a `linkedin` block).

                WARNING: DRAFT-ONLY: the platform rejects these edits once the campaign is Launching/Launched.

                KEYWORDS: linkedin, linkedin campaign, linkedin settings, campaign settings, draft campaign,
                objective, native objective, brand awareness, website visits, engagement, video views,
                bidding optimization goal, optimization goal, reach, impressions, landing page clicks,
                engagement clicks, bid, bid strategy, auto bid, manual bid, maximum delivery,
                conversion, conversions, conversion actions, conversion tracking, insight tag, settings

                WHEN TO USE:
                - Set the LinkedIn native objective (e.g. Brand Awareness instead of the default Engagement)
                - Optimize a Brand Awareness campaign for REACH instead of IMPRESSIONS
                - Switch between auto bid (LinkedIn maximum delivery) and a manual bid
                - Pick which LinkedIn conversion actions the campaign optimizes toward and reports on

                PARAMETERS (campaign_id required; everything else optional, and an unspecified
                setting keeps its current value on the channel):
                - campaign_id: the wizard campaign ID
                - objective: BRAND_AWARENESS | WEBSITE_VISIT | ENGAGEMENT | VIDEO_VIEW, the LinkedIn
                  native objective. Only selectable on Brand Awareness (CTR) campaigns: a Lead Gen
                  (CPL) campaign derives it from its offer at launch (lead-gen form -> LEAD_GENERATION,
                  landing page -> WEBSITE_CONVERSION). The platform default for a new LinkedIn channel
                  is ENGAGEMENT. Every ad already on the channel must be supported by the objective
                  (VIDEO_VIEW is video-only, MESSAGE ads only fit WEBSITE_VISIT, DOCUMENT ads lock the
                  objective, a video-only channel accepts only ENGAGEMENT or VIDEO_VIEW). A channel
                  holding CTV ads is always Brand Awareness / Reach at launch and cannot be changed here.
                  Changing the objective also resets the cost type and the bidding optimization goal to
                  the objective's default (BRAND_AWARENESS -> IMPRESSIONS, WEBSITE_VISIT ->
                  LANDING_PAGE_CLICKS, ENGAGEMENT -> ENGAGEMENT_CLICKS, VIDEO_VIEW -> VIDEO_VIEWS), so
                  pass bidding_optimization_goal in the same call when you want something else.
                - bidding_optimization_goal: what LinkedIn optimizes delivery for. Allowed per objective:
                  BRAND_AWARENESS -> IMPRESSIONS | REACH; WEBSITE_VISIT -> LANDING_PAGE_CLICKS |
                  IMPRESSIONS; ENGAGEMENT -> ENGAGEMENT_CLICKS | IMPRESSIONS; VIDEO_VIEW -> VIDEO_VIEWS |
                  IMPRESSIONS. Conversation and Message ads are always IMPRESSIONS. CTR campaigns only.
                - bid_strategy: AUTO_BID (LinkedIn "maximum delivery", what the campaign builder applies
                  by default) or MANUAL_BID (needs bid_amount). CTV ads REQUIRE AUTO_BID; Spotlight and
                  Text ads REQUIRE MANUAL_BID.
                - bid_amount: manual bid in the account currency, used only with MANUAL_BID.
                - conversion_action_ids: ids of LinkedIn conversion actions (from list_linkedin_conversions)
                  the campaign should optimize toward and count as conversions: website visits, URL-rule
                  page views, lead form fills. REPLACES the current selection; pass [] to clear it (the
                  campaign then falls back to the account's default Insight Tag URL match). Every id must
                  exist and be enabled on the connected LinkedIn account, or launch validation fails.
                  NOTE: the platform UI only shows this picker for campaigns with landing-page offers and
                  an objective other than Brand Awareness; ids stored outside that case are still sent to
                  LinkedIn at launch, but that path is not exercised by the UI.

                NOT SETTABLE ANYWHERE IN THE PLATFORM (say so instead of promising them): LinkedIn
                Audience Network on/off and its category exclusions, audience expansion (campaigns always
                launch with expansion OFF), frequency caps, Thought Leader ads. LinkedIn geo targeting is
                not a channel setting either: it lives on the audience / target group.

                EXAMPLES:

                Brand Awareness optimized for Reach on auto bid:
                update_linkedin_channel_settings({"campaign_id": 12345, "objective": "BRAND_AWARENESS",
                    "bidding_optimization_goal": "REACH", "bid_strategy": "AUTO_BID"})

                Track two conversion actions on a Website Visits campaign:
                update_linkedin_channel_settings({"campaign_id": 12345,
                    "conversion_action_ids": ["123456", "234567"]})

                RESPONSE: {success, campaign_id, channel_id, campaign_status, campaign_goal,
                channel_ad_types, applied:{...}, errors?}. `applied` echoes exactly what was pushed to
                the platform.

                INTEGRATION WITH OTHER TOOLS:
                - list_linkedin_conversions lists the conversion actions available on the account
                - search_campaigns_by_names / get_campaign_by_wizard_id to find the campaign
                - The LinkedIn channel is enabled by create_campaign or add_and_edit_campaign_elements
                - check_campaign_launch_readiness validates the result before launch