크리에이터 통계 기능을 사용하여 YouTube 크리에이터에 대한 통계를 알아보고 가져옵니다. 이는 타겟 잠재고객과 관련된 크리에이터를 찾으려는 대행사 및 광고주에게 유용할 수 있습니다.
API에는 네 가지 주요 기능이 있습니다.
- 크리에이터 검색 가능성: 지정된 주제, 인구통계, 잠재고객 또는 크리에이터 속성과 관련된 크리에이터를 찾습니다.
- 크리에이터 주제 통계: 지정된 주제에 관한 콘텐츠를 제작하는 관련 크리에이터에 대한 통계를 가져옵니다.
- 크리에이터 통계: 구독자 수, 조회수, 잠재고객 인구통계와 같은 특정 YouTube 채널에 대한 통계를 가져옵니다.
- 인기 급상승 통계: 특정 잠재고객 또는 주제를 기반으로 특정 트렌드에 대한 통계를 가져옵니다.
보충 데이터를 요청하여 주제 기반 크리에이터 검색 또는 인기 급상승 통계를 사용할 때 로컬 크리에이터 검색 (특정 국가에 거주하거나 해당 국가에서 게시하고 해당 국가에서 조회되는 크리에이터 찾기)이 지원됩니다.
자격요건
GenerateCreatorInsights 는 비독점적이고 로열티가 없는 데이터 라이선스와 함께 제공되는 Google Ads API의 비공개 구성요소입니다. 서명된
파트너는 표준 Google Ads 클라이언트 라이브러리를 사용하여
YouTube 크리에이터와 콘텐츠를 살펴볼 수 있습니다. 자격을 갖추려면 파트너는 다음 조건을 충족해야 합니다.
- Google Ads API를 통합할 계획 도구 또는 사용자 인터페이스가 있어야 합니다.
- API를 사용하여 잠재적인 광고 기회를 위해 YouTube 콘텐츠와 크리에이터를 살펴봅니다.
- 자격 요건을 충족하는지 확인하기 위해 사전 심사 평가를 완료합니다.
- 데이터 사용 요구사항을 준수하고 주기적인 데이터 감사를 받을 의향이 있어야 합니다.
- 데이터 사용 요구사항을 법적으로 시행하는 데이터 라이선스 계약에 서명합니다.
- Google Ads API 서비스 약관에 동의합니다.
자세한 내용은 Google 담당자에게 문의하세요.
크리에이터 통계 생성
크리에이터 통계를 생성하려면
GenerateCreatorInsights 메서드에 요청을 보냅니다. 이 메서드는 초당 쿼리 수 (QPS)가 5개로 제한됩니다. 크리에이터 검색 가능성을 실행할지, 주제별로 관련 크리에이터를 검색할지, 크리에이터 통계를 가져올지에 따라 다양한 유형의 입력을 사용합니다. 데이터를 가져올 국가 위치를 제공해야 합니다.
크리에이터 검색 가능성: 연령, 성별, 사용자 관심분야 (관심분야, 구매 의도, 생애 주요 이벤트 잠재고객 포함)와 같은 잠재고객 속성 목록을 제공할 수 있습니다. API는 잠재고객이 이러한 속성과 일치하는 크리에이터 목록을 반환합니다. 크리에이터 속성을 제공하여 입력한 크리에이터 속성과 콘텐츠가 구체적으로 일치하는 크리에이터를 필터링할 수도 있습니다.
관심분야 주제의
KNOWLEDGE_GRAPH와 같이 속성을 원하는 측정기준을 제공하여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를 계속 사용할 수 있습니다.크리에이터 주제 통계:
search_topics필드를 사용하여 콘텐츠 주제 목록을 제공합니다. API는 지정된 주제에 관한 콘텐츠를 제작하는 관련 크리에이터를 반환합니다. 가져온 데이터는 에 지정된 국가를 기반으로 합니다country_locations. 이 옵션을 사용하면 한 국가만 검색할 수 있습니다.SearchTopics필드에서 지원되는 항목에는CONTENT_TRENDING_INSIGHTS또는CREATOR_TOPIC_INSIGHTS기능이 태그되어 있어야 합니다.ListAudienceInsightsAttributes메서드를 사용하여 지원되는 항목 기능을 가져옵니다.참고:
search_brand옵션은 v24.2에서 지원 중단되었으며 v25에서 삭제되었습니다. 대신search_topics를 사용하세요.크리에이터 통계:
search_channels필드를 사용하여 YouTube 채널 ID 목록을 제공합니다. API는 이러한 특정 채널에 대한 통계를 반환합니다.
보충 데이터 및 로컬 크리에이터
기본적으로 핵심 통계 데이터만 반환됩니다. 반복 필드
supplemental_data를 설정하여 응답에서 선택적
기능과 추가 데이터를 요청할 수 있습니다.
예를 들어 supplemental_data 필드에 LOCAL_CREATOR_DATA enum 값을 추가하여 로컬 크리에이터 데이터를 요청할 수 있습니다. `search_topics`를 사용하여 크리에이터를 검색하고 주제가 지식 그래프 항목인 경우 API는 위치 데이터 공유에 동의한 로컬 크리에이터로 응답의 local_creator_insights 필드를 채웁니다.search_topicsCREATOR_TOPIC_INSIGHTS
로컬 크리에이터 검색에 관한 다음 사양에 유의하세요.
- 정의: '로컬 크리에이터'는 선택한 국가에 거주하거나 해당 국가에서 게시하고 해당 국가에서 조회되는 크리에이터입니다.
- 제약 조건: 요청에서
sub_country_locations가 설정된 경우 로컬 크리에이터 검색이 지원되지 않습니다. - 기능: 지원되는 지식 그래프
항목 목록과 해당 기능을
ListAudienceInsightsAttributes사용하여 가져올 수 있습니다.
generateCreatorInsights 메서드는 GenerateCreatorInsightsResponse 객체를 반환합니다. 이 객체에는 다음 필드가 포함됩니다.
creator_insights: 핵심 기준과 일치하는YouTubeCreatorInsights객체 목록입니다.local_creator_insights: 로컬 크리에이터의YouTubeCreatorInsights객체 목록입니다. 이는LOCAL_CREATOR_DATA가 요청되고 사용된 기준이search_topics인 경우에만 채워집니다.
각 YouTubeCreatorInsights 객체에는 크리에이터에 관한 다음 정보가 포함됩니다.
- 크리에이터 이름
- YouTube 채널
- 총 크리에이터 측정항목
- YouTube 채널 통계 목록
YouTubeMetrics 객체에는 다음 측정항목이 포함됩니다.
- 구독자 수
- 조회수
- 동영상 개수
- 활성 Shorts 크리에이터 여부
- 파트너 협력 기회 (v23부터)
크리에이터가 오리지널 브랜드 콘텐츠 파트너십에 적합한지 확인하려면
partnership_opportunities를 확인하세요.
목록에
CREATOR_PARTNERSHIPS 값이 포함되어 있으면 크리에이터가 적합합니다.
YouTubeChannelInsights 객체에는 YouTube 채널에 관한 다음 정보가 포함됩니다.
- 채널 이름
- 채널 ID
- 채널 URL
- 채널 설명
- 채널 측정항목
- 채널 잠재고객 속성 (예: 연령, 성별, 사용자 관심분야 분석)
- 인기 동영상
- 채널 유형
- 채널 콘텐츠와 연결된 언어
- 관련성 점수 (주제 트렌드 검색에만 해당)
- 크리에이터가 공개 외 측정항목 공유에 동의했는지 여부
인기 급상승 통계 생성
인기 급상승 통계를 생성하려면
GenerateTrendingInsights 메서드에 요청을 보냅니다. 이 메서드는 초당 쿼리 수 (QPS)가 5개로 제한됩니다. 잠재고객 트렌드를 가져올지 주제 트렌드를 가져올지에 따라 두 가지 유형의 입력을 사용합니다. 트렌드를 가져올 특정 국가 위치를 제공해야 합니다.
잠재고객 트렌드: 연령, 성별, 사용자 관심분야 (관심분야, 구매 의도, 생애 주요 이벤트 잠재고객 포함)와 같은 잠재고객 속성 목록을 제공할 수 있습니다. API는 비교 기간 동안 트렌드 값의 변화율과 같은 측정항목을 포함하여 이러한 잠재고객의 인기 급상승 통계 목록을 반환합니다.
관심분야 주제의
KNOWLEDGE_GRAPH와 같이 속성을 원하는 측정기준을 제공하여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를 계속 사용할 수 있습니다.KNOWLEDGE_GRAPH속성에는 하나 이상의InsightsKnowledgeGraphEntityCapabilities태그가 있습니다. 인기 급상승 통계에 지원되는 속성에는 응답 메타데이터에 관련 태그가 있습니다.ContentCreatorInsightsService에 액세스할 수 있는 개발자는AudienceInsightsService.ListAudienceInsightsAttributes에도 자동으로 액세스할 수 있습니다.AudienceInsightsService의 다른 엔드포인트에는 독립적인 허용 목록 프로세스가 필요합니다.ListAudienceInsightsAttributes에 관한 추가 문서는 잠재고객 통계 가이드에서 확인할 수 있습니다.주제 트렌드: 콘텐츠 주제 목록을 제공합니다. API는 비교 기간 동안 트렌드 값의 변화율과 같은 측정항목을 포함하여 이러한 주제의 인기 급상승 통계 목록을 반환합니다.
보충 데이터 및 로컬 크리에이터
크리에이터 통계를 생성하는 것과 마찬가지로 반복 필드
를
supplemental_data LOCAL_CREATOR_DATA로 설정하여 인기 급상승 통계에서 선택적 기능을 요청할 수 있습니다.
인기 급상승 요청에서 search_topics를 사용하는 경우 위치 데이터 공유에 동의한 요청된 주제의 관련 로컬 크리에이터로 반환된 TrendInsight 객체의
related_local_creators
필드가 채워집니다. 로컬 크리에이터 검색에는 동일한 정의 및 제약 조건 (예: sub_country_locations와 호환되지 않음)이 적용됩니다.
인기 급상승 통계 메타데이터
GenerateTrendingInsights 메서드는 각각 다음을 포함하는 TrendInsight 객체 목록을 반환합니다.
trend_attribute: 트렌드의 기본AudienceInsightsAttributeMetadata입니다.trend_metrics: 비교 기간 동안의 변화율과 같은 트렌드의 측정항목입니다.trend_data_points: 트렌드의 이전 데이터 포인트입니다.search_topics를 사용하는 트렌드에만 채워집니다.related_videos: 트렌드 주제와 관련된 인기 동영상의AudienceInsightsAttributeMetadata객체 목록입니다.search_topics를 사용하는 트렌드에만 채워집니다. 이러한 속성의 경우 중첩된YouTubeVideoAttributeMetadata이 채워집니다. 여기에는 동영상 수준 메타데이터 (예: 동영상 URL, 썸네일 URL, 조회수 또는 좋아요 수)와 채널 수준 메타데이터 (예: 채널 ID, 이름, URL)가 포함됩니다.