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. Tính năng này có thể hữu ích cho các đại lý 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 hàng đầu cho một nhóm chủ đề, nhóm nhân khẩu học, đối tượng hoặc thuộc tính nhà sáng tạo nhất định.
- Thông tin chi tiết về thương hiệu của nhà sáng tạo: Tìm nạp thông tin chi tiết về nhà sáng tạo liên quan đến một thương hiệu cụ thể.
- Thông tin chi tiết về nhà sáng tạo: Tìm nạp 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 đối tượng.
- Thông tin chi tiết về xu hướng: Tìm nạp thông tin chi tiết về các xu hướng cụ thể, dựa trên các đối tượng hoặc chủ đề cụ thể.
Điều kiện sử dụng
ContentCreatorInsightsService.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
thư viện ứng dụng Google Ads tiêu chuẩn để khám phá nội dung và nhà sáng tạo 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 kiếm các cơ hội quảng cáo tiềm năng.
- Hoàn tất bài đánh giá sàng lọc trước để đảm bảo đủ đ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 trải qua 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 một cách hợp pháp.
- Chấp nhận các điều khoản dịch vụ của API Google Ads terms of service.
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
ContentCreatorInsightsService.GenerateCreatorInsights. Phương thức này có giới hạn 5 truy vấn mỗi giây (QPS) và nhận 3 loại dữ liệu đầu vào tuỳ thuộc vào việc bạn muốn khám phá nhà sáng tạo, tìm thông tin chi tiết về thương hiệu của nhà sáng tạo hay nhận 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 khám phá nhà sáng tạo: 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 đang cân nhắc 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 của nhà sáng tạo 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
AudienceInsightsService.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ừ API Google Ads phiên bản 23, bạn có thể chỉ định các mối quan hệ phức tạp giữa các thuộc tính đố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 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 với việc 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 ...), nhưngaudience_combinationsmang lại khả năng kiểm soát chi tiết hơn. MỗiInsightsAudienceAttributeGrouptrongaudience_combinationskết hợp các thuộc tính với một logic OR. Sau đó, các nhóm này được kết hợp với một logic AND.Ví dụ: để nhắm mục tiêu đến một đố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à các chủ đề mà người dùng quan tâm, được biểu thị bằng các thực thể 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ể 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ể Sơ đồ tri thức cho "Mỹ phẩm".Xin lưu ý rằng nếu chỉ định các thực thể Sơ đồ 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, thì 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 kết hợp vớiaudience_combinations.Thông tin chi tiết về thương hiệu của nhà sáng tạo: Cung cấp một thương hiệu để tìm kiếm những nhà sáng tạo hàng đầu. API này trả về thông tin chi tiết về các kênh phù hợp.
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. API này trả về thông tin chi tiết về những kênh cụ thể đó.
Phương thức generateCreatorInsights trả về đối tượng GenerateCreatorInsightsResponse. Đối tượng này chứa danh sách các đối tượng YouTubeCreatorInsights. 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ố của 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)
Đối tượng YouTubeChannelInsights chứa thông tin sau đây về một kênh YouTube:
- Tên kênh
- Mã nhận dạng 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à mối quan tâm của người dùng
bảng chi tiết)
Video hàng đầu
Loại kênh
Ngôn ngữ liên kết với nội dung kênh
Điểm mức độ liên quan (chỉ dành cho các cụm từ tìm kiếm xu hướng chủ đề)
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
ContentCreatorInsightsService.GenerateTrendingInsights
phương thức. Phương thức này có giới hạn 5 truy vấn mỗi giây (QPS) và nhận 2 loại dữ liệu đầu vào tuỳ thuộc vào việc bạn muốn nhận xu hướng đối tượng hay xu hướng 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 đố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 đang cân nhắc 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 về 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
AudienceInsightsService.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ừ API Google Ads phiên bản 23, bạn có thể chỉ định các mối quan hệ phức tạp giữa các thuộc tính đố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 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 với việc 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 ...), nhưngaudience_combinationsmang lại khả năng kiểm soát chi tiết hơn. MỗiInsightsAudienceAttributeGrouptrongaudience_combinationskết hợp các thuộc tính với một logic OR. Sau đó, các nhóm này được kết hợp với một logic AND.Ví dụ: để nhắm mục tiêu đến một đố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à các chủ đề mà người dùng quan tâm, được biểu thị bằng các thực thể 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ể 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ể Sơ đồ tri thức cho "Mỹ phẩm".Xin lưu ý rằng nếu chỉ định các thực thể Sơ đồ 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, thì 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 kết hợp vớiaudience_combinations.Xu hướng 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.