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

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

잠재고객 만들기

AudienceService를 사용하여 잠재고객을 만들고 업데이트합니다. 각 Audience에는 고유한 이름이 있어야 합니다. 이 재사용 가능한 잠재고객은 여러 잠재고객 측정기준의 조합을 허용합니다.

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

audience_id에 대한 MutateAudienceResult 검사

AudienceService.MutateAudiences로 잠재고객을 만들 때 각 작업은 MutateAudienceResult를 반환합니다. 반환된 resource_name을 파싱하여 audience_id을 가져오기 위해 MutateAudienceResult을 검사할 수 있으며, 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 기준에서 AdGroupCriterion.audience 필드 (ad_group_criterion.audience.audience)를 잠재고객 리소스 이름으로 설정하여 광고그룹 수준에서 잠재고객을 타겟팅할 수 있습니다.AudienceInfo.audience

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

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에서 오류를 반환합니다.