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

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

  1. Quản lý đối tượng tùy chỉnh
  2. Thiết lập và chạy lựa chọn quảng cáo trên thiết bị
  3. 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

  1. 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
  2. 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
  3. 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 \"*\"
    
  4. chuyển quyền

      
        
      
    
    3 vào tệp kê khai ứng dụng

      
    
  5. Tham khảo cấu hình dịch vụ quảng cáo trong phần tử

      
        
      
    
    4 của tệp kê khai

      
    
  6. Chỉ đị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áo

      
        
      
    
  7. Theo 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ập

    • Selected 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

  1. Khởi động đối tượng
      
        
      
    
    8
  2. 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
    adb device_config put fledge_js_isolate_enforce_max_heap_size false
    
    0 bằng đối tượng
      
        
      
    
    9
  3. Gọi
    adb device_config put fledge_js_isolate_enforce_max_heap_size false
    
    2 không đồng bộ với các đối tượng
    adb device_config put fledge_js_isolate_enforce_max_heap_size false
    
    0 cũng như các đối tượng
    adb 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 quan

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ị

  • adb device_config put fledge_js_isolate_enforce_max_heap_size false
    
    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ọi
  • adb 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ày
  • adb 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ỉnh

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
Lưu ý. Giá trị của các mục "Tín hiệu đặt giá trị của người dùng", "Dữ liệu đặt giá trị đáng tin cậy" và "Thuộc tính quảng cáo" không vượt quá 10 KB. 3 trường này phải được điền để một đối tượng tùy chỉnh tham gia vào việc lựa chọn quảng cáo

Dưới đây là ví dụ về lệnh tạo đối tượng

  
    
  
9

Kotlin

  
    
  
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
      adb device_config put fledge_js_isolate_enforce_max_heap_size false
      
      0 được khởi tạo bằng các đối số không hợp lệ, thì
        
          
        
      
      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

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
2

Kotlin

  
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

  1. Khởi tạo đối tượng
      
        
      
    
    8
  2. Khởi tạo
      
        
      
    
    43 bằng
    adb device_config put fledge_js_isolate_enforce_max_heap_size false
    
    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"
  3. 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.
    adb 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 quan

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ông

Chạ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

  1. Khởi động một đối tượng
      
        
      
    
    54
  2. Tạo một đối tượng
      
        
      
    
    55
  3. 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.
    adb 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 quan

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

  1. Khởi động một đối tượng
      
        
      
    
    54
  2. Tạo đối tượng
      
    
    04 bằng mã lựa chọn quảng cáo
  3. 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.
    adb 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 quan

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

Đ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ất

Lư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

  
7

JavaScript 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()

  
8

Tham 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

      
    
    9

    không có I

    •   
          
        
      
      83 và
      adb device_config put fledge_js_isolate_enforce_max_heap_size false
      
      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áo
    •   
      
      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()

  
0

Tham 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ả()

  
2

Tham 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()

  
3

Tham 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

  1. Điểm cuối của người mua phân phát JavaScript logic đặt giá trị
  2. Một điểm cuối phân phối tín hiệu đặt giá trị
  3. Điểm cuối của người bán phân phối logic JavaScript được quyết định
  4. Một điểm cuối cùng của tín hiệu phân phối điểm
  5. Điểm cuối báo cáo hiển thị của người mua được cấp quyền mua
  6. Điểm cuối báo cáo hiển thị của người bán
  7. 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

  1. Khởi động một đối tượng
      
        
      
    
    54
  2. Tạo tham chiếu đến
      
    
    90 từ đối tượng
      
        
      
    
    54
  3. Tạo một đối tượng
      
        
      
    
    55
  4. 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
  5. 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
    adb 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 quan

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ày

To 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ữ GitHub

Phươ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 API

Lệ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ước

To set override information information for all the objects

  
13

  1. Please call method
      
    
    14 does not ĐỒNG BỘ BẰNG ĐỐI TƯỢNG
    adb device_config put fledge_js_isolate_enforce_max_heap_size false
    
    5 có liên quan

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ết

Nế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à
  
    
  
98

Ghi đè JavaScript bên mua

  1. Làm theo các bước để tham gia vào một đối tượng tùy chỉnh
  2. 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 đè
  3. 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
    adb 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 quan

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 API

Lệ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 tin

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

Đặ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ước

Cách đặt lại chế độ ghi đè cho tất cả các đối tượng tùy chỉnh

  1. Please call the method
      
    
    40 không đồng bộ với các đối tượng
    adb 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 quan

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ết

Nế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à
  
    
  
98

Thiế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ông

Ham 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 trong

Bá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