크리에이터 통계 기능을 사용하여 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를 설정하여 응답에서 선택적
기능과 추가 데이터를 요청할 수 있습니다.
예를 들어 LOCAL_CREATOR_DATA enum 값을 supplemental_data 필드에 추가하여 현지 크리에이터 데이터를 요청할 수 있습니다. search_topics를 사용하여 크리에이터를 검색하고 주제가 CREATOR_TOPIC_INSIGHTS 기능이 태그된 지식 그래프 항목인 경우 API는 위치 데이터 공유에 동의한 현지 크리에이터로 응답의 local_creator_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 또는
BRAND_SENTIMENT_DATA로 설정하여
인기 급상승 통계에서 선택적 기능을 요청할 수 있습니다.
인기 급상승 요청에서 search_topics를 사용하는 경우 supplemental_data를
LOCAL_CREATOR_DATA로 설정하면 위치 데이터 공유에 동의한 요청된 주제의 관련 현지 크리에이터로 반환된 TrendInsight 객체의
related_local_creators
필드가 채워집니다. 현지 크리에이터 검색에는 동일한 정의 및 제약 조건 (예: sub_country_locations와 호환되지 않음)이 적용됩니다.
인기 급상승 요청에서 search_topics를 사용하는 경우 supplemental_data를
BRAND_SENTIMENT_DATA로 설정하면 요청된 지식 그래프 항목 주제에 BRAND 기능이 있을 때 반환된 TrendInsight 객체의
brand_sentiment_insights
필드가 채워집니다. 브랜드
주제는
BRAND
기능이 태그된 항목입니다.
ListAudienceInsightsAttributes 메서드를 사용하여 지원되는 항목 기능을 가져올 수 있습니다.
브랜드 의견 측정에는 Gemini 기반 AI 모델을 사용하여 브랜드와 관련된 YouTube 동영상 콘텐츠를 분석하고 의견을 긍정적, 부정적 또는 중립적으로 분류하는 작업이 포함됩니다. 동영상 콘텐츠 자체만 분석되며 사용자 댓글은 포함되지 않습니다.
인기 급상승 통계 메타데이터
GenerateTrendingInsights 메서드는 각각 다음을 포함하는 TrendInsight 객체 목록을 반환합니다.
trend_attribute: 트렌드의 기본AudienceInsightsAttributeMetadata입니다.trend_metrics: 비교 기간 동안의 백분율 변화와 같은 트렌드의 측정항목입니다.trend_data_points: 트렌드의 이전 데이터 포인트입니다.search_topics를 사용하는 트렌드에만 채워집니다.related_videos: 트렌드 주제와 연결된 인기 동영상의AudienceInsightsAttributeMetadata객체 목록입니다.search_topics를 사용하는 트렌드에만 채워집니다. 이러한 속성의 경우 중첩된YouTubeVideoAttributeMetadata이 채워집니다. 여기에는 동영상 수준 메타데이터 (예: 동영상 URL, 썸네일 URL, 조회수 또는 좋아요 수)와 채널 수준 메타데이터 (예: 채널 ID, 이름, URL)가 포함됩니다.brand_sentiment_insights: 트렌드의BrandSentimentInsight객체 목록입니다. 트렌드 요청에서search_topics를 사용하고, 지식 그래프 항목 주제에BRAND기능이 있으며,BRAND_SENTIMENT_DATA가supplemental_data에서 요청된 경우에만 채워집니다. 각BrandSentimentInsight객체에는 다음이 포함됩니다.month: 브랜드 의견이 나타내는 월입니다(YYYY-MM형식).has_insufficient_data: 브랜드 의견을 계산하기에 데이터가 부족한지 여부입니다.sentiment_distributions: 각 의견으로 브랜드에 해당하는 동영상의 조회수 비율로 계산된 긍정적, 부정적, 중립적 의견의 분포입니다.sentiment_summaries: 각 의견의 샘플 동영상과 함께 브랜드와 관련된 콘텐츠의 긍정적 및 부정적 측면에 관한 AI 생성 요약입니다. 요약은 중립적 의견이 아닌 긍정적 및 부정적 의견에 대해서만 생성됩니다.