ContentCreatorInsightsService의 크리에이터 통계 기능을 사용하여 YouTube 크리에이터에 대한 통계를 검색하고 가져옵니다.
이 서비스는 대행사와 광고주가 타겟층과 관련성이 높은 크리에이터를 찾는 데 도움이 됩니다.
API에는 다음과 같은 네 가지 주요 기능이 있습니다.
- 크리에이터 검색 가능성: 특정 주제, 인구통계, 시청자층 또는 크리에이터 속성에 맞는 관련 크리에이터를 찾습니다.
- 크리에이터 주제 통계: 지정된 주제에 관한 콘텐츠를 제작하는 관련 크리에이터에 관한 통계를 가져옵니다.
- 크리에이터 통계: 구독자 수, 조회수, 시청자 인구통계와 같은 특정 YouTube 채널에 대한 통계를 가져옵니다.
- 트렌드 통계: 특정 잠재고객 또는 주제를 기반으로 특정 트렌드에 대한 통계를 가져옵니다.
추가 데이터를 요청하여 주제 기반 크리에이터 검색 또는 인기 급상승 통계를 사용하는 경우 현지 크리에이터 검색 (특정 국가에 거주하거나 특정 국가에서 게시하고 해당 국가에서 시청되는 크리에이터 찾기)이 지원됩니다. 추가 데이터를 요청하여 주제 기반 트렌드 통계에 대한 브랜드 감정 통계를 요청할 수도 있습니다.
자격요건
GenerateCreatorInsights는 비독점적, 로열티 없는 데이터 라이선스로 제공되는 Google Ads API의 비공개 구성요소입니다. 서명된 파트너는 표준 Google Ads 클라이언트 라이브러리를 사용하여 YouTube 크리에이터와 콘텐츠를 탐색할 수 있습니다. 자격 요건을 충족하려면 파트너가 다음 조건을 충족해야 합니다.
- Google Ads API를 통합하는 계획 도구 또는 사용자 인터페이스가 있어야 합니다.
- API를 사용하여 잠재적인 광고 기회를 위해 YouTube 콘텐츠와 크리에이터를 탐색합니다.
- 사전 심사 평가를 완료하여 자격 요건을 확인합니다.
- 데이터 사용 요구사항을 준수하고 정기적인 데이터 감사를 받습니다.
- Google Ads API 서비스 약관 및 관련 데이터 사용 정책에 동의합니다.
자세한 내용은 Google 담당자에게 문의하세요.
크리에이터 통계 생성
크리에이터 통계를 생성하려면 GenerateCreatorInsights 메서드에 요청을 보냅니다. 이 메서드의 한도는 초당 쿼리 수 (QPS) 5개입니다. 크리에이터 검색 가능성, 주제 기반 크리에이터 검색, 채널별 크리에이터 통계 중 무엇을 원하는지에 따라 다양한 기준을 허용합니다. country_locations에 대상 국가 위치를 제공해야 합니다.
크리에이터 검색 가능성 (
search_attributes):search_attributes필드를 사용하여 연령, 성별, 사용자 관심분야 (관심분야, 구매 의도, 생애 주요 이벤트 잠재고객)와 같은 잠재고객 속성 목록을 제공하여 잠재고객이 해당 속성과 일치하는 크리에이터를 찾습니다. 크리에이터 속성을 제공하여 콘텐츠가 특정 속성과 일치하는 크리에이터를 필터링할 수도 있습니다.관심 주제에 대한
KNOWLEDGE_GRAPH와 같이 필요한 측정기준을 지정하여ListAudienceInsightsAttributes를 사용하여 사용 가능한 잠재고객 속성을 가져옵니다. 불리언AND및OR그룹을 사용하여 속성을 결합하려면 복잡한 잠재고객 조합에 설명된 대로audience_combinations를 사용합니다.크리에이터 주제 통계 (
search_topics):search_topics필드를 사용하여 콘텐츠 주제 목록을 제공합니다. API는 지정된 주제에 관한 콘텐츠를 제작하는 관련 크리에이터를 반환합니다.country_locations에 지정된 국가의 데이터를 가져옵니다. 이 옵션은 요청당 단일 국가를 지원합니다.search_topics에서 지원되는 항목은CONTENT_TRENDING_INSIGHTS또는CREATOR_TOPIC_INSIGHTS기능으로 태그해야 합니다.ListAudienceInsightsAttributes를 사용하여 지원되는 항목 기능을 가져옵니다.크리에이터 통계 (
search_channels):search_channels필드를 사용하여 YouTube 채널 ID, YouTube 채널 핸들 (youtube_channel_handles,v25이상에서 사용 가능) 또는 둘의 조합 목록을 제공합니다. API는 해당 채널에 대한 통계를 반환합니다.
복잡한 잠재고객 조합
GenerateCreatorInsights 및 GenerateTrendingInsights 모두에서 audience_combinations를 사용하여 복잡한 잠재고객 속성 관계를 정의할 수 있습니다. 이 필드를 사용하면 audience_attributes의 플랫 합집합 (OR) 동작을 넘어 불리언 로직 (AND 및 OR)과 잠재고객 속성을 결합할 수 있습니다.
audience_combinations내의 각InsightsAudienceAttributeGroup는 속성을 논리적OR와 결합합니다.audience_combinations의 여러InsightsAudienceAttributeGroup항목은 논리적AND와 결합됩니다.
예를 들어 ("Skin care" OR "Hair
care") AND "Cosmetics"에 관심이 있는 잠재고객을 타겟팅하려면 audience_combinations에 InsightsAudienceAttributeGroup 항목 두 개를 포함합니다.
"Skin care"및"Hair care"의 지식 그래프 항목 속성이 포함된 그룹 1"Cosmetics"의 지식 그래프 항목 속성이 포함된 그룹 2(예:/m/014trl)
보조 데이터 및 현지 크리에이터
기본적으로 핵심 통계 데이터만 반환됩니다. 반복되는 입력란 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 객체에는 다음이 포함됩니다.
creator_name: 크리에이터의 이름입니다.creator_channels:YouTubeChannelInsights객체 목록입니다. 채널 세부정보와channel_metrics(YouTubeMetrics)는creator_channels의 각YouTubeChannelInsights객체 내에 반환됩니다.
YouTubeMetrics 객체에는 다음이 포함됩니다.
- 구독자, 조회수, 동영상 수
- 채널의 모든 동영상에 대한 총 좋아요, 공유, 댓글 수
- 전체 기간 참여율 (총 참여수를 총 조회수로 나눈 값)
- 지난 28일 동안의 동영상당 평균 조회수, 좋아요 수, 공유 수, 댓글 수
- Shorts 조회수 및 동영상 수
- 크리에이터가 활성 Shorts 크리에이터 또는 활성 라이브 스트림 크리에이터인지 여부 (지난 90일 동안 하나 이상 게시)
- 파트너십 기회
참여율과 동영상당 평균 조회수, 좋아요 수, 댓글 수는 크리에이터가 공유에 동의한 경우에만 채워지는 비공개 측정항목입니다.
크리에이터가 오리지널 브랜디드 콘텐츠 파트너십 자격 요건을 충족하는지 확인하려면 partnership_opportunities를 검사합니다. 목록에 CREATOR_PARTNERSHIPS가 포함되어 있으면 크리에이터가 자격 요건을 충족하는 것입니다.
YouTubeChannelInsights 객체에는 YouTube 채널에 관한 다음 정보가 포함됩니다.
- 채널 이름, ID, 핸들, URL, 설명, 썸네일 URL
- 채널 생성일 및 연결된 국가
- 채널 측정항목
- 채널 시청자 속성 (예: 연령, 성별, 사용자 관심분야 분류)
- 채널 속성 (채널 콘텐츠와 연결된 속성)
- 인기 동영상
- 채널 유형 및 콘텐츠 언어
- 관련성 점수 (주제 트렌드 검색에만 해당)
- 크리에이터가 비공개 측정항목 공유에 동의했는지 여부
GenerateCreatorInsights 요청 및 응답 참조
다음 엔드포인트에서 ContentCreatorInsightsService에 대해 GenerateCreatorInsights를 호출합니다.
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
다음 표에는 GenerateCreatorInsightsRequest의 필드가 요약되어 있습니다.
| 필드 경로 | 요구사항 | 형식 및 제약 조건 |
|---|---|---|
customer_id |
필수 | 하이픈이 없는 10자리 고객 ID (string)입니다. |
customer_insights_group |
필수 | 계획 중인 고객 또는 브랜드의 사용자 정의 이름 (string)입니다. |
country_locations[] |
필수 | 국가 LocationInfo 객체 목록 (geo_target_constant, 예: "geoTargetConstants/2840"). search_topics를 사용하는 경우 단일 국가를 포함해야 합니다. |
sub_country_locations[] |
선택사항 | 하위 국가 LocationInfo 필터. search_attributes에서만 지원되며 LOCAL_CREATOR_DATA와 호환되지 않습니다. |
search_attributes |
criteria(oneof) |
SearchAttributes에는 다음이 포함됩니다.• audience_attributes[]: age_range, gender, device, parental_status, income_range(audience_combinations가 사용되지 않는 경우 user_interest, entity 또는 category 포함)• audience_combinations[]: AND-of-ORs InsightsAudienceAttributeGroup 항목• creator_attributes[]: CREATOR_ATTRIBUTE 기능이 있는 지식 그래프 entity 항목입니다. |
search_topics |
criteria(oneof) |
entities[]를 포함하는 SearchTopics(CREATOR_TOPIC_INSIGHTS 또는 CONTENT_TRENDING_INSIGHTS로 태그된 knowledge_graph_machine_id가 있는 AudienceInsightsEntity) |
search_channels |
criteria(oneof) |
youtube_channels[] (channel_id) 또는 youtube_channel_handles[](@로 시작하는 핸들, 예: "@youtubecreators")가 포함된 YouTubeChannels |
supplemental_data[] |
선택사항 | ContentCreatorInsightsSupplementalData 값 단일 국가 search_topics 요청(CREATOR_TOPIC_INSIGHTS가 있는 항목의 경우)에서 LOCAL_CREATOR_DATA를 설정하여 local_creator_insights[]를 채웁니다. |
insights_application_info |
선택사항 | AdditionalApplicationInfo 요청을 실행하는 애플리케이션에 대한 메타데이터입니다. |
GenerateCreatorInsightsResponse 메시지는 다음 필드를 반환합니다.
| 응답 필드 | 유형 | 설명 |
|---|---|---|
creator_insights[] |
YouTubeCreatorInsights |
핵심 기준 (creator_name 및 creator_channels[])을 충족하는 크리에이터 |
local_creator_insights[] |
YouTubeCreatorInsights |
위치 데이터 공유에 동의한 현지 크리에이터(CREATOR_TOPIC_INSIGHTS가 있는 항목에 search_topics와 함께 LOCAL_CREATOR_DATA가 요청될 때 채워짐) |
creator_channels[] |
YouTubeChannelInsights |
메타데이터: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location, data_sharing_consent_given통계 및 콘텐츠: channel_audience_attributes[] (동의 필요), channel_attributes[], top_videos[], language_distributions[], relevance_score(search_topics가 있는 GenerateTrendingInsights에만 채워짐), channel_metrics |
channel_metrics |
YouTubeMetrics |
공개 측정항목: subscriber_count, views_count, video_count, likes_count, shares_count, comments_count, shorts_views_count, shorts_video_count, is_active_shorts_creator, is_active_live_stream_creator, partnership_opportunities[]동의가 필요한 측정항목: engagement_rate 및 28일간의 동영상별 평균 (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video) |
GenerateCreatorInsights REST 요청 및 응답 예시
다음 예시에서는 searchAttributes를 사용하여 인구통계 audienceAttributes, 불리언 audienceCombinations ("Skin care"
OR "Hair care", AND "Cosmetics"), creatorAttributes를 사용하는 크리에이터를 검색합니다.
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
{
"customerInsightsGroup": "Spring Skincare Campaign",
"countryLocations": [
{
"geoTargetConstant": "geoTargetConstants/2840"
}
],
"searchAttributes": {
"audienceAttributes": [
{
"ageRange": {
"type": "AGE_RANGE_25_34"
}
},
{
"gender": {
"type": "FEMALE"
}
}
],
"audienceCombinations": [
{
"attributes": [
{
"entity": {
"knowledgeGraphMachineId": "/m/015c4z"
}
},
{
"entity": {
"knowledgeGraphMachineId": "/m/018bb_"
}
}
]
},
{
"attributes": [
{
"entity": {
"knowledgeGraphMachineId": "/m/014trl"
}
}
]
}
],
"creatorAttributes": [
{
"entity": {
"knowledgeGraphMachineId": "/m/014trl"
}
}
]
}
}
지역 크리에이터와 함께 주제 기반 크리에이터를 가져오려면 searchTopics를 사용하고 supplementalData에 "LOCAL_CREATOR_DATA"를 포함합니다.
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
{
"customerInsightsGroup": "Spring Skincare Campaign",
"countryLocations": [
{
"geoTargetConstant": "geoTargetConstants/2840"
}
],
"supplementalData": [
"LOCAL_CREATOR_DATA"
],
"searchTopics": {
"entities": [
{
"knowledgeGraphMachineId": "/m/014trl"
}
]
}
}
채널 ID 또는 핸들로 특정 YouTube 채널의 통계를 가져오려면 searchChannels를 사용합니다.
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
{
"customerInsightsGroup": "Spring Skincare Campaign",
"countryLocations": [
{
"geoTargetConstant": "geoTargetConstants/2840"
}
],
"searchChannels": {
"youtubeChannels": [
{
"channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
}
],
"youtubeChannelHandles": [
"@exampleskincare"
]
}
}
성공적인 GenerateCreatorInsightsResponse는 creatorInsights[]를 반환합니다(LOCAL_CREATOR_DATA가 요청된 경우 localCreatorInsights[]).
{
"creatorInsights": [
{
"creatorName": "Example Skincare Creator",
"creatorChannels": [
{
"displayName": "Example Skincare Channel",
"youtubeChannel": {
"channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
},
"channelUrl": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
"handle": "@exampleskincare",
"publishDate": "2020-03-15",
"countryLocation": {
"geoTargetConstant": "geoTargetConstants/2840"
},
"dataSharingConsentGiven": true,
"channelMetrics": {
"subscriberCount": "450000",
"viewsCount": "38200000",
"videoCount": "210",
"likesCount": "1950000",
"commentsCount": "84000",
"engagementRate": 0.056,
"averageViewsPerVideo": 62000.0,
"shortsViewsCount": "14500000",
"shortsVideoCount": "95",
"isActiveShortsCreator": true,
"isActiveLiveStreamCreator": false,
"partnershipOpportunities": [
"CREATOR_PARTNERSHIPS",
"PARTNERSHIP_ADS"
]
}
}
]
}
],
"localCreatorInsights": []
}
인기 급상승 통계 생성
트렌드 통계를 생성하려면 GenerateTrendingInsights 메서드에 요청을 보냅니다. 이 메서드의 한도는 초당 쿼리 수 (QPS) 5개입니다. 잠재고객 트렌드 또는 주제 트렌드 중 원하는 항목에 따라 두 가지 유형의 입력을 허용하며 대상 국가 위치가 필요합니다.
잠재고객 동향 (
search_audience):search_audience의audience_attributes필드에 잠재고객 속성 (예: 연령, 성별, 사용자 관심분야) 목록을 제공하고, 원하는 경우audience_combinations를 사용하여 속성을 불리언AND/OR로직과 결합합니다. API는 비교 기간 동안의 추세 값 변화율과 같은 측정항목을 포함하여 해당 잠재고객의 인기 급상승 통계 목록을 반환합니다.ContentCreatorInsightsService에 액세스할 수 있는 개발자는AudienceInsightsService의ListAudienceInsightsAttributes에 자동으로 액세스할 수 있습니다(잠재고객 통계 가이드 참고).AudienceInsightsService의 다른 엔드포인트에는 별도의 허용 목록이 필요합니다.주제 트렌드 (
search_topics):search_topics필드에 콘텐츠 주제 목록을 제공합니다. API는 비교 기간 동안의 트렌드 값 변화율을 포함하여 해당 주제의 트렌드 통계를 반환합니다.supplemental_data를 설정하여 현지 크리에이터 또는 브랜드 감정 통계를 요청할 수도 있습니다.ListAudienceInsightsAttributes에서 반환하는KNOWLEDGE_GRAPH속성에는 하나 이상의InsightsKnowledgeGraphEntityCapabilities태그가 포함됩니다.CONTENT_TRENDING_INSIGHTS태그가 지정된 항목은GenerateTrendingInsights에서 주제로 지원됩니다.
보조 데이터 및 현지 크리에이터
크리에이터 통계를 생성하는 것과 마찬가지로 반복되는 입력란 supplemental_data를 LOCAL_CREATOR_DATA 또는 BRAND_SENTIMENT_DATA로 설정하여 트렌드 통계에서 선택적 기능을 요청할 수 있습니다.
- 현지 크리에이터(
LOCAL_CREATOR_DATA): 인기 급상승 요청에서search_topics를 사용하고 주제가CREATOR_TOPIC_INSIGHTS기능으로 태그된 지식 그래프 항목인 경우supplemental_data를LOCAL_CREATOR_DATA로 설정하면 반환된TrendInsight객체의related_local_creators필드가 위치 데이터 공유에 동의한 관련 현지 크리에이터로 채워집니다. 로컬 크리에이터 검색은sub_country_locations와 호환되지 않습니다. - 브랜드 감정 (
BRAND_SENTIMENT_DATA): 인기 급상승 요청에서search_topics를 사용하고 요청된 지식 그래프 항목 주제에BRAND기능이 있는 경우supplemental_data를BRAND_SENTIMENT_DATA로 설정하면 반환된TrendInsight객체의brand_sentiment_insights필드가 채워집니다.
브랜드 감정 측정은 Gemini AI 모델을 사용하여 브랜드와 관련된 YouTube 동영상 콘텐츠를 분석하고 감정을 긍정적, 부정적 또는 중립적으로 분류합니다. 동영상 콘텐츠 자체만 분석되며 사용자 댓글은 포함되지 않습니다.
인기 급상승 통계 메타데이터
GenerateTrendingInsights 메서드는 TrendInsight 객체 목록을 반환하며, 각 객체에는 다음이 포함됩니다.
trend_attribute: 트렌드의 기본AudienceInsightsAttributeMetadata입니다.trend_metrics: 비교 기간의 비율 변동과 같은 추세 측정항목입니다.trend: 추세 방향을 나타내는InsightsTrend값 (EMERGING,RISING,SUSTAINED,DECLINING)입니다. 변경사항의 크기는trend_metrics.trend_change_percent를 참고하세요.trend_data_points: 트렌드의 이전 데이터 포인트입니다.search_topics를 사용하는 트렌드에만 채워집니다.related_videos: 트렌드 주제와 관련된 인기 급상승 동영상의AudienceInsightsAttributeMetadata객체 목록입니다(search_topics를 사용하는 트렌드에만 채워짐). 이러한 속성의 경우 중첩된YouTubeVideoAttributeMetadata는 동영상 수준 메타데이터 (URL, 썸네일 URL, 조회수 및 좋아요 수)와 채널 수준 메타데이터 (채널 ID, 이름, URL)로 채워집니다.related_creators: 트렌드 주제와 관련된 크리에이터의YouTubeCreatorInsights객체 목록입니다(search_topics를 사용하는 트렌드에만 채워짐).related_local_creators: 위치 데이터 공유에 동의한 트렌드 주제와 관련된 현지 크리에이터의YouTubeCreatorInsights객체 목록입니다.LOCAL_CREATOR_DATA가 요청된 경우에만 채워집니다(보조 데이터, 현지 크리에이터, 브랜드 감정 참조).brand_sentiment_insights: 추세에 대한BrandSentimentInsight객체 목록입니다(요청이BRAND기능이 있는 항목에search_topics를 사용하고BRAND_SENTIMENT_DATA를 요청할 때 채워짐). 각BrandSentimentInsight객체에는 다음이 포함됩니다.month: 브랜드 감정이 나타내는 월입니다(YYYY-MM형식).has_insufficient_data: 브랜드 감정을 계산하기에 데이터가 부족한지 여부입니다.sentiment_distributions: 긍정적, 부정적, 중립적 감정의 분포로, 각 감정의 브랜드에 해당하는 동영상의 조회수 비율로 계산됩니다.sentiment_summaries: 브랜드와 관련된 콘텐츠의 긍정적 및 부정적 주제에 대한 AI 생성 요약과 각 감정의 샘플 동영상입니다. 요약은 중립이 아닌 긍정적 및 부정적 감정에 대해서만 생성됩니다.
GenerateTrendingInsights 요청 및 응답 참조
다음 엔드포인트에서 ContentCreatorInsightsService에 대해 GenerateTrendingInsights를 호출합니다.
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights
다음 표에는 GenerateTrendingInsightsRequest의 필드가 요약되어 있습니다.
| 필드 경로 | 요구사항 | 형식 및 제약 조건 |
|---|---|---|
customer_id |
필수 | 하이픈이 없는 10자리 고객 ID (string)입니다. |
customer_insights_group |
필수 | 계획 중인 고객 또는 브랜드의 사용자 정의 이름 (string)입니다. |
country_location |
필수 | 단일 국가 LocationInfo (geo_target_constant, 예: "geoTargetConstants/2840") |
sub_country_locations[] |
선택사항 | 하위 국가 LocationInfo 필터. search_audience에만 지원되며 LOCAL_CREATOR_DATA와 호환되지 않습니다. |
search_audience |
criteria(oneof) |
SearchAudience에는 다음이 포함됩니다.• audience_attributes[] (필수): age_range, gender, parental_status, income_range(audience_combinations가 사용되지 않는 경우 user_interest, entity 또는 category 추가)• audience_combinations[] (선택사항): AND-of-ORs 속성 그룹입니다. |
search_topics |
criteria(oneof) |
entities[]를 포함하는 SearchTopics(CONTENT_TRENDING_INSIGHTS 태그가 지정된 knowledge_graph_machine_id가 있는 AudienceInsightsEntity) |
supplemental_data[] |
선택사항 | ContentCreatorInsightsSupplementalData 값:• LOCAL_CREATOR_DATA: search_topics 항목의 related_local_creators[]를 CREATOR_TOPIC_INSIGHTS로 채웁니다.• BRAND_SENTIMENT_DATA: search_topics 항목의 brand_sentiment_insights[]를 BRAND로 채웁니다. |
insights_application_info |
선택사항 | AdditionalApplicationInfo 요청을 실행하는 애플리케이션에 대한 메타데이터입니다. |
GenerateTrendingInsightsResponse 메시지는 trend_insights[]에서 TrendInsight 항목을 반환합니다.
TrendInsight 필드 |
유형 | 설명 |
|---|---|---|
trend_attribute |
AudienceInsightsAttributeMetadata |
트렌드의 기본 속성 (dimension, display_name, attribute)입니다. |
trend_metrics |
TrendInsightMetrics |
3개월 비교 기간의 측정항목 (search_topics의 경우 views_count 및 views_indexed_value, search_audience의 경우 audience_share, trend_change_percent) |
trend |
InsightsTrend |
추세 방향 (EMERGING, RISING, SUSTAINED 또는 DECLINING)입니다. |
trend_data_points[] |
TrendInsightDataPoint |
월별 이전 데이터 (YYYY-MM 형식의 month 및 trend_metrics), search_topics에 대해 채워짐 |
related_videos[] |
AudienceInsightsAttributeMetadata |
YouTubeVideoAttributeMetadata이(가) 포함된 인기 급상승 동영상(search_topics에 채워짐) |
related_creators[] |
YouTubeCreatorInsights |
주제와 관련된 크리에이터입니다. search_topics에 채워집니다. |
related_local_creators[] |
YouTubeCreatorInsights |
동의한 현지 크리에이터. CREATOR_TOPIC_INSIGHTS가 있는 항목에 LOCAL_CREATOR_DATA가 요청되면 search_topics에 채워집니다. |
brand_sentiment_insights[] |
BrandSentimentInsight |
월별 브랜드 감정 (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]). BRAND 기능이 있는 항목에 대해 BRAND_SENTIMENT_DATA가 요청되면 search_topics에 채워집니다. |
GenerateTrendingInsights REST 요청 및 응답 예시
다음 예에서는 지식 그래프 브랜드 항목 (/g/11example_brand, CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS, BRAND로 태그됨)에 searchTopics를 사용하여 GenerateTrendingInsights를 호출하고 LOCAL_CREATOR_DATA 및 BRAND_SENTIMENT_DATA를 모두 요청합니다.
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights
{
"customerInsightsGroup": "Spring Skincare Campaign",
"countryLocation": {
"geoTargetConstant": "geoTargetConstants/2840"
},
"supplementalData": [
"LOCAL_CREATOR_DATA",
"BRAND_SENTIMENT_DATA"
],
"searchTopics": {
"entities": [
{
"knowledgeGraphMachineId": "/g/11example_brand"
}
]
}
}
GenerateTrendingInsightsResponse가 성공하면 trendInsights[]에서 TrendInsight 항목을 반환합니다.
{
"trendInsights": [
{
"trendAttribute": {
"dimension": "KNOWLEDGE_GRAPH",
"displayName": "Example Skincare Brand",
"attribute": {
"entity": {
"knowledgeGraphMachineId": "/g/11example_brand"
}
}
},
"trendMetrics": {
"viewsCount": "18500000",
"viewsIndexedValue": "82",
"trendChangePercent": 0.24
},
"trend": "RISING",
"trendDataPoints": [
{
"month": "2026-05",
"trendMetrics": {
"viewsCount": "18500000",
"viewsIndexedValue": "82",
"trendChangePercent": 0.08
}
}
],
"brandSentimentInsights": [
{
"month": "2026-05",
"hasInsufficientData": false,
"sentimentDistributions": [
{
"sentiment": "SENTIMENT_POSITIVE",
"sentimentShare": 0.68
},
{
"sentiment": "SENTIMENT_NEUTRAL",
"sentimentShare": 0.25
},
{
"sentiment": "SENTIMENT_NEGATIVE",
"sentimentShare": 0.07
}
]
}
],
"relatedVideos": [],
"relatedCreators": [],
"relatedLocalCreators": []
}
]
}
Google Issue Tracker
Google Issue Tracker를 사용하여 지원 질문을 하거나 버그를 신고하거나 기능 요청을 제출하세요. Google은 Issue Tracker에서 직접 요청을 추적하고 우선순위를 지정하며 업데이트를 게시합니다. 자세한 내용은 Google Issue Tracker에서 문제 만들기를 참조하세요.
다음 Issue Tracker 템플릿 중 하나를 사용하여 문제를 만듭니다.
Google에서 요청을 재현하고 우선순위를 지정할 수 있도록 템플릿의 모든 필드를 자세한 정보로 작성합니다. Google은 불완전한 신고를 종료하고 누락된 세부정보를 포함하여 새로운 문제를 제출하도록 요청할 수 있습니다.