크리에이터 통계 기능을 사용하여 YouTube 크리에이터에 관한 통계를 확인하고 가져옵니다. 이는 타겟층과 관련된 크리에이터를 찾으려는 대행사 및 광고주에게 유용합니다.
API에는 다음과 같은 네 가지 주요 기능이 있습니다.
- 크리에이터 검색 가능성: 특정 주제, 인구통계, 잠재고객 또는 크리에이터 속성에 대한 인기 크리에이터를 찾습니다.
- 크리에이터 브랜드 통계: 특정 브랜드와 관련된 크리에이터에 관한 통계를 가져옵니다.
- 크리에이터 통계: 구독자 수, 조회수, 시청자 인구통계와 같은 특정 YouTube 채널에 관한 통계를 가져옵니다.
- 인기 급상승 통계: 특정 잠재고객 또는 주제를 기반으로 특정 트렌드에 관한 통계를 가져옵니다.
자격 요건
ContentCreatorInsightsService.GenerateCreatorInsights
는 비독점적이고 로열티가 없는 데이터 라이선스와 함께 제공되는 Google Ads API의 비공개 구성요소입니다. 계약을 체결한 파트너는 표준 Google Ads 클라이언트 라이브러리를 사용하여 YouTube 크리에이터와 콘텐츠를 살펴볼 수 있습니다.
자격 요건을 충족하려면 파트너가 다음 조건을 충족해야 합니다.
- Google Ads API를 통합할 계획 도구 또는 사용자 인터페이스가 있어야 합니다.
- API를 사용하여 YouTube 콘텐츠와 크리에이터를 살펴보고 잠재적인 광고 기회를 찾으세요.
- 자격 요건을 충족하는지 사전 심사 평가를 완료하세요.
- 데이터 사용 요구사항을 준수하고 주기적인 데이터 감사를 기꺼이 수락해야 합니다.
- 데이터 사용 요구사항을 법적으로 강제하는 데이터 라이선스 계약에 서명합니다.
- Google Ads API 서비스 약관에 동의합니다.
자세한 내용은 Google 담당자에게 문의하세요.
크리에이터 통계 생성
크리에이터 통계를 생성하려면 ContentCreatorInsightsService.GenerateCreatorInsights 메서드에 요청을 전송합니다. 이 메서드는 초당 5개의 쿼리 (QPS)로 제한되며, 크리에이터 검색 가능성, 크리에이터 브랜드 통계 또는 크리에이터 통계를 원하는지에 따라 세 가지 유형의 입력을 받습니다. 데이터를 가져올 국가 위치를 제공해야 합니다.
크리에이터 검색 가능성: 연령, 성별, 사용자 관심분야 (관심분야, 구매 의도, 생애 주요 이벤트 잠재고객 포함)와 같은 잠재고객 속성 목록을 제공할 수 있습니다. API는 잠재고객이 이러한 속성과 일치하는 크리에이터 목록을 반환합니다. 크리에이터 속성을 제공하여 입력한 크리에이터 속성과 콘텐츠가 정확히 일치하는 크리에이터를 필터링할 수도 있습니다.
관심분야의
KNOWLEDGE_GRAPH와 같이 속성을 원하는 측정기준을 제공하여AudienceInsightsService.ListAudienceInsightsAttributes를 사용하여 사용 가능한 잠재고객 속성을 가져올 수 있습니다.Google Ads API v23부터
audience_combinations를 사용하여 복잡한 잠재고객 속성 관계를 지정할 수 있습니다. 이 필드를 사용하면audience_attributes로는 불가능한 불리언 로직 (AND/OR)으로 잠재고객을 정의할 수 있습니다.audience_attributes는 통합된 (OR로 결합됨) 속성 목록을 기반으로 타겟팅하는 데 적합하지만 (예: '스포츠' 또는 '여행' 또는 ...에 관심이 있는 사용자),audience_combinations는 더 세부적인 제어를 제공합니다.audience_combinations내의 각InsightsAudienceAttributeGroup는 속성을 논리적 OR로 결합합니다. 이러한 그룹은 논리적 AND로 결합됩니다.예를 들어 ("스킨케어" 또는 "헤어케어")에 관심이 있고 "화장품"에도 관심이 있는 잠재고객을 타겟팅하려면
audience_combinations에서 두 개의InsightsAudienceAttributeGroup항목을 사용합니다. '스킨 케어', '헤어 케어', '화장품'은 관심 주제이며, 지식 그래프 항목 (예: 화장품의 경우/m/014trl)으로 표현됩니다. 첫 번째 그룹에는 '스킨케어' 및 '헤어케어'의 지식 그래프 항목 속성이 포함되고 두 번째 그룹에는 '화장품'의 지식 그래프 항목 속성이 포함됩니다.audience_attributes에 지식 그래프 항목, 제품 및 서비스 카테고리 또는 사용자 관심분야를 지정하면audience_combinations를 사용할 수 없습니다.audience_combinations를 사용하는 경우audience_attributes가 아닌audience_combinations내에서 이러한 속성을 지정해야 합니다. 하지만audience_combinations와 함께 인구통계와 같은 다른 속성 유형에audience_attributes를 계속 사용할 수 있습니다.크리에이터 브랜드 통계: 인기 크리에이터를 검색할 브랜드를 제공합니다. API는 일치하는 채널에 관한 유용한 정보를 반환합니다.
크리에이터 통계: YouTube 채널 ID 목록을 제공합니다. API는 이러한 특정 채널에 대한 유용한 정보를 반환합니다.
generateCreatorInsights 메서드는 GenerateCreatorInsightsResponse 객체를 반환합니다. 이 객체에는 YouTubeCreatorInsights 객체 목록이 포함되어 있습니다. 각 YouTubeCreatorInsights 객체에는 크리에이터에 관한 다음 정보가 포함됩니다.
- 크리에이터 이름
- YouTube 채널
- 총 크리에이터 측정항목
- YouTube 채널 통계 목록
YouTubeMetrics 객체에는 다음 측정항목이 포함됩니다.
- 구독자 수
- 조회수
- 동영상 개수
- 활동 중인 Shorts 크리에이터
- 파트너십 기회 (v23부터)
YouTubeChannelInsights 객체에는 YouTube 채널에 관한 다음 정보가 포함됩니다.
- 채널 이름
- 채널 ID
- 채널 URL
- 채널 설명
- 채널 측정항목
채널 시청자 속성 (예: 연령, 성별, 사용자 관심분야)
분류)
인기 동영상
채널 유형
채널 콘텐츠와 연결된 언어
관련성 점수 (주제 트렌드 검색만 해당)
인기 급상승 통계 생성
인기 급상승 통계를 생성하려면 ContentCreatorInsightsService.GenerateTrendingInsights 메서드에 요청을 보냅니다. 이 메서드는 초당 쿼리 수 (QPS)가 5개로 제한되며, 잠재고객 트렌드를 가져올지 주제 트렌드를 가져올지에 따라 두 가지 유형의 입력을 사용합니다.
트렌드를 가져올 특정 국가 위치를 제공해야 합니다.
잠재고객 동향: 연령, 성별, 사용자 관심분야 (관심분야, 구매 의도, 생애 주요 이벤트 잠재고객 포함)와 같은 잠재고객 속성 목록을 제공할 수 있습니다. API는 비교 기간 동안 추세 값의 변화율과 같은 측정항목을 포함하여 해당 잠재고객의 인기 급상승 통계 목록을 반환합니다.
관심분야의
KNOWLEDGE_GRAPH와 같이 속성을 원하는 측정기준을 제공하여AudienceInsightsService.ListAudienceInsightsAttributes를 사용하여 사용 가능한 잠재고객 속성을 가져올 수 있습니다.Google Ads API v23부터
audience_combinations를 사용하여 복잡한 잠재고객 속성 관계를 지정할 수 있습니다. 이 필드를 사용하면audience_attributes로는 불가능한 불리언 로직 (AND/OR)으로 잠재고객을 정의할 수 있습니다.audience_attributes는 통합된 (OR로 결합됨) 속성 목록을 기반으로 타겟팅하는 데 적합하지만 (예: '스포츠' 또는 '여행' 또는 ...에 관심이 있는 사용자),audience_combinations는 더 세부적인 제어를 제공합니다.audience_combinations내의 각InsightsAudienceAttributeGroup는 속성을 논리적 OR로 결합합니다. 이러한 그룹은 논리적 AND로 결합됩니다.예를 들어 ("스킨케어" 또는 "헤어케어")에 관심이 있고 "화장품"에도 관심이 있는 잠재고객을 타겟팅하려면
audience_combinations에서 두 개의InsightsAudienceAttributeGroup항목을 사용합니다. '스킨 케어', '헤어 케어', '화장품'은 관심 주제이며, 지식 그래프 항목 (예: 화장품의 경우/m/014trl)으로 표현됩니다. 첫 번째 그룹에는 '스킨케어' 및 '헤어케어'의 지식 그래프 항목 속성이 포함되고 두 번째 그룹에는 '화장품'의 지식 그래프 항목 속성이 포함됩니다.audience_attributes에 지식 그래프 항목, 제품 및 서비스 카테고리 또는 사용자 관심분야를 지정하면audience_combinations를 사용할 수 없습니다.audience_combinations를 사용하는 경우audience_attributes가 아닌audience_combinations내에서 이러한 속성을 지정해야 합니다. 하지만audience_combinations와 함께 인구통계와 같은 다른 속성 유형에audience_attributes를 계속 사용할 수 있습니다.주제 트렌드: 콘텐츠 주제 목록을 제공합니다. API는 비교 기간 동안 추세 값의 변화율과 같은 측정항목을 포함하여 이러한 주제에 대한 인기 급상승 통계 목록을 반환합니다.