Tổng quan về Topics API for Mobile

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tìm hiểu về Topics API trên Android và các bước triển khai API này. Bạn cũng có thể chuyển thẳng đến phần triển khai chủ đề.

Cách hoạt động của Topics API

Bạn có thể dùng Topics API để quan sát và cung cấp quyền truy cập vào những chủ đề mà có vẻ như người dùng quan tâm, dựa trên hoạt động của họ. Sau đó, Topics API có thể cấp cho phương thức gọi API (chẳng hạn như nền tảng công nghệ quảng cáo) quyền truy cập vào các chủ đề mà người dùng quan tâm, nhưng không tiết lộ thêm thông tin về hoạt động của người dùng.

Khái niệm chính

• Chủ đề (topic) là chủ đề mà người dùng hiện tại quan tâm (mọi người đều có thể đọc được), đồng thời chủ đề này cũng nằm trong cách phân loại chủ đề.
• Phương thức gọi là một thực thể (chẳng hạn như ứng dụng, SDK bên thứ ba, trang web hoặc dịch vụ) đưa ra yêu cầu đến Topics API để quan sát hoặc truy cập vào mối quan tâm của người dùng.
• Một chủ đề sẽ được quan sát qua một phương thức gọi, nếu phương thức gọi đó đã đưa ra yêu cầu API Chủ đề từ một trang web hoặc ứng dụng liên kết với chủ đề này trong suốt 3 khoảng thời gian bắt đầu vừa qua của hệ thống.
• Thời gian bắt đầu của hệ thống là khoảng thời gian tính toán chủ đề, mặc định là một tuần.
• Hệ thống phân loại là một danh sách danh mục phân cấp, bao gồm các danh mục như /Arts & Entertainment/Music & Audio/Soul & R&B và /Business & Industrial/Business Services/Corporate Events.
• Các chủ đề được lấy bằng cách sử dụng mô hình phân loại liên kết hoạt động của người dùng với 0 hoặc nhiều chủ đề.

Các bước chính trong quy trình của Topics API

Vòng đời của Topics API có 3 bước chính:

• Quan sát hoạt động của người dùng, chẳng hạn như khi họ truy cập vào trang web https://cats.example/tabby/index.html hoặc tải ứng dụng cats xuống.
• Trích xuất chủ đề từ hoạt động của người dùng, ví dụ: /Pets & Animals/Pets/Cats.
• Các chủ đề truy cập mà người dùng từng quan tâm, chẳng hạn như một tín hiệu để chọn quảng cáo phù hợp (chẳng hạn như quảng cáo thức ăn cho mèo).

Quan sát chủ đề

Phương thức gọi chỉ có thể truy cập vào những chủ đề mà họ quan sát được. Phương thức gọi quan sát một chủ đề khi thực hiện yêu cầu Topics API từ một ngữ cảnh liên kết với chủ đề này. Để minh hoạ khái niệm này, hãy xem xét ví dụ đơn giản sau.

• Giả sử có hai phương thức gọi API Chủ đề: A và B.
• Có hai ngữ cảnh:
  • Greenhouse, ví dụ: một ứng dụng có tên Greenhouse hoặc trang web greenhouse.example, được liên kết với chủ đề Home & Garden.
  • Bài tập thể dục quần vợt, ví dụ: một ứng dụng có tên là Bài tập thể dục quần vợt hoặc trang web tennis.example, được liên kết với chủ đề Sports/Tennis.
