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

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

잠재고객 만들기

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

MutateAudienceResult에서 audience_id를 검사합니다.

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

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
요약 요청의 잠재고객 세그먼트를 찾을 수 없습니다.
일반적인 원인 존재하지 않거나 액세스할 수 없는 세그먼트 ID를 참조합니다.
대응 방법 잠재고객을 만들거나 업데이트하기 전에 모든 세그먼트 ID가 존재하고 액세스 가능한지 확인합니다.
예방법 잠재고객에 포함하기 전에 세그먼트 ID를 검증합니다.
DIMENSION_INVALID
요약 잠재고객 측정기준이 잘못되었습니다.
일반적인 원인 exclusion_dimension에 detailed_demographic 포함
대응 방법 exclusion_dimension의 제외에는 user_list만 사용하세요.
예방법 잠재고객을 만들거나 업데이트할 때 exclusion_dimension에 user_list만 사용되는지 확인합니다.
DUPLICATE_AUDIENCE_SEGMENT
요약 잠재고객에 중복 세그먼트가 포함되어 있습니다.
일반적인 원인 동일한 잠재고객에 동일한 세그먼트를 여러 번 추가합니다.
대응 방법 잠재고객 정의에서 중복 세그먼트를 삭제합니다.
예방법 잠재고객의 모든 세그먼트가 고유해야 합니다.
NAME_ALREADY_IN_USE
요약 잠재고객 이름이 이미 사용 중입니다.
일반적인 원인 동일한 이름으로 여러 잠재고객을 만들려고 합니다.
대응 방법 잠재고객을 만들 때 고유한 이름을 사용합니다.
예방법 새 잠재고객을 만들기 전에 기존 잠재고객 이름을 확인하세요.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
요약 잠재고객에 동일한 유형의 측정기준이 너무 많이 포함되어 있습니다.
일반적인 원인 하나의 잠재고객에 동일한 유형의 여러 측정기준 (예: 여러 연령 측정기준)을 포함합니다.
대응 방법 잠재고객 정의에 각 유형의 측정기준이 하나만 포함되어 있는지 확인합니다.
예방법 잠재고객 정의를 검토하여 중복된 측정기준 유형이 포함되지 않았는지 확인하세요.
TOO_MANY_SEGMENTS
요약 잠재고객에 세그먼트가 너무 많습니다.
일반적인 원인 잠재고객에서 허용되는 최대 세그먼트 수를 초과했습니다.
대응 방법 잠재고객 정의의 세그먼트 수를 줄입니다.
예방법 잠재고객당 세그먼트 수 제한에 관한 문서를 확인하세요.