잠재고객 만들기 및 관리하기

Audience는 타겟팅된 세그먼트, 인구통계학적 타겟팅, 제외의 재사용 가능한 모음입니다. 잠재고객 타겟팅은 실적 최대화, 디맨드젠 캠페인, 앱 캠페인에서 지원됩니다. 디스플레이, 검색, 동영상, 호텔 또는 일반 쇼핑 캠페인에서 잠재고객 세그먼트를 직접 타겟팅하려면 잠재고객 세그먼트를 참고하세요.

잠재고객 만들기

AudienceService를 사용하여 잠재고객을 만들고 업데이트합니다. 각 Audience에는 고유한 이름이 있어야 합니다. 이 재사용 가능한 잠재고객을 사용하면 다음과 같이 여러 잠재고객 측정기준을 조합할 수 있습니다.

• 잠재고객 세그먼트
  • 사용자 목록 세그먼트
  • 관심분야 또는 구매 의도 세그먼트
  • 생애 주요 이벤트 세그먼트
  • 상세 인구통계 세그먼트
  • 맞춤 잠재고객 세그먼트 (CustomAudienceSegment)
• 연령: AgeDimension
• 성별: GenderDimension
• 가계 소득: HouseholdIncomeDimension
• 자녀 유무: ParentalStatusDimension

audience_id에 대해 MutateAudienceResult 검사

AudienceService.MutateAudiences로 잠재고객을 만들면 각 작업에서 MutateAudienceResult이 반환됩니다. MutateAudienceResult를 검사하여 반환된 resource_name를 파싱하여 audience_id를 가져올 수 있으며, response_content_type가 MUTABLE_RESOURCE로 설정된 경우 반환된 audience 객체에서 변경 가능한 필드 (예: name)를 검사할 수 있습니다.

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

잠재고객 가져오기

다른 리소스와 마찬가지로 GoogleAdsService.SearchStream를 사용하여 잠재고객의 속성을 가져올 수 있습니다.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

공유 대상 그룹

잠재고객은 캠페인 유형에 따라 다양한 방식으로 타겟팅할 수 있습니다.

애셋 그룹 신호

실적 최대화 캠페인은 AssetGroupSignal를 사용하여 잠재고객을 타겟팅합니다. 애셋 그룹 신호를 사용하여 잠재고객을 타겟팅하는 방법을 알아보려면 애셋 그룹 신호 가이드를 참고하세요.

광고그룹 기준

디맨드젠 캠페인과 앱 캠페인에서는 AdGroupCriterion을 사용하여 잠재고객을 타겟팅하거나 잠재고객 신호를 제공하는 잠재고객 광고 그룹 기준을 추가할 수 있습니다. AudienceInfo.audience 필드(ad_group_criterion.audience.audience)를 잠재고객 리소스 이름으로 설정하여 AdGroupCriterion.audience의 AudienceInfo 기준을 사용하여 광고 그룹 수준에서 잠재고객을 타겟팅할 수 있습니다.

잠재고객 타겟팅을 설정하는 단계는 다음과 같습니다.

AdGroup에서 잠재고객 타겟팅 사용 설정

광고 그룹이 생성될 때 use_audience_grouped을 true로 설정하여 AdGroup에서 잠재고객 타겟팅을 사용 설정해야 합니다. 이 설정은 광고 그룹을 만든 후에는 변경할 수 없습니다.

이렇게 하면 잠재고객과 함께 AdGroupCriterion를 추가할 수 있습니다. 이 값이 true로 설정되지 않으면 잠재고객을 타겟팅하는 후속 요청이 실패합니다.

AdGroupCriterion 만들기

AdGroupCriterion를 만들고 AdGroupCriterion.audience의 AudienceInfo.audience 필드를 잠재고객 만들기에서 만든 잠재고객의 리소스 이름으로 설정합니다.

선택사항: Campaign에서 잠재고객 타겟팅 사용 설정

캠페인을 만들 때 선택적으로 use_audience_grouped을 true로 설정할 수 있습니다. 이 설정을 사용하면 캠페인 수준에서 세그먼트와 인구통계를 제외하는 기준을 추가하려고 할 때 오류가 발생합니다.

권장사항

• 잠재고객을 사용하여 페르소나를 구축합니다. 잠재고객은 특정 페르소나를 타겟팅하기 위해 여러 세그먼트와 인구통계 기준을 중첩하려는 실적 최대화 캠페인, 디맨드젠 캠페인, 앱 캠페인에서 사용하는 것이 가장 좋습니다.
• 잠재고객 세그먼트를 사용하여 직접 타겟팅 디스플레이, 검색, 동영상, 호텔, 일반 쇼핑 캠페인의 경우 또는 리마케팅 목록과 같은 단일 세그먼트만 타겟팅해야 하는 경우 잠재고객 대신 잠재고객 세그먼트를 사용하세요.

일반적인 오류

Audience를 만들거나 업데이트할 때 Google Ads API는 요청을 검증하고 검증이 실패하면 AudienceError enum에서 오류를 반환합니다.