이 가이드 시리즈의 뒷부분에서 다루는 다양한 규칙에 따라 CustomerConversionGoal 및 CampaignConversionGoal 객체의 biddable 속성을 구성합니다.
Google Ads에서 자동으로 생성한 CustomerConversionGoal 객체를 목표에 맞게 업데이트합니다. ConversionActions를 향해 입찰하고 최적화하려면 biddable를 true로 설정하세요. 목표의 category 및 origin를 사용하고 그렇지 않으면 false를 사용합니다. Google Ads는 캠페인 목표를 명시적으로 업데이트하지 않았거나 맞춤 목표를 적용하지 않은 모든 캠페인에 이러한 업데이트를 자동으로 적용합니다.
고객 수준 목표와 다른 고유한 목표가 있는 캠페인이 있는 경우 다음 단계 중 하나 또는 둘 다를 사용하여 CampaignConversionGoal를 구성합니다.
update 작업을 사용하여 목표가 고객 수준 목표와 달라야 하는 CampaignConversionGoal 객체의 biddable 속성을 수정합니다.
update 작업의 결과로 Google Ads는 캠페인의 goal_config_level이 CAMPAIGN로 설정되었는지 확인하고 캠페인의 CampaignConversionGoal 객체에 CustomerConversionGoal 업데이트를 적용하는 것을 중지합니다.ConversionGoalCampaignConfig
캠페인을 다시 고객 수준 목표를 사용하도록 전환하려면 goal_config_level를 CUSTOMER로 설정하세요.
Google Ads는 CustomerConversionGoal에 맞게 CampaignConversionGoal를 수정하고 goal_config_level가 CUSTOMER로 설정된 상태로 유지되는 한 CustomerConversionGoal의 변경사항을 캠페인의 CampaignConversionGoal에 적용합니다. 캠페인에서 CustomConversionGoals 사용을 중지합니다.
변경 요구사항
CustomerConversionGoal 또는 CustomConversionGoal 객체를 변경할 때 요청의 customer_id이 계정의 Google Ads 전환 고객 계정 ID와 일치해야 합니다.
반면 CampaignConversionGoal 또는 ConversionGoalCampaignConfig 객체를 변환할 때는 요청의 customer_id이 Google Ads 계정의 Customer 리소스의 customer_id과 일치해야 합니다.
전환 액션 설정
목표는 category 및 origin로 구성되지만 각 ConversionAction의 primary_for_goal 속성을 설정하여 입찰에서 수행해야 하는 역할과 액션의 전환이 보고서에 표시되는 방식을 나타낼 수 있습니다.
primary_for_goal이 true인 경우:
Google Ads에서는 전환 액션의 category 및 origin에 대한 고객 및 캠페인 목표의 biddable 속성을 기반으로 입찰에 전환 액션을 포함합니다.
Google Ads는 전환 액션의 전환수와 전환 가치를 전환수 및 모든 전환수에 포함합니다.
primary_for_goal이 false인 경우:
CustomConversionGoal에서 전환 액션을 사용하지 않는 한 Google Ads에서는 입찰 또는 전환수에 전환 액션을 포함하지 않습니다. 보고서의 모든 전환 및 관련 필드에서 전환 액션의 전환수와 전환 가치를 계속 확인할 수 있습니다.
[null,null,["최종 업데이트: 2025-08-26(UTC)"],[[["\u003cp\u003eConversion goals streamline conversion action organization for efficient optimization towards advertising objectives, grouping them by category and origin.\u003c/p\u003e\n"],["\u003cp\u003eCustomer goals establish default account-wide goals, while campaign goals allow for campaign-specific bidding and optimization by overriding customer goals.\u003c/p\u003e\n"],["\u003cp\u003eConversion actions with \u003ccode\u003eprimary_for_goal\u003c/code\u003e set to \u003ccode\u003etrue\u003c/code\u003e are included in bidding and reporting metrics like 'Conversions' and 'All conversions'.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Ads automatically creates and manages CustomerConversionGoal, CampaignConversionGoal, and ConversionGoalCampaignConfig objects, allowing only updates through the API.\u003c/p\u003e\n"],["\u003cp\u003eWhen managing conversion actions, utilize the \u003ccode\u003eprimary_for_goal\u003c/code\u003e attribute instead of the deprecated \u003ccode\u003einclude_in_conversions_metric\u003c/code\u003e for bidding and reporting purposes.\u003c/p\u003e\n"]]],[],null,["# Conversion goals\n\n[Conversion goals](//support.google.com/google-ads/answer/10995103) help you\norganize your conversion actions so that you can more easily optimize toward\nyour advertising objectives.\n\nConversion goals are grouped by the unique combinations of\n[`category`](/google-ads/api/reference/rpc/v21/ConversionAction#category)\n(for example, `PAGE_VIEW`), and [`origin`](/google-ads/api/reference/rpc/v21/ConversionAction#origin)\n(for example, `WEBSITE`) in the set of\n[`ConversionActions`](/google-ads/api/reference/rpc/v21/ConversionAction) in your account's\n[Google Ads conversion customer](/google-ads/api/docs/conversions/getting-started#enable_conversion_tracking).\n| **Important:** In the Google Ads UI goal management tabs, the `origin` attribute is labeled **Conversion source** . The Google Ads API uses the term `origin` to differentiate between this attribute and the **Source** field in the UI **Conversion actions** tab.\n| **Important:** You can only set the [`selective_optimization`](/google-ads/api/reference/rpc/v21/Campaign#selective_optimization) field of `Campaign` on an [App campaign](/google-ads/api/docs/app-campaigns/overview). For all other campaign types, use [campaign goals](/google-ads/api/docs/conversions/goals/campaign-goals) to optimize a campaign for specific conversion actions.\n\nGoal management overview\n------------------------\n\nConversion goals are organized in a hierarchy. Customer goals define the\n[default goals](//support.google.com/google-ads/answer/10995103#account_default)\nfor your entire account, while campaign goals override the customer goals for\ncampaigns with specific bidding and optimization requirements.\n\nThe goal management workflow is as follows:\n\n1. Create a `ConversionAction`.\n\n When you create the conversion action, Google Ads automatically performs the\n following steps:\n - Creates a [`CustomerConversionGoal`](/google-ads/api/reference/rpc/v21/CustomerConversionGoal) for the conversion action's `category` and `origin` if one doesn't already exist.\n - Creates a [`CampaignConversionGoal`](/google-ads/api/reference/rpc/v21/CampaignConversionGoal) for each campaign and the conversion action's `category` and `origin` if one doesn't already exist.\n - Configures the `biddable` attribute of the `CustomerConversionGoal` and `CampaignConversionGoal` objects according to various rules covered later in this guide series.\n\n | **Note:** Your account already has `CustomerConversionGoal` and `CampaignConversionGoal` objects for your existing conversion actions.\n2. Update the `CustomerConversionGoal` objects that Google Ads created automatically\n to align with your objectives. Set `biddable` to `true` to bid and optimize\n towards `ConversionActions` with the goal's `category` and `origin`, and\n `false` otherwise. Google Ads automatically applies these updates to every\n campaign where you hadn't explicitly updated campaign goals or applied\n custom goals.\n\n3. If you have a campaign with unique goals that differ from your customer-level\n goals, configure its `CampaignConversionGoal` using one or both of the\n following steps.\n\n - Use `update` operations to modify the `biddable` attribute of any\n `CampaignConversionGoal` objects where the goal should differ from the\n customer-level goals.\n\n - If configuring the campaign's goals by `category` and `origin` doesn't\n suffice, use specific conversion actions for bidding and optimization by\n creating a [`CustomConversionGoal`](/google-ads/api/reference/rpc/v21/CustomConversionGoal)\n and updating the campaign's [`ConversionGoalCampaignConfig`](/google-ads/api/reference/rpc/v21/ConversionGoalCampaignConfig).\n\n As a result of the `update` operations, Google Ads ensures that the\n [`goal_config_level`](/google-ads/api/reference/rpc/v21/ConversionGoalCampaignConfig#goal_config_level)\n of the campaign's `ConversionGoalCampaignConfig` is set\n to [`CAMPAIGN`](/google-ads/api/reference/rpc/v21/GoalConfigLevelEnum.GoalConfigLevel#campaign)\n and stops applying `CustomerConversionGoal` updates to the campaign's\n `CampaignConversionGoal` objects.\n\n If you want to transition the campaign back to using customer-level goals,\n set `goal_config_level` to\n [`CUSTOMER`](/google-ads/api/reference/rpc/v21/GoalConfigLevelEnum.GoalConfigLevel#customer).\n Google Ads modifies its `CampaignConversionGoal` to match\n `CustomerConversionGoal` and as long as `goal_config_level` remains set to\n `CUSTOMER`, applies any changes to `CustomerConversionGoal` to the campaign's\n `CampaignConversionGoal`. The campaign in turn stops using any\n `CustomConversionGoals`.\n | **Key Point:** Since Google Ads automatically creates [`CustomerConversionGoal`](/google-ads/api/reference/rpc/v21/CustomerConversionGoal), [`CampaignConversionGoal`](/google-ads/api/reference/rpc/v21/CampaignConversionGoal), and [`ConversionGoalCampaignConfig`](/google-ads/api/reference/rpc/v21/ConversionGoalCampaignConfig) objects in your account, you can only *update* those objects. The Google Ads API doesn't support creating or removing those objects.\n\nMutate requirements\n-------------------\n\nWhen mutating a `CustomerConversionGoal` or `CustomConversionGoal` object,\nthe `customer_id` of the request must match the ID of your account's\n[Google Ads conversion customer account](/google-ads/api/docs/conversions/getting-started#enable_conversion_tracking).\n\nIn contrast, when mutating a `CampaignConversionGoal` or\n`ConversionGoalCampaignConfig` object, the `customer_id` of the request must\nmatch the `customer_id` of your Google Ads account's `Customer` resource.\n\nConversion action settings\n--------------------------\n\nAlthough goals are organized by `category` and `origin`, you can set the\n[`primary_for_goal`](/google-ads/api/reference/rpc/v21/ConversionAction#primary_for_goal) attribute\nof each `ConversionAction` to indicate the role it should play in bidding and\nhow the action's conversions will [appear in reports](//support.google.com/google-ads/answer/11461796).\n\nIf `primary_for_goal` is `true`:\n\n- Google Ads includes the conversion action in bidding based on the `biddable` attribute of customer and campaign goals for the conversion action's `category` and `origin`.\n- Google Ads includes the conversion action's conversions and conversion values in [**Conversions**](/google-ads/api/fields/v21/campaign#metrics.conversions) and [**All\n conversions**](/google-ads/api/fields/v21/campaign#metrics.all_conversions).\n\nIf `primary_for_goal` is `false`:\n\n- Google Ads doesn't include the conversion action in bidding or **Conversions**\n unless you use the conversion action in a `CustomConversionGoal`. You can\n still find the conversion action's conversions and conversion values in\n [**All conv.**](/google-ads/api/fields/v21/campaign#metrics.all_conversions) and its related\n fields in reports.\n\n See the\n [campaign goals guide](/google-ads/api/docs/conversions/goals/campaign-goals#custom_goals)\n for more information about custom conversion goals.\n\nConversion actions with `primary_for_goal` set to `true` appear in the Google Ads UI\nas **Primary action used for bidding optimization** , otherwise they appear as\n**Secondary action not used for bidding optimization**.\n| **Important:** The [`include_in_conversions_metric`](/google-ads/api/reference/rpc/v21/ConversionAction#include_in_conversions_metric) attribute of `ConversionAction` is deprecated. When managing your conversion actions, set the `primary_for_goal` attribute instead, and transition any of your reporting or application logic that relies on `include_in_conversions_metric` to use `primary_for_goal`."]]
