Bidding with In-House Mediation

Tích hợp giải pháp đặt giá thầu giữa các máy chủ

Nền tảng trung gian nội bộ không được cung cấp công khai

Giải pháp đặt giá thầu nội bộ với Audience Network hiện đang ở giai đoạn Beta kín và chưa được cung cấp công khai. Chúng tôi sẽ cung cấp thêm thông tin cập nhật khi có thay đổi.

Thay vào đó, bạn có thể truy cập phương thức Đặt giá thầu trên Audience Network thông qua một trong các nền tảng trung gian mà chúng tôi hợp tác.

Facebook Audience Network có công cụ đặt giá thầu Đặt giá thầu công khai trong thời gian thực (ORTB) hỗ trợ cả quá trình tích hợp máy khách trực tiếp lẫn quá trình tích hợp giữa các máy chủ. Hướng dẫn này mô tả cách tích hợp giải pháp đặt giá thầu từ một máy chủ đấu giá.

Trong quá trình tích hợp giữa các máy chủ, máy chủ đấu giá sẽ gọi điểm cuối đặt giá thầu trên Facebook Audience Network và mọi nguồn nhu cầu khác để nhận phản hồi về giá thầu. Sau đó, máy chủ đấu giá sẽ tiến hành đấu giá và chọn ra giá thầu giành chiến thắng. Máy chủ đấu giá này có thể là máy chủ nội bộ chạy logic đấu giá mà bạn xây dựng hoặc có thể là máy chủ bên thứ ba được tích hợp với giải pháp đặt giá thầu cho ứng dụng của Audience Network. Nhờ vậy, bạn có thể sử dụng các thông tin và nguồn lực của máy chủ cũng như mạng có sẵn để gọi điểm cuối đặt giá thầu của các nguồn nhu cầu. Ngoài ra, bạn cũng có thể thay đổi các quá trình tích hợp điểm cuối này mà không cần cập nhật máy khách.

Điều kiện tiên quyết

Trước khi bạn bắt đầu, hãy đọc phần Tổng quan về giải pháp đặt giá thầu trên Audience Network và Cách tốt nhất để tích hợp giải pháp đặt giá thầu.

Android

iOS

Chuẩn bị

Bạn cần phải thực hiện các bước sau đây để chuẩn bị cho giải pháp đặt giá thầu giữa các máy chủ nội bộ:

Đăng ký doanh nghiệp của bạn

Mỗi nhà phát hành cần tạo một ID doanh nghiệp trên Audience Network. Chúng tôi sẽ thêm ID này vào danh sách cho phép đặt giá thầu. Trong ID doanh nghiệp này, bạn có thể tạo nhiều thuộc tính sử dụng điểm cuối đặt giá thầu.

  • Truy cập tài liệu về Facebook Audience Network rồi nhấp vào nút Bắt đầu ngay để tạo ID doanh nghiệp mới hoặc sử dụng ID doanh nghiệp hiện có của bạn.
  • Bạn có thể tạo các thuộc tính trong cùng một ID doanh nghiệp nhưng sẽ phải đăng ký các thuộc tính đó. Hãy xem Trình quản lý kiếm tiền để biết thêm thông tin chi tiết.
  • Hãy cho chúng tôi biết ID doanh nghiệp (đây là ID nhà phát hành của bạn).
  • Bạn có thể quản lý quyền truy cập của người dùng vào doanh nghiệp/ứng dụng của bạn.

Tạo ứng dụng bảo mật trên Facebook

Mọi nhà phát hành nội bộ phía máy chủ đều phải tạo ứng dụng bảo mật trên Facebook tại https://developers.facebook.com. Sau khi tạo ứng dụng, bạn sẽ phải lấy ID ứng dụng và Khóa bí mật của ứng dụng cho ứng dụng bảo mật đó. Khóa bí mật của ứng dụng sẽ được dùng trong mọi yêu cầu tạo mã xác thực để xác thực người tạo yêu cầu.

