크리에이터 인사이트 기능을 사용하여 YouTube 크리에이터에 관한 인사이트를 확인하고 가져옵니다. 이는 타겟층과 관련성이 있는 크리에이터를 찾으려는 대행사 및 광고주에게 유용합니다.
API에는 네 가지 주요 기능이 있습니다.
- 크리에이터 검색 가능성: 특정 주제, 인구통계, 잠재고객 또는 크리에이터 속성에 대한 인기 크리에이터를 찾습니다.
- 크리에이터 브랜드 통계: 특정 브랜드와 관련된 크리에이터에 관한 통계를 가져옵니다.
- 크리에이터 통계: 구독자 수, 조회수, 시청자 인구통계와 같은 특정 YouTube 채널에 관한 통계를 가져옵니다.
- 인기 급상승 통계: 특정 잠재고객 또는 주제를 기반으로 특정 트렌드에 관한 통계를 가져옵니다.
자격 요건
ContentCreatorInsightsService.GenerateCreatorInsights은 비독점적이고 로열티가 없는 데이터 라이선스와 함께 제공되는 Google Ads API의 비공개 구성요소입니다. 계약을 체결한 파트너는 표준 Google Ads 클라이언트 라이브러리를 사용하여 YouTube 크리에이터와 콘텐츠를 살펴볼 수 있습니다. 자격 요건을 충족하려면 파트너가 다음 조건을 충족해야 합니다.
- API를 통합할 계획 도구 또는 사용자 인터페이스가 있어야 합니다.
- API를 사용하여 YouTube 콘텐츠와 크리에이터를 살펴보고 광고 기회를 찾으세요.
- 자격 요건을 충족하는지 사전 심사 평가를 완료하세요.
- 데이터 사용 요구사항을 준수하고 주기적인 데이터 감사에 응해야 합니다.
- 데이터 사용 요구사항을 법적으로 강제하는 데이터 라이선스 계약에 서명합니다.
- Google Ads API 서비스 약관에 동의합니다.
자세한 내용은 Google 담당자에게 문의하세요.
크리에이터 통계 생성
크리에이터 통계를 생성하려면 ContentCreatorInsightsService.GenerateCreatorInsights 메서드에 요청을 전송합니다. 이 메서드는 초당 5개의 쿼리 (QPS)로 제한되며, 크리에이터 검색 가능성, 크리에이터 브랜드 통계 또는 크리에이터 통계를 원하는지에 따라 세 가지 유형의 입력을 받습니다. 데이터를 가져올 국가 위치를 제공해야 합니다.
- 크리에이터 검색 가능성: 연령, 성별, 관심분야와 같은 시청자 속성 목록을 제공할 수 있습니다. API는 시청자가 이러한 속성과 일치하는 크리에이터 목록을 반환합니다. 크리에이터 속성을 입력하여 콘텐츠가 입력된 크리에이터 속성과 정확히 일치하는 크리에이터를 필터링할 수도 있습니다.
- 크리에이터 브랜드 통계: 브랜드를 입력하여 인기 크리에이터를 검색합니다. API는 일치하는 채널에 관한 유용한 정보를 반환합니다.
- 크리에이터 통계: YouTube 채널 ID 목록을 제공합니다. API는 이러한 특정 채널에 대한 유용한 정보를 반환합니다.
generateCreatorInsights 메서드는 GenerateCreatorInsightsResponse 객체를 반환합니다. 이 객체에는 YouTubeCreatorInsights 객체 목록이 포함되어 있습니다. 각 YouTubeCreatorInsights 객체에는 크리에이터에 관한 다음 정보가 포함됩니다.
- 크리에이터 이름
- YouTube 채널
- 총 크리에이터 측정항목
- YouTube 채널 통계 목록
YouTubeMetrics 객체에는 다음 측정항목이 포함됩니다.
- 구독자 수
- 조회수
- 동영상 개수
- 활성 Shorts 크리에이터 여부
YouTubeChannelInsights 객체에는 YouTube 채널에 관한 다음 정보가 포함됩니다.
- 채널 이름
- 채널 ID
- 채널 URL
- 채널 설명
- 채널 측정항목
- 채널 시청자 속성 (예: 연령, 성별, 사용자 관심분야 분류)
- 인기 동영상
- 채널 유형
인기 급상승 통계 생성
인기 급상승 통계를 생성하려면 ContentCreatorInsightsService.GenerateTrendingInsights 메서드에 요청을 보냅니다. 이 메서드는 초당 쿼리 수 (QPS)가 5개로 제한되며, 잠재고객 트렌드를 가져올지 주제 트렌드를 가져올지에 따라 두 가지 유형의 입력을 받습니다.
트렌드를 가져올 특정 국가 위치를 제공해야 합니다.
- 잠재고객 트렌드: 연령, 성별, 관심분야와 같은 잠재고객 속성 목록을 제공할 수 있습니다. API는 이러한 잠재고객의 인기 급상승 통계 목록을 반환합니다.
- 주제 트렌드: 콘텐츠 주제 목록을 제공합니다. API는 이러한 주제에 대한 인기 급상승 통계 목록을 반환합니다.