Ad Campaigns

Create portfolio bid strategy

Changed on

Creates a Google Ads bid strategy that several campaigns can share, such as one target CPA or ROAS.

Attach it to a campaign with portfolioBidStrategyId on POST /v1/ads/create, PUT /v1/ads/campaigns/{campaignId}, or PUT /v1/ads/ad-sets/{adSetId}. Attaching a strategy aligned to a shared budget fails there with a 400 (Google's BIDDING_STRATEGY_AND_BUDGET_MUST_BE_ALIGNED); this is not retryable.

post/v1/ads/bid-strategies

Request

Request body

accountIdstring required

Google ads SocialAccount id.

adAccountIdstring

Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer.

customerIdstring

Alias of adAccountId, kept for existing callers

namestring required
type'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE' | 'TARGET_IMPRESSION_SHARE' required
targetCpanumber

Required when type is TARGET_CPA, in the account's currency units.

targetRoasnumber

Required when type is TARGET_ROAS; a multiplier (2.0 = 2.0x).

Response

Bid strategy created

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the non-success response with the status