CustomerLifecycleGoal
및
CampaignLifecycleGoal
의 리소스
Google Ads API를 사용하여 고객 수명 주기와 관련된 목표를 구성합니다. v15부터
Google Ads API를 통한 고객 획득
목표를 효율적으로
Google Ads 검색 및 실적 최대화 캠페인을 통해 신규 고객 획득
있습니다.
Google Ads 계정에서 교차 계정 전환 추적을 사용 중인 경우 Google Ads 전환에서 고객 수명 주기 목표를 구성해야 함 고객 직접 연결하는 것이 아니라 Google Ads 계정에 직접 연결할 수 있습니다. 여전히 캠페인 수명 주기 목표에 따라 변경할 수 있습니다. 이 방법은 Google 애널리틱스 계정의 기타 목표를 교차 계정 전환 추적을 사용하는 것이 좋습니다
만들기 및 업데이트 작업 처리 (v15만 해당)
Google Ads API v15에서 지원되는 연산은
CustomerLifecycleGoalService
및
CampaignLifecycleGoalService
Google Ads API의 다른 서비스와 약간 다릅니다. 각 포드에 별도의
create
및 update
연산, v15
CustomerLifecycleGoalOperation
및
CampaignLifecycleGoalOperation
create
작업만 가지며, 개발자는
update_mask
:
v15를 사용하여 수명 주기 목표를 만들려면
create
에 목표를 채우지만resource_name
을 설정하지 말고update_mask
연산으로 해석됩니다.v15를 사용하여 수명 주기 목표를 업데이트하려면
create
에 목표를 채우고 다음과 같이 설정합니다. 목표의resource_name
를 설정하고update_mask
를 설정하여 선택합니다.
고객 수명 주기 목표 구성
고객 수준에서
CustomerLifecycleGoal
할 수 있는 작업:
Google Ads 계정당 CustomerLifecycleGoal
최대 1개 이
customer_acquisition_goal_value_settings.value
필드는 추가
신규 고객의 첫 구매 전환에 추가할 가치 조정 다음과 같은 작업을 할 수 있습니다.
customer_acquisition_goal_value_settings.high_lifetime_value
읽기
하지만 Google Ads API에서는 이 필드를 변경할 수 없습니다.
잠재고객 분류
Google Ads API v17부터는
분류할 UserListCustomerType
리소스
고객 수명 주기 목표에 맞게
잠재고객을 최적화할 수 있습니다 에서 직접 잠재고객 구성
CustomerLifecycleGoal
리소스는
지원 중단되었습니다. 세부정보는 다음과 같습니다.
- v17 이전 버전:
<ph type="x-smartling-placeholder">
- </ph>
existing_user_lists
컬렉션에 사용자 목록 추가CustomerLifecycleGoal
입니다.
- v17부터:
<ph type="x-smartling-placeholder">
- </ph>
- 각 사용자 목록을 하나 이상의 카테고리와 연결합니다.
사용자 목록 및 카테고리의 조합별
UserListCustomerType
- 각 사용자 목록을 하나 이상의 카테고리와 연결합니다.
사용자 목록 및 카테고리의 조합별
Google Ads API v17 이상
사용
UserListCustomerTypeService
(으)로
UserListCustomerType
인스턴스를 만듭니다.
이미
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
필드가 있으면 계정에 관련 UserListCustomerType
이(가) 이미 포함됩니다.
인스턴스
UserListCustomerTypeService
는 create
및 remove
만 지원합니다.
연산이므로 기존 UserListCustomerType
를 업데이트하려면 다음을 실행합니다.
삭제한 다음 필요한 업데이트가 적용된 새 계정을 만들어야 합니다.
UserListCustomerType
는 하나의 사용자 목록에만 할당할 수 있지만
사용자 목록에는 연결된 UserListCustomerType
인스턴스가 여러 개 있을 수 있습니다.
UserListCustomerType
간에 충돌이 없는 한
인스턴스 UserListCustomerType
인스턴스를
다음과 같은 조합을 통해
customer_type_category
한 사용자에게 광고를 게재할 경우
UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
오류:
처음 customer_type_category |
두 번째 customer_type_category |
---|---|
구매자 | CONVERTED_LEADS |
구매자 | QUALIFIED_LEADS |
구매자 | CART_ABANDONERS |
CONVERTED_LEADS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CART_ABANDONERS |
Google Ads API v16 이하
lifecycle_goal_customer_definition_settings.existing_user_lists
의 의미 기존 고객이 포함된 사용자 목록을 지정합니다.이
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
필드는 평생 가치가 높은 고객이 포함된 사용자 목록을 나타냅니다. 나 는 이 필드를 읽을 수 있지만 Google Ads API에서는 변경할 수 없습니다.
공유된 리소스 동작
2025년 1월에 Google Ads API v16이 지원 종료될 때까지는
UserListCustomerType
및 잠재고객 분류 필드
CustomerLifecycleGoal
는 공유 리소스입니다. 즉,
v17 이상에서 인스턴스 UserListCustomerType
개가 수정됩니다.
v16 및 이전 버전의 CustomerLifecycleGoal
인스턴스에 추가했으며, 그 반대의 경우도 마찬가지입니다.
알 수 있습니다.
두 리소스의 필드가 매핑되는 방식은 다음과 같습니다.
v16에서 `CustomerLifecycleGoal` 필드 변형 | v17에서 `UserListCustomerType` 의 부작용 |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists
|
UserListCustomerType 인스턴스를 만들거나 삭제합니다. 이
user_list 필드에 연결된 사용자 목록 리소스가 포함됨
있습니다.
|
v17에서 `UserListCustomerType` 변형 | v16에서 `CustomerLifecycleGoal` 필드의 부작용 |
---|---|
UserListCustomerType 인스턴스를 만들거나 삭제합니다.
|
개별 리소스 이름은
lifecycle_goal_customer_definition_settings.existing_user_lists
|
UserListCustomerType 인스턴스를 만들거나 삭제합니다.
customer_type_category 는 다음과 같이 설정됩니다.
<ph type="x-smartling-placeholder">HIGH_VALUE_CUSTOMERS </ph>
|
개별 리소스 이름은
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
|
캠페인 수명 주기 목표 구성
캠페인 수준에서
CampaignLifecycleGoal
할 수 있는 작업:
캠페인당 최대 1개의 CampaignLifecycleGoal
캠페인 수준 목표의 customer_acquisition_goal_settings
필드를 사용하면 다음을 수행할 수 있습니다.
캠페인의 최적화 모드를 설정하고 값 설정을 재정의합니다.
삭제할 수 있습니다
optimization_mode
는 다음 값 중 하나일 수 있습니다.
TARGET_ALL_EQUALLY
- 캠페인은 신규 고객과 기존 고객을 동일하게 타겟팅합니다. 이는 기본값입니다. 최적화 모드입니다.
BID_HIGHER_FOR_NEW_CUSTOMERS
- 캠페인이 신규 고객과 기존 고객을 모두 타겟팅하지만
다음에 속하지 않는
existing_user_lists
입니다. TARGET_NEW_CUSTOMERS
- 캠페인이 신규 고객만 타겟팅합니다.
value_settings
는 다음과 동일합니다.
고객 수준 목표에 대해 customer_acquisition_goal_value_settings
사용
캠페인 수준 설정을 사용하여 특정 캠페인의 값을 재정의합니다.
수명 주기 목표 가져오기
Google Ads API의 다른 리소스와 마찬가지로 search
또는 searchStream
를 사용합니다.
가져올 GoogleAdsService
메서드
수명 주기 목표를 설정합니다
다음 쿼리는 모든 CustomerLifecycleGoal
Google Ads 계정:
SELECT
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal
마찬가지로 다음 쿼리는 모든
CampaignLifecycleGoal
:
SELECT
campaign_lifecycle_goal.campaign,
campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value
FROM campaign_lifecycle_goal