FLEDGE trên Android bao gồm API đối tượng tùy chỉnh [API Đối tượng tùy chỉnh] và API lựa chọn quảng cáo [API Cụm chọn quảng cáo]. Các nhà quảng cáo và nền tảng công nghệ quảng cáo có thể sử dụng các API này để phân phối quảng cáo tùy chỉnh tùy chỉnh dựa trên hoạt động tương tác trước đây với Ứng dụng quảng cáo giới hạn việc chia sẻ giá trị nhận dạng giữa các ứng dụng
API đối tượng tùy chỉnh tệp trung vào bản tóm tắt "đối tượng tùy chỉnh tùy chỉnh", đại diện cho một nhóm người dùng có ý định chung. Nhà quảng cáo có thể đăng ký người dùng với một đối tượng tùy chỉnh và liên kết quảng cáo có liên quan với đối tượng đó. Thông báo này được lưu trữ trên máy và có thể sử dụng để thông báo giá thầu của nhà quảng cáo, lọc quảng cáo và hiển thị quảng cáo.
API lựa chọn quảng cáo cung cấp một khung cho phép nhiều nhà phát triển điều chỉnh tiến trình hành động một phiên đấu giá cục bộ cho các đối tượng tùy chỉnh. Để đạt được điều này, hệ thống sẽ xem xét các quảng cáo liên quan được liên kết với các đối tượng tùy chỉnh, đồng thời thực hiện công việc xử lý bổ sung đối với các quảng cáo mà nền tảng công nghệ quảng cáo được đưa trở lại
Nền tảng công nghệ quảng cáo có thể tích hợp các API này để phát triển hoạt động tái sinh tiếp thị bảo vệ quyền riêng tư của người dùng. Chúng tôi dự kiến hỗ trợ thêm nhiều trường hợp sử dụng, bao gồm cả quảng cáo cài đặt ứng dụng, dự kiến kiến trúc sẽ phát triển hành động trong tương lai. Vui lòng tìm hiểu thêm về FLEDGE trên Android trong phần đề xuất thiết kế
Hướng dẫn dành cho nhà phát triển này mô tả cách làm việc với FLEDGE trên Android để thực hiện những công việc sau
- Quản lý đối tượng tùy chỉnh
- Thiết lập và chạy lựa chọn quảng cáo trên thiết bị
- Báo cáo số lượng hiển thị quảng cáo
Before when started
Trước khi bắt đầu, hãy hoàn thành các bước sau
- Your setting môi trường phát triển của bạn cho Hộp cát về quyền riêng tư trên Android
- Cài đặt hệ thống ảnh trên thiết bị được hỗ trợ hoặc thiết lập trình mô phỏng bao gồm chức năng được hỗ trợ cho Hộp cát về quyền riêng tư trên Android
Trong dòng lệnh, hãy bật quyền truy cập vào API FLEDGE [bị tắt theo mặc định] bằng lệnh adb sau
adb shell device_config put adservices ppapi_app_allow_list \"*\"
chuyển quyền
3 vào tệp kê khai ứng dụngTham khảo cấu hình dịch vụ quảng cáo trong phần tử
4 của tệp kê khaiChỉ định tài nguyên XML của dịch vụ quảng cáo được tham chiếu trong tệp kê khai, có hạn như
5. Vui lòng tìm hiểu thêm về việc kiểm soát quyền truy cập vào SDK và dịch vụ quảng cáoTheo mặc định, API Cụm quảng cáo lựa chọn sẽ thực thi các giới hạn về dung lượng bộ nhớ tối đa mà một tập lệnh báo cáo được hiển thị hoặc phiên đấu giá có thể được phân tích bổ sung. Tính năng giới hạn bộ nhớ yêu cầu phiên bản WebView 105. 0. 5195. 58 trở lên. Nền tảng sẽ thực thi quy trình kiểm tra phiên bản và các lệnh gọi đến API
6 và
7 sẽ không thành công nếu quy trình này không được trả lời. Có 2 lựa chọn để thiết lậpSelected 1. Chạy lệnh adb after để tắt tính năng kiểm tra này
adb device_config put fledge_js_isolate_enforce_max_heap_size false
Selection 2. Cài đặt WebView Beta từ Cửa hàng Google Play. Phiên bản này phải bằng hoặc cao hơn phiên bản nêu trên
Tham gia một đối tượng tùy chỉnh
Đối tượng tùy chỉnh đại diện cho một nhóm người dùng có cùng ý định hoặc mối quan tâm do ứng dụng của nhà quảng cáo quyết định. Một ứng dụng hoặc SDK có thể sử dụng các đối tượng tùy chỉnh để biết một công cụ đối tượng có thể, giả sử như ai đó đã chọn sẵn các mặt hàng trong thùng hàng. Để tạo hoặc tham gia một đối tượng tùy chỉnh, chỉnh sửa một cách không đồng bộ, hãy làm như sau
- Khởi động đối tượng
8 - Tạo đối tượng
9 bằng cách chỉ định các gói tham số chính, chẳng hạn như người mua và tên có liên quan. Sau đó, hãy khởi động đối tượng
0 bằng đối tượngadb device_config put fledge_js_isolate_enforce_max_heap_size false
9 - Gọi
2 không đồng bộ với các đối tượngadb device_config put fledge_js_isolate_enforce_max_heap_size false
0 cũng như các đối tượngadb device_config put fledge_js_isolate_enforce_max_heap_size false
4 vàadb device_config put fledge_js_isolate_enforce_max_heap_size false
5 có liên quanadb device_config put fledge_js_isolate_enforce_max_heap_size false
Kotlin
8
Java
9
Tổ hợp các tham số sau sẽ xác định riêng từng đối tượng
9 trên thiết bị
7. Tên gói của ứng dụng chủ sở hữu. Giá trị này được đặt thành tên gói của ứng dụng gọiadb device_config put fledge_js_isolate_enforce_max_heap_size false
8. Giá trị nhận dạng của quảng cáo quảng cáo của người mua quản lý quảng cáo cho các đối tượng tùy chỉnh nàyadb device_config put fledge_js_isolate_enforce_max_heap_size false
9. Tên hoặc giá trị nhận dạng tùy ý cho các đối tượng tùy chỉnhadb device_config put fledge_js_isolate_enforce_max_heap_size false
Việc gọi
adb device_config put fledge_js_isolate_enforce_max_heap_size false
2 nhiều lần bằng một bản sao khác của
9 sẽ cập nhật mọi
9 hiện có với
83 phù hợp cũng như adb device_config put fledge_js_isolate_enforce_max_heap_size false
9 tham số. Để bảo vệ quyền riêng tư, kết quả của API không phân biệt giữa lệnh "tạo" và "cập nhật"Ngoài ra,
9 phải được tạo bằng các tham số bắt buộc sau- URL cập nhật hằng ngày. Một loại URL HTTPS được truy vấn hằng ngày ở chế độ nền để cập nhật tín hiệu đặt giá thầu của người dùng thuộc đối tượng tùy chỉnh, dữ liệu đặt giá thầu đáng tin cậy, URL hiển thị và siêu dữ liệu cho quảng cáo
- logic URL đặt giá trị. Một URL HTTPS được truy vấn trong quá trình lựa chọn quảng cáo để tìm logic đặt giá thầu JavaScript của người mua. Xem các ký tự chức năng bắt buộc trong JavaScript này
Các tham số không bắt buộc đối với đối tượng
9 có thể bao gồm- Thời gian kích hoạt. Các đối tượng tùy chỉnh chỉ có thể tham gia vào việc lựa chọn quảng cáo và cập nhật liên tục sau thời gian kích hoạt. Điều này, hạn chế, có thể hữu ích khi thu hút người dùng cũ
- Thời gian hết hạn. Một khoảng thời gian trong tương lai mà sau đó các đối tượng tùy chỉnh sẽ bị xóa khỏi thiết bị
- Insignia set value of user. Một chuỗi JSON chứa các tín hiệu giả có hạn như ngôn ngữ ưu tiên của người dùng mà logic đặt giá thầu JavaScript của người mua sử dụng để tạo giá thầu trong quá trình lựa chọn quảng cáo. Định dạng này giúp các nền tảng công nghệ quảng cáo sử dụng lại mã trên nhiều nền tảng và giảm mức tiêu thụ trong các hàm JavaScript
- Dữ liệu đặt giá trị đáng tin cậy. URL HTTPS và danh sách các chuỗi được sử dụng trong quá trình lựa chọn quảng cáo tìm kiếm tín hiệu đặt giá thầu từ máy chủ khóa/giá trị đáng tin cậy
- Quảng cáo. Danh sách các đối tượng
87 tương ứng với quảng cáo sẽ tham gia lựa chọn quảng cáo. Mỗi đối tượng
87 bao gồm- URL được hiển thị. URL HTTPS được truy vấn để hiển thị quảng cáo cuối cùng
- Siêu dữ liệu. Đối tượng JSON được chuyển đổi theo tuần tự dưới dạng một chuỗi chứa thông tin mà người mua sẽ đặt giá thầu theo logic trong quá trình lựa chọn quảng cáo
Dưới đây là ví dụ về lệnh tạo đối tượng
9Kotlin
4
Java
5
Xử lý kết quả joinCustomAudience[]
Phương thức
adb device_config put fledge_js_isolate_enforce_max_heap_size false
2 không đồng bộ sử dụng các đối tượng adb device_config put fledge_js_isolate_enforce_max_heap_size false
5 để thông báo hiệu quả của lệnh gọi API- Lệnh gọi lại
92 biểu tượng tùy chỉnh đối tượng đã được tạo hoặc cập nhật thành công - Lệnh gọi lại
93 có thể xảy ra biểu thị hai điều kiện- Nếu
0 được khởi tạo bằng các đối số không hợp lệ, thìadb device_config put fledge_js_isolate_enforce_max_heap_size false
95 sẽ chỉ ra nguyên nhân là
96 - Tất cả các lỗi khác nhau sẽ nhận được
95 với nguyên nhân là do
98
- Nếu
Sau đây là ví dụ về cách xử lý kết quả của
adb device_config put fledge_js_isolate_enforce_max_heap_size false
2Kotlin
6
Java
0
Bỏ tùy chỉnh đối tượng
Nếu người dùng không còn trả lời các tiêu chí kinh doanh cho một đối tượng tùy chỉnh nhất định, thì ứng dụng hoặc SDK có thể gọi
40 để xóa các đối tượng tùy chỉnh khỏi thiết bị. Để xóa
9 dựa trên các tham số riêng biệt, hãy làm như sau- Khởi tạo đối tượng
8 - Khởi tạo
43 bằng
9 vàadb device_config put fledge_js_isolate_enforce_max_heap_size false
8 của các đối tượng tùy chỉnh. Để tìm hiểu thêm về các trường nhập dữ liệu này, vui lòng đọc phần "Tham gia một đối tượng tùy chỉnh"adb device_config put fledge_js_isolate_enforce_max_heap_size false
- Gọi phương thức
40 không đồng bộ với các đối tượng
43 cũng như các đối tượng.
4 vàadb device_config put fledge_js_isolate_enforce_max_heap_size false
5 có liên quanadb device_config put fledge_js_isolate_enforce_max_heap_size false
Kotlin
1
Java
2
Tương tự như cuộc gọi
adb device_config put fledge_js_isolate_enforce_max_heap_size false
2, adb device_config put fledge_js_isolate_enforce_max_heap_size false
5 sẽ ra tín hiệu kết thúc lệnh gọi API. Để bảo vệ quyền riêng tư, kết quả lỗi sẽ không phân biệt giữa lỗi nội bộ và đối số không hợp lệ. Lệnh gọi lại
92 được gọi khi lệnh gọi API đã hoàn tất, cho dù đối tượng tùy chỉnh phù hợp có bị xóa thành công hay khôngChạy tùy chọn quảng cáo tùy chọn
Để chọn quảng cáo bằng FLEDGE, hãy gọi phương thức
53- Khởi động một đối tượng
54 - Tạo một đối tượng
55 - Gọi phương thức
53 không đồng bộ với các đối tượng
55 cũng như các đối tượng.
4 vàadb device_config put fledge_js_isolate_enforce_max_heap_size false
5 có liên quanadb device_config put fledge_js_isolate_enforce_max_heap_size false
Kotlin
3
Java
4
Phương thức
53 yêu cầu bắt đầu vào
55, trong đó bạn phải chỉ định các tham số bắt buộc sau- Người bán. Giá trị nhận dạng cho quảng cáo quảng cáo người bán bắt đầu quảng cáo lựa chọn quảng cáo
- quyết định logic URL. Một URL HTTPS được truy vấn để lấy logic JavaScript của người bán quảng cáo trên mạng. Xem các ký tự chức năng bắt buộc trong JavaScript này
- Người mua đối tượng tùy chỉnh. Danh sách đầy đủ các giá trị nhận dạng cho quảng cáo quảng cáo của người mua được người bán cho phép tham gia vào quá trình lựa chọn quảng cáo. Các giá trị nhận dạng người mua này tương ứng với CustomAudience. getbuyer[] in the number of TPP tùy chỉnh tham gia
Bạn có thể chỉ định các tham số sau đây để lựa chọn quảng cáo được tùy chỉnh nhiều hơn
- Tín hiệu lựa chọn quảng cáo. Đối tượng JSON được chuyển đổi tuần tự dưới dạng một chuỗi chứa các tín hiệu do logic đặt giá thầu JavaScript của người mua tìm tải từ
62 - Tín hiệu người bán. Đối tượng JSON được chuyển đổi theo tuần tự dưới dạng một chuỗi chứa các tín hiệu tín hiệu do logic quyết định tải JavaScript của người bán thu thập được từ
63 - Tín hiệu trên mỗi người mua. Bản đồ các đối tượng JSON được chuyển đổi tuần tự dưới dạng chuỗi chứa các tín hiệu tín hiệu logic đặt giá thầu của người mua công cụ có thể sử dụng mà JavaScript tìm tải từ
62, được xác định bằng các trường đối tượng tùy chỉnh tham gia của
Sau khi bạn chọn một quảng cáo, kết quả, giá ưu đãi và tín hiệu sẽ được giữ lại trong máy để báo cáo sau này. Từ lệnh gọi lại ResultReceiver. onResult[], bạn sẽ nhận lại được một AdSelectionResult chứa
- URL hiển thị cho quảng cáo chiến thắng, được lấy từ
65 - Mã nhận dạng bảo vệ lựa chọn quảng cáo dành riêng cho người dùng thiết bị. Mã này được sử dụng để báo cáo số lượng hiển thị quảng cáo
Nếu bạn không thể hoàn thành việc lựa chọn quảng cáo vì những lý do như đối số không hợp lệ, hết thời gian chờ hoặc sử dụng tài nguyên quá mức, thì lệnh gọi lại
66 sẽ cung cấp cho
95 với các hành vi dưới đây- Nếu lựa chọn quảng cáo được khởi tạo bằng các đối số không hợp lệ, thì
95 sẽ biết nguyên nhân là
96 - Tất cả các lỗi khác nhau sẽ nhận được
95 với nguyên nhân là do
98
Báo cáo số lượng hiển thị quảng cáo
Sau khi đã chọn một quảng cáo chiến thắng trong quy trình lựa chọn quảng cáo chiến thắng, bạn có thể báo cáo các lượt hiển thị trở lại nền tảng bên mua và bên bán tham gia bằng phương thức
02. Để báo cáo một quảng cáo được hiển thị, hãy làm như sau- Khởi động một đối tượng
54 - Tạo đối tượng
04 bằng mã lựa chọn quảng cáo - Gọi phương thức
05 không đồng bộ với các đối tượng
55 cũng như các đối tượng.
4 vàadb device_config put fledge_js_isolate_enforce_max_heap_size false
5 có liên quanadb device_config put fledge_js_isolate_enforce_max_heap_size false
Java
5
Kotlin
6
Khởi động
04 bằng các tham số bắt buộc sau- Mã lựa chọn quảng cáo. Mã nhận định dạng duy nhất cho người dùng thiết bị xác định một lựa chọn quảng cáo thành công
- Cấu hình lựa chọn quảng cáo. Cấu hình tương tự được sử dụng trong lệnh gọi
53 được xác định theo mã lựa chọn quảng cáo được cung cấp
Phương thức
05 không đồng bộ sử dụng các đối tượng adb device_config put fledge_js_isolate_enforce_max_heap_size false
5 để báo hiệu kết quả của lệnh gọi API- Lệnh gọi lại
92 để biết lựa chọn quảng cáo đã hoàn thành hay chưa - Lệnh gọi lại
93 để biết các điều kiện có thể xảy ra sau đây- Nếu lệnh gọi được khởi tạo bằng một đối số đầu vào không hợp lệ, thì
95 sẽ biết nguyên nhân là
96 - Tất cả các lỗi khác nhau sẽ nhận được
95 với nguyên nhân là do
98
- Nếu lệnh gọi được khởi tạo bằng một đối số đầu vào không hợp lệ, thì
Điểm cuối của báo cáo được hiển thị
API hiển thị báo cáo sẽ gửi yêu cầu HTTPS NHẬN đến các điểm cuối làm nền bên bán và bên mua thắng cuộc cung cấp
Điểm cuối trên nền bên mua
- API sẽ sử dụng logic URL đặt giá thầu được chỉ định trong các đối tượng tùy chỉnh để tìm logic đặt giá thầu JavaScript của người mua
- JavaScript JavaScript call
19. Hàm này dự kiến sẽ trả về URL báo cáo hiển thị của người mua
Điểm cuối trên nền tảng bên bán
- Sử dụng logic URL quyết định chỉ được xác định trong đối tượng
55 để tìm tải logic quyết định JavaScript của người bán - JavaScript JavaScript call
21. Hàm này dự kiến sẽ trả về URL báo cáo hiển thị của người mua
Các báo cáo hiển thị với nỗ lực cao nhất
05 được thiết kế để mang lại khả năng hoàn thành báo cáo tốt nhấtLưu ý- Nếu không thể xác định URL báo cáo được hiển thị từ các hàm JavaScript, API sẽ trả về một lỗi
- Nếu lệnh gọi đến URL không thành công, thì Bản dùng thử dành cho nhà phát triển hiện tại không gây ra lỗi nào. Chúng tôi dự kiến thử lại logic cho các lỗi tạm thời được lên kế hoạch với bản phát hành trong tương lai
- Nếu bạn thực hiện nhiều lệnh gọi đến
05 bằng các tham số giống nhau, thì kết quả lựa chọn quảng cáo của bạn có thể bị báo cáo nhiều lần
Cập nhật hằng ngày ở chế độ nền
Khi tạo một đối tượng tùy chỉnh, ứng dụng hoặc SDK của bạn có thể khởi động siêu dữ liệu đối tượng tùy chỉnh. Ngoài ra, nền tảng có thể cập nhật các siêu dữ liệu đối tượng tùy chỉnh sau đây bằng quy trình cập nhật hằng ngày ở chế độ nền
- Insignia set value of user
- Dữ liệu đặt giá trị đáng tin cậy
- Danh sách
87
Quá trình truy vấn URL này cập nhật hằng ngày được xác định trong các đối tượng tùy chỉnh và URL có thể trả về phản hồi JSON
- Phản hồi JSON có thể chứa bất kỳ trường dữ liệu siêu dữ liệu nào được hỗ trợ cần được cập nhật
- Mỗi trường JSON sẽ được xác thực theo một cách độc lập. Ứng dụng sẽ bỏ qua mọi trường hợp định dạng không chính xác, điều này dẫn đến việc không cập nhật trường cụ thể trong phản hồi
- Phản hồi HTTP trống hoặc đối tượng JSON trống “
25” sẽ dẫn đến việc không cập nhật siêu dữ liệu - Kích thước của thông báo phản hồi phải được giới hạn trong 10 KB
- You must have all URI to use HTTPS
26 phải chia sẻ cùng một ETLD+1 với người mua
Ví dụ. phản hồi JSON cho tính năng cập nhật hằng ngày ở chế độ nền
7JavaScript cho phép lựa chọn quảng cáo
Quy trình lựa chọn quảng cáo phân phối hợp tác thực thi JavaScript do người mua và người bán cung cấp
JavaScript do người mua cung cấp được tìm nạp từ logic URL Đặt giá thầu đã được xác định duy nhất trong các đối tượng tùy chỉnh. JavaScript được trả về phải bao gồm các hàm sau
27
19
JavaScript do người bán cung cấp được tìm thấy tải từ logic URL quyết định được chỉ định trong tham số
55 cho API lựa chọn quảng cáo. JavaScript được trả về phải bao gồm các hàm sau
30
21
tạoBid[]
8Tham số đầu vào
32. JSON object has var
33 format as after;
34. các đối tượng JSON được chỉ định trong các đối tượng được định giá cấu hình
35. các đối tượng JSON làm nền tảng tạo ra. Format for this object JSON is
9không có I
83 và
9 là chuỗi được lấy từ các thuộc tính có cùng tên của Đối tượng tùy chỉnh tham gia vào quá trình lựa chọn quảng cáoadb device_config put fledge_js_isolate_enforce_max_heap_size false
38 và
39 là thời gian kích hoạt và hết hạn của các đối tượng tùy chỉnh, được biểu thị bằng giây kể từ Thời gian bắt đầu của hệ thống Unix
40 là một chuỗi JSON được định nghĩa chỉ trong trường
41 của
9 tại thời điểm tạo
43 và
44 là các đối tượng JSON. Hiện tại, chúng được truyền dưới dạng các đối tượng trống và sẽ được đưa vào các bản phát hành trong tương lai. Định dạng của chúng không được nền tảng thực thi và do công nghệ quảng cáo quản lý
Kết quả
32. là quảng cáo mà giá đề cập đến. Lệnh được phép trả về bản sao của quảng cáo đã nhận được cùng với siêu dữ liệu khác. Thuộc tính
46 của quảng cáo dự kiến sẽ không bị thay đổi
47. một số giá trị thực hiện biểu thị giá trị ưu đãi cho quảng cáo này
48. a integer value may be- 0. để thực hiện thành công
- 1. [hoặc bất kỳ giá trị nào khác 0] trong trường hợp có bất kỳ tín hiệu đầu vào nào không hợp lệ. Trong trường hợp giá trị khác 0 được trả lại bằng cách tạo giá thầu, quá trình đặt giá thầu sẽ không hợp lệ đối với tất cả quảng cáo dành cho CA
điểmAd[]
0Tham số đầu vào
32. vui lòng xem tài liệu về
50
47. giá trị thương mại cho quảng cáo
52. a object JSON đại diện cho tham số
55 của API
6. Format is
1
55. Các đối tượng JSON được đọc từ tham số API
56
55
58. read from field
59 in API tham số
55
61. Đối tượng JSON. Hiện tại, chúng được truyền dưới dạng các đối tượng trống và sẽ được đưa vào các bản phát hành trong tương lai. Định dạng của chúng không được nền tảng thực thi và do công nghệ quảng cáo quản lý
62. Đối tượng JSON được đọc từ bản đồ
63 trong API tham số
55 sử dụng làm khóa cho người mua Đối tượng tùy chỉnh hiện tại. Để trống nếu bản đồ không chứa bất kỳ mục nhập nào cho người mua cụ thể
Kết quả
65. a value value of the current point value for this ads
48. a integer value may be- 0. để thực hiện thành công
- 1. invalid field
67 invalid - 2. invalid field
55 invalid - 3. in the field HỢP HỢP CÓ NHỮNG HIỆU LỰC HIỆU QUẢ KHÔNG HỢP LỆ
- Bất kỳ giá trị nào khác 0 đều sẽ gây ra lỗi xử lý, giá trị này sẽ xác định các trường hợp ngoại lệ được gửi
báo cáoKết quả[]
2Tham số đầu vào
52. vui lòng xem tài liệu
70
46. URL hiển thị của quảng cáo chiến thắng
47. giá thầu được cung cấp cho quảng cáo chiến thắng
73. vui lòng xem tài liệu
50
Kết quả
75 cho thành công và khác 0 cho trạng thái không thành công
76. các đối tượng JSON chứa
77. đối tượng JSON sẽ được truyền đến hàm reportWin
78. URL được nền tảng sử dụng để thông báo hiển thị cho người mua
báo cáoWin[]
3Tham số đầu vào
79. vui lòng xem tài liệu
70
77. object JSON do
82 return
83. vui lòng xem tài liệu
50
Kết quả
75 cho thành công và khác 0 cho trạng thái không thành công
76. các đối tượng JSON chứa
78. URL được nền tảng sử dụng để thông báo về các màn hình hiển thị cho người bán
thử nghiệm
Để giúp bạn làm quen với FLEDGE, chúng tôi đã tạo các mẫu ứng dụng trong Kotlin và Java, có thể tìm thấy trên GitHub
Điều kiện tiên quyết
FLEDGE yêu cầu một số JavaScript trong quá trình lựa chọn quảng cáo và báo cáo số lượng hiển thị. Có hai phương thức để cung cấp JavaScript này trong môi trường thử nghiệm
- Run the host with the end of HTTPS bắt buộc phải trả về JavaScript
- Ghi lại tính năng tìm nạp từ xa bằng cách cung cấp mã cần thiết từ một bộ nguồn cục bộ
Một trong hai cách tiếp cận đều yêu cầu thiết lập một điểm cuối HTTPS để xử lý báo cáo hiển thị
HTTPS endpoint
Để thử trải nghiệm lựa chọn quảng cáo và báo cáo hiển thị như thế nào, bạn cần thiết lập HTTPS 7 điểm cuối cùng mà thiết bị thử nghiệm hoặc trình mô phỏng có thể truy cập được
- Điểm cuối của người mua phân phát JavaScript logic đặt giá trị
- Một điểm cuối phân phối tín hiệu đặt giá trị
- Điểm cuối của người bán phân phối logic JavaScript được quyết định
- Một điểm cuối cùng của tín hiệu phân phối điểm
- Điểm cuối báo cáo hiển thị của người mua được cấp quyền mua
- Điểm cuối báo cáo hiển thị của người bán
- Một điểm cuối phân phát các bản cập nhật hằng ngày cho tùy chỉnh các đối tượng
Để thuận tiện, hãy lưu trữ GitHub cung cấp mã JavaScript cơ bản cho mục đích thử nghiệm. Phiên bản này cũng bao gồm các định nghĩa dịch vụ OpenAPI có thể được phát triển khai thác cho các nền tảng mô phỏng hoặc microservices được hỗ trợ. Để biết thêm thông tin chi tiết, vui lòng tham khảo phần README của dự án
Ghi đè tính năng tìm kiếm từ xa của JavaScript
Bạn có thể sử dụng tính năng này để thử nghiệm một cách toàn diện. Để ghi lại tính năng tìm tải từ xa, ứng dụng của bạn phải chạy ở chế độ khử lỗi và bật các tùy chọn cho nhà phát triển
Để bật chế độ gỡ lỗi cho ứng dụng của bạn, hãy thêm dòng sau vào thuộc tính ứng dụng trong AndroidManifest. xml
4Lưu ý. Hãy nhớ xóa
88" trước khi bạn gửi ứng dụng của mìnhĐể xem ví dụ về cách sử dụng các chế độ ghi đè này, vui lòng xem ứng dụng mẫu FLEDGE trên GitHub
Bạn cần thêm JavaScript tùy chỉnh của riêng mình để quản lý các quy trình phán đoán chọn quảng cáo, chẳng hạn như chiến lược đặt giá thầu, cách tính điểm và báo cáo. Bạn có thể tìm thấy các ví dụ cơ bản về mã JavaScript xử lý tất cả các yêu cầu bắt buộc trong kho lưu trữ GitHub. Ứng dụng mẫu FLEDGE mô tả cách đọc mã từ tệp đó và mã chuẩn để sử dụng chế độ ghi đè
Bạn có thể ghi đè tìm tải JavaScript bên bán và bên mua một cách độc lập, mặc dù bạn cần có một điểm cuối HTTPS để phân phát bất kỳ JavaScript nào mà bạn không cung cấp cơ chế ghi đè. Vui lòng xem phần README để biết thông tin chi tiết về cách thiết lập máy chủ xử lý các trường hợp này
Bạn chỉ có thể ghi đè phương thức tìm tải JavaScript cho các gói tùy chỉnh đối tượng tùy chỉnh thuộc về mình
Ghi đè JavaScript của bên bán
Để thiết lập cơ chế ghi đè JavaScript bên bán, hãy thực hiện như được minh hoạ trong ví dụ về mã bên dưới
- Khởi động một đối tượng
54 - Tạo tham chiếu đến
90 từ đối tượng
54 - Tạo một đối tượng
55 - Tạo
93 với đối tượng
55 và một đại diện
95 cho JavaScript mà bạn định dùng để ghi lại - Gọi phương thức
96 không đồng bộ bằng các đối tượng
93 cũng như các đối tượng
4 vàadb device_config put fledge_js_isolate_enforce_max_heap_size false
5 có liên quanadb device_config put fledge_js_isolate_enforce_max_heap_size false
Kotlin
5
Java
6
Vui lòng xem mục Chạy lựa chọn quảng cáo để biết thêm thông tin chi tiết về từng trường trong đại diện của
55. Điểm khác biệt chính là DecisionLogicUrl có thể được đặt thành giá trị của phần giữ chỗ vì hệ thống sẽ bỏ qua giá trị nàyTo write over JavaScript used in too trình lựa chọn quảng cáo,
01 phải chứa các chữ ký hàm của bên bán thích hợp. Để xem ví dụ về cách đọc tệp JavaScript dưới dạng chuỗi, vui lòng xem ứng dụng mẫu FLEDGE trên kho lưu trữ GitHubPhương thức
96 không đồng bộ sử dụng các đối tượng adb device_config put fledge_js_isolate_enforce_max_heap_size false
5 để thông báo hiệu quả của lệnh gọi APILệnh gọi lại
92 để biết tác vụ ghi đè đã được áp dụng thành công. Các lệnh gọi trong tương lai đến
53 sẽ sử dụng bất kỳ quyết định nào và thông báo logic về bất kỳ báo cáo nào mà bạn đã truyền để làm thông tin ghi đèLệnh gọi lại
93 có thể xảy ra biểu thị hai điều kiện- Nếu bạn cố gắng ghi đè các đối số không hợp lệ, thì
07 sẽ chỉ ra nguyên nhân là
96 - Nếu bạn cố gắng ghi đè một ứng dụng không chạy ở chế độ gỡ lỗi khi đã bật các tùy chọn tùy chọn cho nhà phát triển, thì
07 sẽ biết nguyên nhân là
98
Set up over the option override
Phần này giả định bạn đã ghi đè JavaScript bên bán, đồng thời bạn có tham chiếu đến
90 và
55 được sử dụng trong phần trướcTo set override information information for all the objects
13- Please call method
14 does not ĐỒNG BỘ BẰNG ĐỐI TƯỢNG
5 có liên quanadb device_config put fledge_js_isolate_enforce_max_heap_size false
Kotlin
7
Java
8
Sau khi bạn đặt lại cơ chế ghi bên bán, mọi lệnh gọi trong tương lai đến
53 sẽ sử dụng bất kỳ quyết địnhLogicUrl nào được lưu trữ trong
55 để cố gắng tìm tải JavaScript cần thiếtNếu lệnh gọi đến
14 không thành công, lệnh gọi lại
19 sẽ cung cấp một
07. Nếu bạn cố gắng xóa nội dung ghi đè khi ứng dụng không chạy ở chế độ khử lỗi có tùy chọn tùy chọn dành cho nhà phát triển, thì
07 sẽ biết nguyên nhân là
98Ghi đè JavaScript bên mua
- Làm theo các bước để tham gia vào một đối tượng tùy chỉnh
- Tạo
23 với người mua và tên của các đối tượng tùy chỉnh mà bạn muốn ghi đè, ngoài logic đặt giá thầu và dữ liệu mà bạn muốn sử dụng cơ chế ghi đè - Gọi phương thức
24 không đồng bộ bằng các đối tượng
23 cũng như các đối tượng
4 vàadb device_config put fledge_js_isolate_enforce_max_heap_size false
5 có liên quanadb device_config put fledge_js_isolate_enforce_max_heap_size false
Kotlin
9
Java
0
Giá trị biểu thị người mua và tên là các giá trị giống nhau, được sử dụng để tạo các đối tượng tùy chỉnh. Tìm hiểu thêm về các trường này
Ngoài ra, bạn có thể chỉ định hai tham số bổ sung
28. JavaScript chứa logic của người mua sẽ được sử dụng trong quá trình lựa chọn quảng cáo. Xem các ký tự chức năng bắt buộc trong JavaScript này
29. Các tín hiệu đặt giá thầu sẽ được sử dụng trong quá trình lựa chọn lựa chọn quảng cáo. Đối với mục đích thử nghiệm, đây có thể là một chuỗi trống
Phương thức
24 không đồng bộ sử dụng các đối tượng adb device_config put fledge_js_isolate_enforce_max_heap_size false
5 để biết kết quả của lệnh gọi APILệnh gọi lại
92 để biết tác vụ ghi đè đã được áp dụng thành công. Các lệnh gọi trong tương lai tới
53 sẽ sử dụng báo cáo logic bất kỳ và đặt giá thầu bất kỳ mà bạn đã truyền vào để ghi đè thông tinLệnh gọi lại
93 có thể xảy ra biểu thị hai điều kiện- Nếu bạn cố gắng ghi đè các đối số không hợp lệ, thì
07 sẽ chỉ ra nguyên nhân là
96 - Nếu bạn cố gắng ghi đè một ứng dụng không chạy ở chế độ gỡ lỗi khi đã bật các tùy chọn tùy chọn cho nhà phát triển, thì
07 sẽ biết nguyên nhân là
98
Đặt lại chế độ ghi đè bên mua
Phần này giả định bạn đã ghi đè JavaScript bên mua, đồng thời bạn có tham chiếu đến
39 được sử dụng trong phần trướcCách đặt lại chế độ ghi đè cho tất cả các đối tượng tùy chỉnh
- Please call the method
40 không đồng bộ với các đối tượng
4 vàadb device_config put fledge_js_isolate_enforce_max_heap_size false
5 có liên quanadb device_config put fledge_js_isolate_enforce_max_heap_size false
Kotlin
1
Java
1
Sau khi bạn đặt lại cơ chế ghi bên ngoài, mọi lệnh gọi trong tương lai tới
53 sẽ sử dụng bất kỳ
44 và
45 nào được lưu trữ trong
9 để tìm cách tải JavaScript cần thiếtNếu lệnh gọi đến
47 không thành công, lệnh gọi lại
19 sẽ cung cấp một
07. Nếu bạn cố gắng xóa nội dung ghi đè khi ứng dụng không chạy ở chế độ khử lỗi có tùy chọn tùy chọn dành cho nhà phát triển, thì
07 sẽ biết nguyên nhân là
98Thiết lập máy chủ báo cáo
Khi sử dụng tính năng ghi đè tìm nạp từ xa, bạn vẫn cần thiết lập một máy chủ mà thiết bị hoặc trình mô phỏng của bạn có thể truy cập để phản hồi các sự kiện báo cáo. Một điểm cuối đơn giản có thể trả về 200 mã phản hồi là đủ để thử nghiệm. Kho lưu trữ GitHub bao gồm các định nghĩa dịch vụ OpenAPI có thể được phát triển khai thác cho một nền mô phỏng hoặc microservices được hỗ trợ. Để biết thêm thông tin chi tiết, vui lòng tham khảo tài liệu README của dự án
Khi tìm thấy định nghĩa OpenAPI, hãy tìm tệp báo cáo-máy chủ. json. Tệp này chứa một điểm cuối đơn giản có thể trả về 200 mã, đại diện cho mã phản hồi HTTP. Điểm cuối này được sử dụng trong
53 và báo hiệu cho FLEDGE về công việc báo cáo hiển thị đã hoàn tất thành côngHam to try
- Thực hiện việc tham gia/rời khỏi và thiết lập các đối tượng tùy chỉnh tùy chỉnh dựa trên các thao tác trước đó của người dùng
- Thực hiện công việc bắt đầu lựa chọn quảng cáo trên thiết bị thông qua JavaScript được lưu trữ từ xa
- Quan sát cách ứng dụng liên kết với tùy chọn cài đặt đối tượng tùy chỉnh có thể ảnh hưởng đến kết quả lựa chọn quảng cáo
- Thực hiện báo cáo công việc hiển thị sau khi lựa chọn quảng cáo
Các điểm hạn chế
Sau đây bảng liệt kê các giới hạn đối với công việc xử lý FLEDGE. Các giới hạn trình bày có thể thay đổi dựa trên phản hồi. Để biết các tính năng đang được phát triển, hãy đọc phần phát hành
Thành phầnMô tả giới hạnGiá trị giới hạn Đối tượng tùy chỉnh [CA]Số lượng quảng cáo quảng cáo tối đa cho mỗi CA100Số CA tối đa trong mỗi ứng dụng1000Số lượng ứng dụng tối đa có thể tạo CA1000Độ tối đa tại thời điểm kích hoạt CA trongBáo cáo lỗi và vấn đề
Phản hồi của bạn có vai trò quan trọng trong Hộp cát về quyền riêng tư trên Android. Hãy cho chúng tôi biết mọi vấn đề của bạn hoặc ý tưởng để cải thiện Hộp cát về quyền riêng tư trên Android