고객 목표
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
각 CustomerConversionGoal는 Google Ads에서 지정된 category 및 origin로 전환 액션을 최적화할지 여부를 결정합니다. Google Ads에서는 사용 중인 category 및 origin의 모든 조합에 대해 CustomerConversionGoal가 있는지 확인하기 위해 계정의 Google Ads 전환 고객에 ConversionActions를 추가하면 CustomerConversionGoals를 자동으로 만듭니다.
Google Ads에서 CustomerConversionGoal 객체 생성을 자동으로 처리하므로 각 목표의 biddable 속성을 설정하여 전환 목표가 계정 기본 목표인지 지정합니다. Google Ads에서 목표의 category 및 origin을 사용하여 전환 액션을 최적화해야 하는 경우 biddable을 true로 설정하고, 그렇지 않은 경우 biddable을 false로 설정합니다. true 및 false 값은 각각 전환 액션 설정의 계정의 기본 목표로 사용 및 계정의 기본 목표로 사용하지 않음 옵션과 동일합니다.
새 카테고리 및 출처 조합
Google Ads 전환 고객에 ConversionAction가 생성되고 새 액션의 category 및 origin 조합이 다른 액션에 없는 경우 Google Ads는 category 및 origin에 대해 새 CustomerConversionGoal를 자동으로 생성하고 biddable 속성을 기본적으로 true로 설정합니다.
하지만 Google Ads에서는 다음 category 및 origin 조합에 대해 기본적으로 biddable를 false로 설정합니다.
| category |
origin |
| BEGIN_CHECKOUT |
GOOGLE_HOSTED |
| 구매 고려도 |
GOOGLE_HOSTED |
| 연락처 |
GOOGLE_HOSTED |
| CONVERTED_LEAD |
GOOGLE_HOSTED |
| 참여 |
GOOGLE_HOSTED |
| GET_DIRECTIONS |
GOOGLE_HOSTED |
| PAGE_VIEW |
GOOGLE_HOSTED |
| QUALIFIED_LEAD |
GOOGLE_HOSTED |
| 가입 |
GOOGLE_HOSTED |
| 구매 |
GOOGLE_HOSTED |
| STORE_SALE |
스토어 |
| STORE_VISIT |
스토어 |
고객 목표 가져오기
다음 쿼리를 사용하여 계정의 CustomerConversionGoals 목록을 가져옵니다.
SELECT
customer_conversion_goal.resource_name,
customer_conversion_goal.category,
customer_conversion_goal.origin,
customer_conversion_goal.biddable
FROM customer_conversion_goal
일반적인 예는 페이지 조회 전환 목표로, 이는 PAGE_VIEW의 category와 WEBSITE의 origin의 조합으로 표시됩니다.
이 전환 목표에 속하는 전환 액션을 검색하려면(목표 요약 페이지의 Google Ads UI에 표시되는 항목과 일치) 다음 쿼리를 사용하세요.
SELECT
conversion_action.category,
conversion_action.origin,
conversion_action.name
FROM conversion_action
WHERE conversion_action.category = 'PAGE_VIEW'
AND conversion_action.origin = 'WEBSITE'
AND conversion_action.status = 'ENABLED'
또 다른 일반적인 예는 Google Ads UI에 그룹이 기타로 표시되는 것입니다.
category을 DEFAULT로 설정하면 됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-26(UTC)
[null,null,["최종 업데이트: 2025-08-26(UTC)"],[[["\u003cp\u003eGoogle Ads automatically creates and manages \u003ccode\u003eCustomerConversionGoals\u003c/code\u003e based on the \u003ccode\u003ecategory\u003c/code\u003e and \u003ccode\u003eorigin\u003c/code\u003e of your conversion actions to streamline optimization.\u003c/p\u003e\n"],["\u003cp\u003eYou can control whether Google Ads optimizes for a specific conversion goal by setting the \u003ccode\u003ebiddable\u003c/code\u003e attribute to \u003ccode\u003etrue\u003c/code\u003e (optimize) or \u003ccode\u003efalse\u003c/code\u003e (don't optimize).\u003c/p\u003e\n"],["\u003cp\u003eNew conversion actions with unique category and origin combinations will automatically have a corresponding \u003ccode\u003eCustomerConversionGoal\u003c/code\u003e created, typically set to \u003ccode\u003ebiddable\u003c/code\u003e by default, unless they fall within specific combinations listed in the documentation.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve and analyze your \u003ccode\u003eCustomerConversionGoals\u003c/code\u003e and associated conversion actions using provided sample queries to gain insights into your conversion setup.\u003c/p\u003e\n"],["\u003cp\u003eCommon use cases like analyzing page view goals or the "Other" group in the Google Ads UI are easily achievable with the provided query examples and category/origin understanding.\u003c/p\u003e\n"]]],[],null,["# Customer goals\n\nEach [`CustomerConversionGoal`](/google-ads/api/reference/rpc/v21/CustomerConversionGoal)\ndetermines whether you want Google Ads to optimize for conversion actions with the\nspecified [`category`](/google-ads/api/reference/rpc/v21/ConversionAction#category) and\n[`origin`](/google-ads/api/reference/rpc/v21/ConversionAction#origin). Google Ads automatically creates\n`CustomerConversionGoals` as you add\n[`ConversionActions`](/google-ads/api/reference/rpc/v21/ConversionAction) to your account's\n[Google Ads conversion\ncustomer](/google-ads/api/docs/conversions/getting-started#enable_conversion_tracking) to\nensure that there's a `CustomerConversionGoal` for every combination of\n`category` and `origin` that's in use.\n\nSince Google Ads automatically handles the creation of `CustomerConversionGoal`\nobjects, you set the `biddable` attribute of each goal to specify whether a\nconversion goal is an [account-default\ngoal](//support.google.com/google-ads/answer/10995103#account_default). Set\n`biddable` to `true` if Google Ads should optimize for conversion actions with the\ngoal's `category` and `origin`, and set `biddable` to `false` otherwise. The\nvalues `true` and `false` are equivalent to the **Use as an account-default\ngoal** and **Do not use as an account-default goal** options, respectively, in\nthe [conversion action\nsettings](//support.google.com/google-ads/answer/10993988#edit_account_default).\n\nNew category and origin combinations\n------------------------------------\n\nIf a `ConversionAction` is created in your Google Ads conversion customer and\nthe `category` and `origin` combination of the new action doesn't exist on any\nother actions, Google Ads automatically creates a new `CustomerConversionGoal` for\nthe `category` and `origin` and sets the `biddable` attribute to `true` by\ndefault.\n\nHowever, Google Ads sets `biddable` to `false` by default for the following\n`category` and `origin` combinations:\n\n| [category](/google-ads/api/reference/rpc/v21/ConversionActionCategoryEnum.ConversionActionCategory) | [origin](/google-ads/api/reference/rpc/v21/ConversionOriginEnum.ConversionOrigin) |\n|-----------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------|\n| BEGIN_CHECKOUT | GOOGLE_HOSTED |\n| CONSIDERATION | GOOGLE_HOSTED |\n| CONTACT | GOOGLE_HOSTED |\n| CONVERTED_LEAD | GOOGLE_HOSTED |\n| ENGAGEMENT | GOOGLE_HOSTED |\n| GET_DIRECTIONS | GOOGLE_HOSTED |\n| PAGE_VIEW | GOOGLE_HOSTED |\n| QUALIFIED_LEAD | GOOGLE_HOSTED |\n| SIGNUP | GOOGLE_HOSTED |\n| PURCHASE | GOOGLE_HOSTED |\n| STORE_SALE | STORE |\n| STORE_VISIT | STORE |\n\nRetrieve customer goals\n-----------------------\n\nUse the following query to retrieve the list of `CustomerConversionGoals`\nfor your account. \n\n SELECT\n customer_conversion_goal.resource_name,\n customer_conversion_goal.category,\n customer_conversion_goal.origin,\n customer_conversion_goal.biddable\n FROM customer_conversion_goal\n\nA common example is the page view conversion goal, which is represented by a\ncombination of a [`category`](/google-ads/api/reference/rpc/v21/ConversionAction#category) of\n[`PAGE_VIEW`](/google-ads/api/reference/rpc/v21/ConversionActionCategoryEnum.ConversionActionCategory#page_view)\nand an [`origin`](/google-ads/api/reference/rpc/v21/ConversionAction#origin) of\n[`WEBSITE`](/google-ads/api/reference/rpc/v21/ConversionOriginEnum.ConversionOrigin#website).\n\nIn order to retrieve the conversion actions that belong to this conversion\ngoal---matching what you see in the Google Ads UI in the goals summary\npage---use the following query: \n\n SELECT\n conversion_action.category,\n conversion_action.origin,\n conversion_action.name\n FROM conversion_action\n WHERE conversion_action.category = 'PAGE_VIEW'\n AND conversion_action.origin = 'WEBSITE'\n AND conversion_action.status = 'ENABLED'\n\nAnother common example is getting the group shown in the Google Ads UI as **Other** .\nThis is done by setting the\n[`category`](/google-ads/api/reference/rpc/v21/ConversionAction#category) to [`DEFAULT`](/google-ads/api/reference/rpc/v21/ConversionActionCategoryEnum.ConversionActionCategory#default)."]]
