Khám phá và tìm nạp thông tin chi tiết về nhà sáng tạo trên YouTube bằng tính năng thông tin chi tiết về nhà sáng tạo. Điều này có thể hữu ích cho những công ty quảng cáo và nhà quảng cáo muốn tìm những nhà sáng tạo phù hợp với đối tượng mục tiêu của họ.
API này có 4 chức năng chính:
- Khả năng được khám phá của nhà sáng tạo: Tìm những nhà sáng tạo phù hợp cho một nhóm chủ đề, thông tin nhân khẩu học, đối tượng hoặc thuộc tính của nhà sáng tạo nhất định.
- Thông tin chi tiết về chủ đề của nhà sáng tạo: Lấy thông tin chi tiết về những nhà sáng tạo phù hợp đang tạo nội dung về các chủ đề được chỉ định.
- Thông tin chi tiết về nhà sáng tạo: Lấy thông tin chi tiết về các kênh YouTube cụ thể, chẳng hạn như số người đăng ký, số lượt xem và thông tin nhân khẩu học của khán giả.
- Thông tin chi tiết về xu hướng: Lấy thông tin chi tiết về các xu hướng cụ thể, dựa trên đối tượng hoặc chủ đề cụ thể.
Tính năng khám phá nhà sáng tạo tại địa phương (tìm những nhà sáng tạo sinh sống hoặc đăng bài ở một quốc gia nhất định và được xem ở quốc gia đó) được hỗ trợ khi bạn sử dụng tính năng khám phá nhà sáng tạo dựa trên chủ đề hoặc thông tin chi tiết về xu hướng bằng cách yêu cầu dữ liệu bổ sung.
Điều kiện sử dụng
GenerateCreatorInsights là một thành phần riêng tư của Google Ads API được cung cấp kèm theo giấy phép dữ liệu không độc quyền và miễn phí bản quyền. Các đối tác đã ký hợp đồng có thể sử dụng các thư viện ứng dụng Google Ads tiêu chuẩn để khám phá nhà sáng tạo và nội dung trên YouTube. Để đủ điều kiện, đối tác phải đáp ứng các điều kiện sau:
- Có một công cụ lập kế hoạch hoặc giao diện người dùng sẽ tích hợp API Google Ads.
- Sử dụng API để khám phá nội dung và nhà sáng tạo trên YouTube nhằm tìm ra các cơ hội quảng cáo tiềm năng.
- Hoàn tất quy trình đánh giá sơ bộ để đảm bảo bạn đủ điều kiện.
- Tuân thủ các yêu cầu về việc sử dụng dữ liệu và sẵn sàng tham gia các cuộc kiểm tra dữ liệu định kỳ.
- Ký thoả thuận cấp phép dữ liệu để thực thi các yêu cầu về việc sử dụng dữ liệu theo pháp luật.
- Chấp nhận điều khoản dịch vụ của Google Ads API.
Hãy liên hệ với người đại diện của Google để biết thêm thông tin.
Tạo thông tin chi tiết về nhà sáng tạo
Để tạo thông tin chi tiết về nhà sáng tạo, hãy gửi yêu cầu đến phương thức GenerateCreatorInsights. Phương thức này có giới hạn là 5 truy vấn mỗi giây (QPS). Công cụ này có nhiều loại dữ liệu đầu vào, tuỳ thuộc vào việc bạn muốn tăng khả năng hiển thị của nhà sáng tạo, tìm kiếm nhà sáng tạo phù hợp theo chủ đề hay xem thông tin chi tiết về nhà sáng tạo. Bạn phải cung cấp vị trí quốc gia mà bạn muốn lấy dữ liệu.
Khả năng được khám phá của nhà sáng tạo: Bạn có thể cung cấp danh sách các thuộc tính của đối tượng, chẳng hạn như độ tuổi, giới tính và mối quan tâm của người dùng (bao gồm cả đối tượng chung sở thích, đối tượng có ý định mua hàng và đối tượng đang trải qua sự kiện trong đời). API này trả về danh sách những nhà sáng tạo có đối tượng phù hợp với các thuộc tính đó. Bạn cũng có thể cung cấp các thuộc tính của nhà sáng tạo để lọc những nhà sáng tạo có nội dung phù hợp với các thuộc tính mà bạn đã nhập.
Bạn có thể truy xuất các thuộc tính đối tượng có sẵn bằng cách sử dụng
ListAudienceInsightsAttributes, bằng cách cung cấp các phương diện mà bạn muốn có thuộc tính, chẳng hạn nhưKNOWLEDGE_GRAPHcho các chủ đề mà người dùng quan tâm.Kể từ Google Ads API phiên bản 23, bạn có thể chỉ định các mối quan hệ thuộc tính phức tạp của đối tượng bằng cách sử dụng
audience_combinations. Trường này cho phép bạn xác định đối tượng bằng toán tử logic Boolean (VÀ/HOẶC) mà bạn không thể thực hiện bằngaudience_attributes.Mặc dù
audience_attributesphù hợp để nhắm mục tiêu dựa trên danh sách các thuộc tính được hợp nhất (kết hợp với OR) (ví dụ: người dùng quan tâm đến "thể thao" HOẶC "du lịch" HOẶC...),audience_combinationsmang đến khả năng kiểm soát chi tiết hơn. MỗiInsightsAudienceAttributeGrouptrongaudience_combinationskết hợp các thuộc tính bằng hàm logic OR. Sau đó, các nhóm này được kết hợp bằng hàm logic AND.Ví dụ: để nhắm đến đối tượng quan tâm đến ("Chăm sóc da" HOẶC "Chăm sóc tóc") VÀ cũng quan tâm đến "Mỹ phẩm", bạn sẽ sử dụng 2 mục
InsightsAudienceAttributeGrouptrongaudience_combinations. "Chăm sóc da", "Chăm sóc tóc" và "Mỹ phẩm" là những chủ đề mà người dùng quan tâm, được thể hiện bằng các thực thể trong Sơ đồ tri thức (ví dụ:/m/014trlcho Mỹ phẩm). Nhóm đầu tiên sẽ chứa các thuộc tính thực thể trong Sơ đồ tri thức cho "Chăm sóc da" và "Chăm sóc tóc", còn nhóm thứ hai sẽ chứa thuộc tính thực thể trong Sơ đồ tri thức cho "Mỹ phẩm".Xin lưu ý rằng nếu chỉ định các thực thể trong Biểu đồ tri thức, Danh mục sản phẩm và dịch vụ hoặc mối quan tâm của người dùng trong
audience_attributes, bạn không thể sử dụngaudience_combinations. Nếu sử dụngaudience_combinations, bạn phải chỉ định các thuộc tính này trongaudience_combinationschứ không phải trongaudience_attributes; tuy nhiên, bạn vẫn có thể sử dụngaudience_attributescho các loại thuộc tính khác (chẳng hạn như thông tin nhân khẩu học) cùng vớiaudience_combinations.Thông tin chi tiết về chủ đề của nhà sáng tạo: Cung cấp danh sách các chủ đề nội dung bằng cách sử dụng trường
search_topics. API này trả về những nhà sáng tạo có liên quan và tạo nội dung về các chủ đề được chỉ định. Dữ liệu được tìm nạp dựa trên quốc gia được chỉ định trongcountry_locations. Xin lưu ý rằng lựa chọn này chỉ cho phép tìm kiếm một quốc gia.Bạn phải gắn thẻ cho các thực thể được hỗ trợ trong trường
SearchTopicsbằng tính năngCONTENT_TRENDING_INSIGHTShoặcCREATOR_TOPIC_INSIGHTS. Sử dụng phương thứcListAudienceInsightsAttributesđể truy xuất các chức năng được hỗ trợ của thực thể.Lưu ý: Tuỳ chọn
search_brandkhông được dùng nữa trong phiên bản 24.2 và đã bị xoá trong phiên bản 25. Thay vào đó, hãy sử dụngsearch_topics.Thông tin chi tiết về nhà sáng tạo: Cung cấp danh sách mã nhận dạng kênh YouTube bằng trường
search_channels. API này trả về thông tin chi tiết về những kênh cụ thể đó.
Dữ liệu bổ sung và nhà sáng tạo địa phương
Theo mặc định, hệ thống chỉ trả về dữ liệu thông tin chi tiết cốt lõi. Bạn có thể yêu cầu các tính năng không bắt buộc và dữ liệu bổ sung trong phản hồi của mình bằng cách đặt trường lặp lại supplemental_data.
Ví dụ: bạn có thể yêu cầu dữ liệu của nhà sáng tạo tại địa phương bằng cách thêm giá trị enum LOCAL_CREATOR_DATA vào trường supplemental_data. Nếu bạn đang tìm kiếm nhà sáng tạo bằng search_topics (và chủ đề là một thực thể trong Sơ đồ tri thức được gắn thẻ bằng khả năng CREATOR_TOPIC_INSIGHTS), thì API sẽ điền sẵn trường local_creator_insights trong phản hồi bằng những nhà sáng tạo tại địa phương đã đồng ý chia sẻ dữ liệu vị trí của họ.
Xin lưu ý các quy cách sau đây để khám phá nhà sáng tạo tại địa phương:
- Định nghĩa: "Nhà sáng tạo tại địa phương" là những nhà sáng tạo sinh sống hoặc đăng nội dung ở quốc gia đã chọn và được xem ở quốc gia đó.
- Hạn chế: Tính năng khám phá nhà sáng tạo tại địa phương không được hỗ trợ khi
sub_country_locationsđược đặt trong yêu cầu. - Các chức năng: Bạn có thể truy xuất danh sách các thực thể được hỗ trợ trong Sơ đồ tri thức và các chức năng của chúng bằng cách sử dụng
ListAudienceInsightsAttributes.
Phương thức generateCreatorInsights trả về một đối tượng GenerateCreatorInsightsResponse. Đối tượng này chứa các trường sau:
creator_insights: Một danh sách các đối tượngYouTubeCreatorInsightsphù hợp với tiêu chí cốt lõi của bạn.local_creator_insights: Một danh sách các đối tượngYouTubeCreatorInsightscho nhà sáng tạo tại địa phương. Tham số này chỉ được điền sẵn nếuLOCAL_CREATOR_DATAđược yêu cầu và tiêu chí được sử dụng làsearch_topics.
Mỗi đối tượng YouTubeCreatorInsights chứa thông tin sau đây về một nhà sáng tạo:
- Tên của nhà sáng tạo
- Kênh YouTube
- Tổng số chỉ số về nhà sáng tạo
- Danh sách thông tin chi tiết về kênh YouTube
Đối tượng YouTubeMetrics chứa các chỉ số sau:
- Số người đăng ký
- Lượt xem
- Số lượng video
- Là nhà sáng tạo video Shorts đang hoạt động
- Cơ hội hợp tác (bắt đầu từ phiên bản 23)
Để xác định xem một nhà sáng tạo có đủ điều kiện hợp tác tạo nội dung lồng ghép thương hiệu gốc hay không, hãy kiểm tra partnership_opportunities; nhà sáng tạo sẽ đủ điều kiện nếu danh sách chứa giá trị CREATOR_PARTNERSHIPS.
Đối tượng YouTubeChannelInsights chứa thông tin sau về một kênh YouTube:
- Tên kênh
- ID kênh
- URL của kênh
- Nội dung mô tả kênh
- Các chỉ số về kênh
- Thuộc tính đối tượng của kênh (chẳng hạn như độ tuổi, giới tính và thông tin chi tiết về mối quan tâm của người dùng)
- Video hàng đầu
- Loại kênh
- Ngôn ngữ liên kết với nội dung trên kênh
- Điểm mức độ liên quan (chỉ dành cho cụm từ tìm kiếm xu hướng theo chủ đề)
- Nhà sáng tạo có đồng ý chia sẻ các chỉ số không công khai hay không
Tạo thông tin chi tiết về xu hướng
Để tạo thông tin chi tiết về xu hướng, hãy gửi yêu cầu đến phương thức GenerateTrendingInsights. Phương thức này có giới hạn là 5 truy vấn mỗi giây (QPS). Công cụ này có hai loại dữ liệu đầu vào, tuỳ thuộc vào việc bạn muốn xem xu hướng về đối tượng hay xu hướng về chủ đề. Bạn phải cung cấp vị trí quốc gia cụ thể mà bạn muốn lấy xu hướng.
Xu hướng về đối tượng: Bạn có thể cung cấp danh sách các thuộc tính đối tượng, chẳng hạn như độ tuổi, giới tính và mối quan tâm của người dùng (bao gồm cả đối tượng chung sở thích, đối tượng có ý định mua hàng và đối tượng đang trải qua sự kiện trong đời). API này trả về danh sách thông tin chi tiết theo xu hướng cho những đối tượng đó, bao gồm các chỉ số như tỷ lệ phần trăm thay đổi về giá trị của xu hướng trong khoảng thời gian so sánh.
Bạn có thể truy xuất các thuộc tính đối tượng có sẵn bằng cách sử dụng
ListAudienceInsightsAttributes, bằng cách cung cấp các phương diện mà bạn muốn có thuộc tính, chẳng hạn nhưKNOWLEDGE_GRAPHcho các chủ đề mà người dùng quan tâm.Kể từ Google Ads API phiên bản 23, bạn có thể chỉ định các mối quan hệ thuộc tính phức tạp của đối tượng bằng cách sử dụng
audience_combinations. Trường này cho phép bạn xác định đối tượng bằng toán tử logic Boolean (VÀ/HOẶC) mà bạn không thể thực hiện bằngaudience_attributes.Mặc dù
audience_attributesphù hợp để nhắm mục tiêu dựa trên danh sách các thuộc tính được hợp nhất (kết hợp với OR) (ví dụ: người dùng quan tâm đến "thể thao" HOẶC "du lịch" HOẶC...),audience_combinationsmang đến khả năng kiểm soát chi tiết hơn. MỗiInsightsAudienceAttributeGrouptrongaudience_combinationskết hợp các thuộc tính bằng hàm logic OR. Sau đó, các nhóm này được kết hợp bằng hàm logic AND.Ví dụ: để nhắm đến đối tượng quan tâm đến ("Chăm sóc da" HOẶC "Chăm sóc tóc") VÀ cũng quan tâm đến "Mỹ phẩm", bạn sẽ sử dụng 2 mục
InsightsAudienceAttributeGrouptrongaudience_combinations. "Chăm sóc da", "Chăm sóc tóc" và "Mỹ phẩm" là những chủ đề mà người dùng quan tâm, được thể hiện bằng các thực thể trong Sơ đồ tri thức (ví dụ:/m/014trlcho Mỹ phẩm). Nhóm đầu tiên sẽ chứa các thuộc tính thực thể trong Sơ đồ tri thức cho "Chăm sóc da" và "Chăm sóc tóc", còn nhóm thứ hai sẽ chứa thuộc tính thực thể trong Sơ đồ tri thức cho "Mỹ phẩm".Xin lưu ý rằng nếu chỉ định các thực thể trong Biểu đồ tri thức, Danh mục sản phẩm và dịch vụ hoặc mối quan tâm của người dùng trong
audience_attributes, bạn không thể sử dụngaudience_combinations. Nếu sử dụngaudience_combinations, bạn phải chỉ định các thuộc tính này trongaudience_combinationschứ không phải trongaudience_attributes; tuy nhiên, bạn vẫn có thể sử dụngaudience_attributescho các loại thuộc tính khác (chẳng hạn như thông tin nhân khẩu học) cùng vớiaudience_combinations.Các thuộc tính
KNOWLEDGE_GRAPHsẽ có một hoặc nhiều thẻInsightsKnowledgeGraphEntityCapabilities. Các thuộc tính được hỗ trợ cho Thông tin chi tiết về xu hướng sẽ có các thẻ liên quan trong siêu dữ liệu phản hồi.Xin lưu ý rằng những nhà phát triển có quyền truy cập vào
ContentCreatorInsightsServicecũng sẽ tự động có quyền truy cập vàoAudienceInsightsService.ListAudienceInsightsAttributes. Các điểm cuối khác trongAudienceInsightsServiceyêu cầu một quy trình danh sách cho phép độc lập.Bạn có thể xem thêm tài liệu về
ListAudienceInsightsAttributestrong hướng dẫn về Thông tin chi tiết về đối tượng.Xu hướng theo chủ đề: Cung cấp danh sách các chủ đề nội dung. API này trả về danh sách thông tin chi tiết về xu hướng cho những chủ đề đó, bao gồm các chỉ số như tỷ lệ phần trăm thay đổi về giá trị của xu hướng trong khoảng thời gian so sánh.
Dữ liệu bổ sung và nhà sáng tạo địa phương
Tương tự như việc tạo thông tin chi tiết về nhà sáng tạo, bạn có thể yêu cầu các tính năng không bắt buộc trong thông tin chi tiết về xu hướng bằng cách đặt trường lặp lại supplemental_data thành LOCAL_CREATOR_DATA.
Nếu yêu cầu về xu hướng của bạn sử dụng search_topics, thì yêu cầu này sẽ điền vào trường related_local_creators trên các đối tượng TrendInsight được trả về với những nhà sáng tạo địa phương có liên quan đến chủ đề được yêu cầu và đã đồng ý chia sẻ dữ liệu vị trí của họ. Tính năng khám phá nhà sáng tạo tại địa phương phải tuân theo cùng định nghĩa và các ràng buộc (chẳng hạn như không tương thích với sub_country_locations).
Siêu dữ liệu về thông tin chi tiết về xu hướng
Phương thức GenerateTrendingInsights trả về một danh sách các đối tượng TrendInsight, mỗi đối tượng chứa:
trend_attribute:AudienceInsightsAttributeMetadatachính cho xu hướng.trend_metrics: Các chỉ số cho xu hướng, chẳng hạn như tỷ lệ phần trăm thay đổi trong khoảng thời gian so sánh.trend_data_points: Các điểm dữ liệu trong quá khứ cho xu hướng. Chỉ được điền sẵn cho các xu hướng sử dụngsearch_topics.related_videos: Danh sách các đối tượngAudienceInsightsAttributeMetadatacho video thịnh hành liên quan đến chủ đề của xu hướng. Chỉ được điền sẵn cho các xu hướng bằngsearch_topics. Đối với các thuộc tính này,YouTubeVideoAttributeMetadatalồng nhau sẽ được điền sẵn. Thuộc tính này chứa siêu dữ liệu ở cấp video (chẳng hạn như URL video, URL hình thu nhỏ và số lượt xem hoặc lượt thích) và siêu dữ liệu ở cấp kênh (chẳng hạn như mã nhận dạng, tên và URL của kênh).