• Cả phương thức gọi A và B đều có trong ngữ cảnh của Greenhouse.
• Chỉ có phương thức gọi B xuất hiện trong ngữ cảnh của Bài tập thể dục tennis.
• Giả sử không có chủ đề nào được quan sát cho người dùng trước thời gian bắt đầu 1, để đơn giản hoá.
• Người dùng truy cập vào ứng dụng Greenhouse và phương thức gọi A và B thực hiện lệnh gọi API Chủ đề để ghi lại lượt truy cập của người dùng vào trang hoặc ứng dụng (xem hướng dẫn triển khai được đề xuất trong phần Các bước tiếp theo để tìm hiểu cách gọi API Chủ đề). Sau đó, bản ghi này (tên máy chủ hoặc dữ liệu ứng dụng) được dùng để suy ra các chủ đề bạn quan tâm. Sau đó, Topics API sẽ đánh dấu chủ đề Home & Garden là chủ đề được cả phương thức gọi A và B ghi nhận.
• Người dùng truy cập vào ứng dụng Bài tập thể dục tennis. Chỉ phương thức gọi B mới gửi yêu cầu Topics API. Sau đó, Topics API sẽ đánh dấu chủ đề Sports/Tennis là chủ đề mà phương thức gọi B đã quan sát được.
• Vào cuối thời gian bắt đầu của hệ thống, Topics API sẽ làm mới các chủ đề hàng đầu của người dùng và xác định những phương thức gọi đã quan sát thấy các chủ đề này dựa trên hoạt động của người dùng.
• Sau đó, khi phương thức gọi B thực hiện một lệnh gọi API Chủ đề khác, phương thức này có thể nhận được chủ đề Home & Garden hoặc Sports/Tennis (hoặc một chủ đề ngẫu nhiên với xác suất 5%) cho người dùng này trong mảng phản hồi.
• Phương thức gọi A chỉ có thể truy cập vào chủ đề Home & Garden, vì phương thức này chưa bao giờ quan sát thấy chủ đề Sports/Tennis. Điều này có nghĩa là bên thứ ba sẽ chỉ tìm hiểu về chủ đề mà người dùng quan tâm trong bối cảnh cụ thể (ứng dụng hoặc trang web) nơi chủ đề đó xuất hiện.

Trích xuất chủ đề

Chủ đề lấy chủ đề quan tâm từ hoạt động của người dùng. Các chủ đề này được chọn từ một hệ thống phân loại nguồn mở được xác định trước. Mỗi khoảng thời gian bắt đầu của hệ thống, API Chủ đề sẽ làm mới 5 chủ đề hàng đầu của người dùng và những phương thức gọi đã quan sát thấy các chủ đề đó trong khoảng thời gian bắt đầu của hệ thống. Mô hình phân loại Chủ đề lấy chủ đề từ hoạt động của người dùng: tên máy chủ lưu trữ cho một lượt truy cập trang web, thông tin ứng dụng trên Android.

Phương thức gọi truy cập vào các chủ đề mà người dùng quan tâm

API chỉ trả về những chủ đề mà phương thức gọi đã quan sát được trong 3 khoảng thời gian bắt đầu gần đây nhất của hệ thống. Hệ thống có thể trả về tối đa 3 chủ đề cho phương thức gọi,mỗi chủ đề cho một trong 3 khoảng thời gian bắt đầu gần đây (nếu phương thức gọi đã quan sát thấy các chủ đề cho khoảng thời gian bắt đầu đó). Phương thức gọi có thể sử dụng các chủ đề được trả về để bổ sung cho mọi thông tin theo ngữ cảnh và có thể kết hợp các chủ đề này để giúp tìm quảng cáo phù hợp hơn cho người dùng.

Thời gian bắt đầu

Topics API phải đảm bảo rằng các chủ đề mà API cung cấp luôn được cập nhật. Các chủ đề được suy luận cho người dùng dựa trên hoạt động của họ trong một khoảng thời gian gọi là thời gian bắt đầu của hệ thống (theo mặc định là một tuần). Mỗi người dùng có các epoch riêng (epoch là "trên mỗi người dùng") và thời gian bắt đầu ban đầu được tạo ngẫu nhiên.