Đảm bảo bạn đang sử dụng đúng Hash (được chỉ định bên dưới). Nếu bắt đầu bằng số 0, hash sẽ không bị mất.

Cách tạo ứng dụng bảo mật và liên kết với doanh nghiệp của bạn:

  1. Đăng nhập vào https://developers.facebook.com.
  2. Trong menu Ứng dụng của tôi, nhấp vào Tạo ứng dụng.
  3. Chọn Doanh nghiệp rồi nhấp vào Tiếp.
  4. Đặt tên cho ứng dụng với tiền tố "AN_SECURITY_APP" rồi nhấp vào Tạo ID ứng dụng.
  5. Trong menu bên trái, chọn Cài đặt → Cơ bản.
  6. Trong trường Khóa bí mật của ứng dụng, nhấp vào Hiển thị. Ghi lại ID ứng dụng và Khóa bí mật của ứng dụng.
  7. Truy cập vào https://business.facebook.com rồi chọn doanh nghiệp của bạn.
  8. Trong menu bên trái, nhấp vào Cài đặt cho doanh nghiệp.
  9. Trong menu bên trái của trang Cài đặt cho doanh nghiệp, chọn Tài khoản → Ứng dụng.
  10. Trong ngăn Ứng dụng, nhấp vào Thêm → Thêm ứng dụng.
  11. Nhập ID ứng dụng cho ứng dụng bảo mật của bạn rồi nhấp vào Thêm ứng dụng. Lúc này, AN_SECURITY_APP sẽ xuất hiện bên dưới doanh nghiệp của bạn.

authentication_id theo từng yêu cầu sẽ được tạo bằng thuật toán HMAC-SHA256. Thuật toán này sẽ sử dụng các dữ liệu đầu vào sau đây:

  • ID yêu cầu ở dạng thông báo
  • Khóa bí mật của ứng dụng ở dạng khóa
      authentication_id = HMAC_SHA256(request_id, app_secret)

Sau đó, ID đã tạo sẽ được thêm vào tiện ích yêu cầu giá thầu OpenRTB ở cấp cao nhất trong trường authentication_id. Ví dụ: nếu ID yêu cầu là "9r90wurjqw" và khóa bí mật của ứng dụng là "12345asdfg" thì authentication_id được tạo sẽ có dạng như sau:

      authentication_id = HMAC_SHA256(9r90wurjqw, 12345asdfg) = 39bbe40bc68899a9356085ca8c81

Mã này sẽ được đưa vào mọi yêu cầu cùng với ID ứng dụng của ứng dụng bảo mật.

      {
      "id": "9r90wurjqw",
      ...
      "ext": {
      "authentication_id": "39bbe40bc68899a9356085ca8c81d3021cfa124f2a2b3c68c88f95fb4cde40a4",
      "security_app_id": "AN_SECURITY_APP_MY_SECURITY_APP_ID" 
      ...
      }
      }

Chuyển mã danh tính của bạn cho công cụ đặt giá thầu

Để sử dụng công cụ đặt giá thầu của chúng tôi, bạn cần cung cấp mã danh tính trong trường user.buyeruid của yêu cầu ORTB. Tùy vào nền tảng mà mã này được tạo theo những cách khác nhau.

Android

Trên luồng trong nền, hãy gọi com.facebook.ads.BidderTokenProvider.getBidderToken() từ Android Audience Network SDK. Bạn phải yêu cầu mã cho mọi yêu cầu giá thầu. Ngoài ra, hãy chuyển IDFA trong trường device.ifa vào AdvertisingIdClient.getAdvertisingIdInfo(context).getId().

iOS

Gọi [FBAdSettings bidderToken] từ iOS Audience Network SDK. Bạn phải yêu cầu mã cho mọi yêu cầu giá thầu. Ngoài ra, hãy chuyển IDFA trong trường device.ifa kèm theo [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString].

Bước tiếp theo