Thông tin chi tiết về đối tượng

Lưu ý quan trọng: Tính năng này chỉ được cung cấp cho những tài khoản có trong danh sách cho phép. Hãy liên hệ với người đại diện của Google nếu bạn cần được cấp quyền sử dụng tính năng này.

Tất cả các yêu cầu đến AudienceInsightsService đều bị giới hạn tốc độ. Mỗi ngày, bạn được phép gửi ít yêu cầu hơn cho generateAudienceCompositionInsights và generateSuggestedTargetingInsights so với các phương thức khác của Thông tin chi tiết về đối tượng. Hãy xem phần Hạn mức API để biết thêm thông tin.

AudienceInsightsService cho phép bạn tích hợp dữ liệu thông tin chi tiết về đối tượng của Google vào các công cụ lập kế hoạch. Dữ liệu này giúp các công ty truyền thông và nhà lập kế hoạch truyền thông hiểu rõ hơn về đối tượng mục tiêu, bao gồm cả thông tin nhân khẩu học, mối quan tâm và hành vi trực tuyến.

Thông tin chi tiết về đối tượng giúp bạn hiểu rõ một đối tượng, danh mục, chủ đề hoặc thương hiệu bằng cách cung cấp thông tin tổng quan. Bằng cách phân tích hành vi của người dùng đối với các chủ đề có liên quan, bạn có thể sử dụng những thông tin chi tiết về đối tượng này để khám phá các mối liên hệ và nhận thức của người tiêu dùng, đồng thời xác định các phân khúc đối tượng mới.

API này hỗ trợ 3 trường hợp sử dụng chính:

• Tinh chỉnh và khám phá đối tượng: Tìm hiểu mối quan tâm và hành vi riêng biệt của người tiêu dùng để xác định đối tượng mới cho một thương hiệu, phát triển chân dung đối tượng và tinh chỉnh chiến lược phân khúc đối tượng.
• Cung cấp thông tin cho việc lập kế hoạch chiến dịch: Chuyển đổi dữ liệu đầu ra thành đối tượng mục tiêu trên YouTube để lập kế hoạch, ước tính phạm vi tiếp cận tiềm năng của đối tượng mục tiêu và đo lường mức độ trùng lặp giữa các phân khúc đối tượng để tối đa hoá phạm vi tiếp cận của chiến dịch.
• Phát triển thông điệp quảng cáo: Điều chỉnh thông điệp quảng cáo cho phù hợp với đối tượng mục tiêu dựa trên những chủ đề và mối quan tâm mà họ tương tác nhiều nhất.

Điều kiện sử dụng

Để đủ điều kiện tham gia AudienceInsightsService, đối tác phải đáp ứng các điều kiện sau:

• Đã có quyền truy cập hoặc đủ điều kiện truy cập vào Trình tìm thông tin chi tiết.
• Có một công cụ lập kế hoạch hoặc giao diện người dùng tích hợp API.
• Sử dụng API này cho mục đích lập kế hoạch truyền thông hoặc các trường hợp sử dụng phù hợp khác.
• Hoàn tất quy trình đánh giá sơ bộ.
• Tuân thủ các yêu cầu về việc sử dụng dữ liệu và trải qua các cuộc kiểm tra dữ liệu định kỳ.
• Chấp nhận điều khoản dịch vụ của Google Ads API và chính sách sử dụng dữ liệu liên quan.

Hãy liên hệ với người đại diện của Google để biết thêm thông tin.

Ngày đủ điều kiện để xem thông tin chi tiết về danh sách

Quy trình làm việc thông thường bắt đầu bằng việc kiểm tra xem những tháng và khoảng thời gian nào có thể phân tích. Phương thức listInsightsEligibleDates trả về một ListInsightsEligibleDatesResponse, trong đó trường data_months liệt kê các tháng (ở định dạng YYYY-MM) có sẵn dữ liệu thông tin chi tiết về đối tượng.

Trường last_thirty_days của phản hồi chứa chính xác dải ngày mà generateAudienceCompositionInsights sử dụng khi data_month không được đặt trong yêu cầu.

Liệt kê các thuộc tính thông tin chi tiết về đối tượng

Trước khi truy vấn chỉ số về thành phần hoặc mức độ trùng lặp của đối tượng, hãy khám phá các mã nhận dạng thuộc tính hợp lệ bằng cách sử dụng listAudienceInsightsAttributes. Phương thức này trả về một ListAudienceInsightsAttributesResponse chứa các thuộc tính có sẵn cho phương diện được yêu cầu.

Ví dụ: nếu AFFINITY_USER_INTEREST được chọn làm phương diện trong yêu cầu, thì phương thức này sẽ trả về các đối tượng chung sở thích được hỗ trợ, chẳng hạn như "Người hâm mộ thể thao" hoặc "Người yêu nhạc". Các phương diện khác về mối quan tâm của người dùng được hỗ trợ bao gồm IN_MARKET_USER_INTEREST và LIFE_EVENT_USER_INTEREST. Bạn có thể đặt nhiều phương diện trong một yêu cầu. Để xem danh sách đầy đủ các phương diện được hỗ trợ, hãy xem tài liệu tham khảo về trường dimensions.

Khi tìm kiếm các thực thể (chủ đề) trong Sơ đồ tri thức bằng phương diện KNOWLEDGE_GRAPH, bạn phải cung cấp một cụm từ tìm kiếm dạng chuỗi trong trường query_text (ví dụ: "football and the World Cup").

Bạn có thể thêm knowledge_graph_entity_search_options (không bắt buộc) để tuỳ chỉnh nội dung tìm kiếm theo chủ đề:

• Lọc theo chức năng: Sử dụng search_filter để thu hẹp các thực thể được truy xuất chỉ còn những thực thể hỗ trợ các chức năng cụ thể. Ví dụ: bạn có thể lọc các chủ đề được hỗ trợ dưới dạng thuộc tính của nhà sáng tạo bằng cách cung cấp CREATOR_ATTRIBUTE trong trường entity_capability_filters. Bạn có thể cung cấp nhiều chức năng và kết hợp chúng với logic OR.
• Truy xuất tất cả thuộc tính của nhà sáng tạo: Đặt get_all_creator_attributes thành true để truy xuất tất cả thực thể có sẵn trong Sơ đồ tri thức được gắn thẻ là thuộc tính của nhà sáng tạo. Khi sử dụng lựa chọn này, bạn phải chọn phương diện KNOWLEDGE_GRAPH, query_text phải trống và bạn không thể kết hợp lựa chọn này với search_filter.

Bạn có thể dùng các thuộc tính do phương thức khám phá này trả về làm dữ liệu đầu vào cho các phương thức AudienceInsightsService khác.

Mỗi đối tượng AudienceInsightsAttributeMetadata trong ListAudienceInsightsAttributesResponse cung cấp một biểu thị có cấu trúc về một thuộc tính đối tượng cùng với các thuộc tính mô tả và chỉ số về mức độ tương tác. Thông tin này bao gồm định nghĩa chính, tên hiển thị, loại phương diện và phạm vi tiếp cận đối tượng ước tính của đối tượng. Hãy xem tài liệu tham khảo AudienceInsightsAttributeMetadata để biết định nghĩa về trường.

Tạo định nghĩa về đối tượng

Phương thức generateAudienceDefinition dịch nội dung mô tả văn bản tự do về đối tượng thành các đề xuất thuộc tính đối tượng có cấu trúc mà bạn có thể truyền đến các phương thức thông tin chi tiết ở hạ nguồn.

Tạo thông tin chi tiết được đề xuất về việc nhắm mục tiêu

Phương thức generateSuggestedTargetingInsights trả về một tập hợp thông tin chi tiết về việc nhắm mục tiêu (chẳng hạn như phân khúc đối tượng có thể nhắm mục tiêu) có liên quan đến đối tượng được yêu cầu.

Bạn có thể chỉ định đối tượng được yêu cầu dưới dạng InsightsAudienceDefinition có cấu trúc hoặc dưới dạng nội dung mô tả bằng văn bản trong InsightsAudienceDescription.

Trong khi generateAudienceCompositionInsights trả về thông tin chi tiết cho từng phân khúc thuộc tính, generateSuggestedTargetingInsights trả về các đề xuất được nhóm lại về phân khúc đối tượng có thể nhắm đến trên Google Ads. Phương pháp này giúp trả lời các câu hỏi như "Đề xuất cho tôi những đối tượng có thể nhắm đến là những người cha ở độ tuổi 30 và thích câu cá".

Tạo các chỉ số đề xuất nhắm mục tiêu

Phương thức generateTargetingSuggestionMetrics trả về một GenerateTargetingSuggestionMetricsResponse, trong đó có số người có thể tiếp cận qua YouTube tiềm năng cho mỗi định nghĩa về đối tượng được yêu cầu trong GenerateTargetingSuggestionMetricsRequest.

Phương pháp này giúp trả lời các câu hỏi như "Tôi có thể tiếp cận bao nhiêu người là nam giới trên 18 tuổi và thích cắm trại ở Hoa Kỳ trên YouTube?"

Tạo thông tin chi tiết về thành phần đối tượng

Phương thức generateAudienceCompositionInsights trả về một GenerateAudienceCompositionInsightsResponse, chứa danh sách các thuộc tính đại diện cho đối tượng quan tâm được yêu cầu, cùng với chỉ số và chỉ số về thị phần so sánh thị phần của từng thuộc tính trong đối tượng với một nhóm dân số cơ sở.

Bạn phải cung cấp một quốc gia mục tiêu cho đối tượng. Danh sách các phương diện được hỗ trợ để truy xuất thông tin chi tiết về thành phần được ghi lại trên trường dimensions của GenerateAudienceCompositionInsightsRequest.

Phương pháp này giúp trả lời các câu hỏi như "So với dân số chung, đối tượng mục tiêu của tôi quan tâm đến những đối tượng chung sở thích hàng đầu nào và họ có nhiều khả năng tương tác với những đối tượng chung sở thích đó hơn bao nhiêu?"

Tạo thông tin chi tiết về mức độ trùng lặp đối tượng

Phương thức generateAudienceOverlapInsights trả về một GenerateAudienceOverlapInsightsResponse, trong đó có danh sách các thuộc tính đối tượng kèm theo thông tin ước tính về mức độ trùng lặp giữa phạm vi tiếp cận tiềm năng trên YouTube và phạm vi tiếp cận của một thuộc tính chính.

Bạn phải cung cấp một quốc gia mục tiêu và một thuộc tính chính. Độ tuổi, giới tính, phân khúc đối tượng chung sở thích và phân khúc có ý định mua hàng được hỗ trợ dưới dạng phương diện đối tượng.

Phương pháp này giúp trả lời các câu hỏi như "Quy mô đối tượng gia tăng là bao nhiêu khi chúng tôi nhắm đến cả người hâm mộ thể thao và người yêu nhạc ở Hoa Kỳ?"

Tạo báo cáo của Trình tìm thông tin chi tiết

Phương thức generateInsightsFinderReport sẽ tạo một báo cáo đã lưu trong Trình tìm thông tin chi tiết dựa trên thông tin đầu vào được chỉ định trong GenerateInsightsFinderReportRequest và trả về một GenerateInsightsFinderReportResponse chứa đường liên kết có thể truy cập từ bên ngoài để mở báo cáo đó trong giao diện người dùng của Trình tìm thông tin chi tiết.