Sau mỗi khoảng thời gian bắt đầu của hệ thống, Topics API sẽ tính toán 5 chủ đề hàng đầu của người dùng và xác định những phương thức gọi nào đã quan sát thấy các chủ đề đó bằng thông tin trên thiết bị. Chủ đề được chọn cho mỗi thời gian bắt đầu của hệ thống sẽ được chọn ngẫu nhiên trong 5 chủ đề hàng đầu của người dùng trong khoảng thời gian đó. Để tăng cường quyền riêng tư và đảm bảo rằng tất cả chủ đề đều có thể được thể hiện, có 5% khả năng chủ đề được chọn ngẫu nhiên trong số tất cả chủ đề có thể có trong hệ thống phân loại mối quan tâm.

Các chủ đề về Android trong thực tế

Topics API trên Android được thiết kế để hỗ trợ các SDK quảng cáo của bên thứ ba thường hoạt động trên nhiều ứng dụng. Topics cung cấp cho phương thức gọi các chủ đề quảng cáo được quan tâm ở dạng thô dựa trên hoạt động dùng ứng dụng của người dùng, mà không cần dựa vào giá trị nhận dạng trên nhiều ứng dụng. Bạn có thể dùng những chủ đề này để bổ sung cho mọi thông tin theo ngữ cảnh liên quan đến ứng dụng muốn hiển thị quảng cáo và có thể kết hợp chúng để giúp chọn quảng cáo phù hợp cho người dùng.

Trong ngữ cảnh của Topics API, người mua và nhà quảng cáo phụ thuộc vào bên bán. Bên bán là phía người bán xuất hiện rộng rãi trên các ứng dụng của nhà xuất bản và quan sát các chủ đề của người dùng, sau đó chia sẻ chủ đề với người mua để giúp họ chọn quảng cáo phù hợp hơn. Để nhận được chủ đề, ứng dụng và SDK bên bán phải thiết lập một mức sử dụng bằng cách trở thành trình quan sát của Topics API trong ít nhất một thời gian bắt đầu của hệ thống.

Hãy tham khảo Hướng dẫn triển khai Topics API ) đối với các mã mẫu minh hoạ cách thiết lập khả năng tìm nạp các chủ đề cho quảng cáo dựa trên mối quan tâm.

Tích hợp chủ đề theo loại hình doanh nghiệp

Bật tính năng IBA (quảng cáo dựa trên mối quan tâm) bằng Topics API. Làm theo các bước dựa trên loại hình doanh nghiệp công nghệ quảng cáo của bạn để tích hợp Topics API và chuẩn bị sẵn sàng cho việc ra mắt.

Dành cho mọi công nghệ quảng cáo

• Xem xét hệ thống phân loại Chủ đề và đưa ra ý kiến phản hồi.
• Hãy thử nghiệm với ứng dụng mẫu Topics API để xem dữ liệu chủ đề nào được trả về từ thuật toán phân loại trên thiết bị.
• Cập nhật luồng ứng dụng và luồng SDK để bắt đầu gọi API Chủ đề.
• Cập nhật giao thức để bắt đầu gửi các chủ đề trong yêu cầu quảng cáo.
• Đăng ký công nghệ quảng cáo bằng Hộp cát về quyền riêng tư.

Đối với công nghệ quảng cáo của bên bán

• Trở thành trình quan sát để thiết lập một mức sử dụng API Chủ đề. API Chủ đề cung cấp một tín hiệu mới, vì vậy, bạn cần cập nhật SDK để bắt đầu gọi API Chủ đề. Để truy xuất nhất quán các chủ đề, SDK của bạn phải gọi API từ các ứng dụng của nhà xuất bản ít nhất một lần mỗi khoảng thời gian bắt đầu của hệ thống. Cần tới 4 khoảng thời gian bắt đầu của hệ thống thì mới nhận được số lượng chủ đề tối đa (3 chủ đề) để gửi cùng với yêu cầu quảng cáo.
• Đưa thông tin về API Chủ đề vào các yêu cầu quảng cáo. Đối với mỗi yêu cầu quảng cáo, hãy bắt đầu chia sẻ dữ liệu API Chủ đề với các đối tác bên mua. Topics API dự định bổ sung các tín hiệu khác (chẳng hạn như tín hiệu theo bối cảnh) để giúp tìm ra quảng cáo phù hợp cho một khách truy cập nhất định.
• Cộng tác trên một giao thức để chia sẻ chủ đề với các đối tác bên mua. API Chủ đề cần có từng SDK để làm việc với các đối tác phân phối thành phẩm để thoả thuận về cách chia sẻ dữ liệu API Chủ đề.

