Sản phẩm cartesian javascript
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 Show
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
Before when startedTrước khi bắt đầu, hãy hoàn thành các bước sau
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
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ị
Việc gọi 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ư 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
Các tham số không bắt buộc đối với đối tượng 9 có thể bao gồm
Dưới đây là ví dụ về lệnh tạo đối tượng 9
Xử lý kết quả joinCustomAudience()Phương thức 2 không đồng bộ sử dụng các đối tượng 5 để thông báo hiệu quả của lệnh gọi API
Sau đây là ví dụ về cách xử lý kết quả của 2
Bỏ tùy chỉnh đối tượngNế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
Tương tự như cuộc gọi 2, 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
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
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
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
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
Báo cáo số lượng hiển thị quảng cáoSau 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 04 bằng các tham số bắt buộc sau
Phương thức 05 không đồng bộ sử dụng các đối tượng 5 để báo hiệu kết quả của lệnh gọi API
Đ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
Điểm cuối trên nền tảng bên bán
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 ý
Cập nhật hằng ngày ở chế độ nềnKhi 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
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
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áoQuy 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
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
tạoBid() 8Tham số đầu vào
Kết quả
điểmAd() 0Tham số đầu vào
Kết quả
báo cáoKết quả() 2Tham số đầu vào
Kết quả
báo cáoWin() 3Tham số đầu vào
Kết quả
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ếtFLEDGE 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
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
Để 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 JavaScriptBạ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
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 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
Set up over the option overridePhầ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
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
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
Phương thức 24 không đồng bộ sử dụng các đối tượng 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
Đặt lại chế độ ghi đè bên muaPhầ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
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áoKhi 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
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 |