Dành cho công nghệ quảng cáo của bên mua

• Kết nối với các đối tác bên bán để xác nhận kế hoạch quan sát chủ đề và thiết lập mức sử dụng. Để nhận được chủ đề, nhà cung cấp bên bán phải gọi API Chủ đề ít nhất một lần cho mỗi khoảng thời gian bắt đầu của hệ thống.
• Cộng tác trên một giao thức để nhận chủ đề từ các đối tác bên bán. Chủ đề là một tín hiệu mới mà các đối tác bên bán chia sẻ trong yêu cầu quảng cáo. Người tiêu dùng bên mua cần đảm bảo rằng họ trao đổi với các đối tác cung cấp dữ liệu về cách chia sẻ chủ đề.
• Kết hợp các chủ đề trong mô hình đặt giá thầu và mô hình tối ưu hoá. API Chủ đề dự kiến sẽ bổ sung các tín hiệu khác như bối cảnh để giúp tìm thấy một quảng cáo phù hợp cho khách truy cập.

Cách API dự đoán chủ đề cho một ứng dụng

Trên Android, Topics API dự đoán các chủ đề cho một ứng dụng dựa trên thông tin về ứng dụng bằng một mô hình thuật toán phân loại. Trong quá trình triển khai hiện tại, Chủ đề dùng tên ứng dụng và tên gói để chỉ định chủ đề mà ứng dụng quan tâm, nhưng sau này có thể mở rộng phạm vi để bao gồm các thông tin khác như nội dung mô tả ứng dụng.

Thuật toán phân loại chủ đề

Các chủ đề được quan tâm được lấy từ mô hình thuật toán phân loại được huấn luyện dựa trên thông tin công khai về ứng dụng.

• Khi mô hình phân loại được dùng để suy luận nhằm tính toán các chủ đề trong một khoảng thời gian bắt đầu nhất định của hệ thống, thì tập hợp tín hiệu được dùng sẽ vẫn nằm trên thiết bị. Tập hợp tín hiệu này có thể bao gồm các ứng dụng đã cài đặt hoặc được sử dụng gần đây, và sau này có thể được mở rộng để bao gồm các tín hiệu khác.
• Mô hình V5 được Google huấn luyện dựa trên 540.000 thông tin ứng dụng công khai được gắn nhãn con người và 17 triệu thông tin ứng dụng công khai có nhãn ML từ các cửa hàng ứng dụng như Cửa hàng Google Play. Mô hình này sử dụng tên ứng dụng và tên gói làm tín hiệu đầu vào. Mô hình này được cung cấp miễn phí cho các nhà phát triển ứng dụng để kiểm thử cũng như xem ứng dụng của họ được phân loại vào chủ đề nào.
• Có thể một ứng dụng ánh xạ đến nhiều chủ đề, không ánh xạ đến chủ đề nào hoặc không được thêm vào nhật ký chủ đề của người dùng. Trong trường hợp một ứng dụng ánh xạ đến nhiều chủ đề trong cách phân loại, số lượng chủ đề được chọn cho ứng dụng này sẽ được giới hạn ở 3 chủ đề hàng đầu.

Để hiểu rõ hơn về cách hoạt động của mô hình thuật toán phân loại, bạn có thể kiểm thử mức độ ảnh hưởng của các dữ liệu ứng dụng khác nhau đến hoạt động phân loại bằng cách sử dụng Colab phân loại chủ đề của Android

Cách phân loại

Các chủ đề được chọn từ hệ thống phân loại nguồn mở được xác định trước. Hệ thống phân loại này được cung cấp công khai và có thể thay đổi. Bạn có thể gửi đề xuất bằng cách sử dụng nút phản hồi ở đầu trang này. Cách phân loại này do con người chọn lọc, do đó, các chủ đề nhạy cảm sẽ không được đưa vào cách phân loại này. Quảng cáo này sẽ được điều chỉnh theo danh mục quảng cáo có thể hiển thị trên ứng dụng dành cho thiết bị di động trên Android.

Chủ đề trên Android trong thực tế

Giả sử một người dùng đã cài đặt 7 ứng dụng trên thiết bị: A, B, C, D, E, F và G. Giả sử việc phân loại chủ đề cho ứng dụng và SDK công nghệ quảng cáo trong các ứng dụng này như sau:

Kết thúc tuần một: Topics API tạo ra 5 chủ đề hàng đầu của người dùng trong khoảng thời gian bắt đầu của hệ thống này.

Trong tuần thứ 2, nếu một phương thức gọi trên bất kỳ ứng dụng nào gọi đến API, thì danh sách chủ đề được trả về sẽ chỉ bao gồm những chủ đề mà phương thức gọi có trong "Những phương thức gọi có thể tìm hiểu về chủ đề này" cho chủ đề đó cho ứng dụng trong thời gian bắt đầu của hệ thống.

• Khoảng thời gian nhật ký được dùng khi tính toán chủ đề có sẵn cho mỗi phương thức gọi là 3 khoảng thời gian bắt đầu của hệ thống (hoặc 3 tuần).
• Chỉ những chủ đề liên kết với các ứng dụng gọi ra Topics API thông qua SDK quảng cáo mới được sử dụng. Tức là nếu một ứng dụng không chứa bất kỳ SDK quảng cáo nào gọi Topics API, thì các chủ đề liên kết với ứng dụng đó không đóng góp vào nhóm chủ đề mà SDK quảng cáo có thể truy cập.
• Ứng dụng cũng có thể chọn không sử dụng Topics API theo cách khai báo. Các chủ đề liên kết với ứng dụng không được chọn sẽ không đóng góp vào việc tính toán chủ đề hằng tuần. Tài liệu này sẽ được cập nhật để bổ sung thông tin chi tiết về hoạt động triển khai có liên quan.

Nếu không có đủ mức dùng ứng dụng cho nền tảng để dự đoán 5 chủ đề, nền tảng có thể cân nhắc những lựa chọn, chẳng hạn như tạo ngẫu nhiên các chủ đề còn lại.

Mã hoá các chủ đề được trả về

Các nền tảng công nghệ quảng cáo đã đăng ký gọi Topics API cũng phải cung cấp khoá mã hoá để đảm bảo rằng chỉ phương thức gọi mới có thể đọc được các chủ đề được trả về.

Hộp cát về quyền riêng tư sẽ tìm nạp các khoá này từ điểm cuối do công nghệ quảng cáo cung cấp . T4 bạn nên cập nhật khoá thường xuyên, tối thiểu là 6 tháng một lần.

Hộp cát về quyền riêng tư sẽ yêu cầu công nghệ quảng cáo xác nhận khả năng sử dụng điểm cuối mà họ cung cấp trong quá trình đăng ký. Để biết thêm chi tiết về hành động bắt buộc theo công nghệ quảng cáo hiện tại và công nghệ quảng cáo mới đăng ký, hãy xem hướng dẫn đăng ký

Các bước tiếp theo

Xem thêm

Hãy xem các tài nguyên của chúng tôi để hiểu rõ hơn về API Chủ đề trên Android.

• Hãy xem các ứng dụng mẫu, video cộng tác và hướng dẫn trong chủ đề.
• Xem cách người dùng và nhà phát triển có thể kiểm soát API.
• Xem các tài nguyên hỗ trợ để đặt câu hỏi, tương tác và chia sẻ ý kiến phản hồi.