Định cấu hình tích hợp tính năng Đặt giá thầu mở

Đặt giá thầu mở cho phép các sàn giao dịch và những người mua khác tận dụng cơ sở hạ tầng đặt giá thầu theo thời gian thực của Google để đặt giá thầu cho khoảng không quảng cáo trên Google Ad Manager và AdMob.

Để tham gia Đặt giá thầu mở, hãy định cấu hình một chế độ tích hợp đặt giá thầu theo thời gian thực được tuỳ chỉnh cho trường hợp sử dụng Đặt giá thầu mở của bạn, đồng thời gửi điểm cuối của bên đặt giá thầu đến người quản lý tài khoản của bạn tại Google để kiểm tra nhằm xác minh là chế độ tích hợp hoạt động chính xác. Đây là quy trình chỉ cần thực hiện một lần.

Giới hạn việc tích hợp của bạn cho một số nhà xuất bản

Chế độ tích hợp Đặt giá thầu mở có thể vẫn ở "chế độ riêng tư" cho đến khi bạn sẵn sàng chấp nhận yêu cầu từ bất kỳ nhà xuất bản nào. Trong chế độ riêng tư, bạn có thể làm việc với nhóm tài khoản của mình để kết nối với một số nhà xuất bản và duy trì trạng thái này cho đến khi bạn sẵn sàng mở rộng quy mô. Sau khi bạn thoát chế độ riêng tư, tất cả nhà xuất bản sẽ thấy tài khoản của bạn.

Các giao thức và phương thức mã hoá được hỗ trợ

Bạn có thể sử dụng OpenRTB ở định dạng JSON hoặc Protobuf. Tìm hiểu thêm.

Triển khai OpenRTB của Google

Việc triển khai OpenRTB của Google không hỗ trợ tất cả các tính năng có trong quy cách OpenRTB và bổ sung các tiện ích cho chức năng dành riêng cho Authorized Buyers và Đặt giá thầu mở. Để tìm hiểu thêm, hãy xem Hướng dẫn về OpenRTB.

Xử lý các yêu cầu giá thầu đang chuyển đến

Tính năng Đặt giá thầu mở sử dụng cùng cấu trúc BidRequest như Người mua được uỷ quyền, nhưng một số trường chỉ được gửi cho những người tham gia Đặt giá thầu mở. Hãy xem Hướng dẫn về yêu cầu để tìm hiểu thêm về các trường dành riêng cho tính năng Đặt giá thầu mở được gửi trong yêu cầu giá thầu.

Phản hồi bằng giá thầu

Tính năng Đặt giá thầu mở cũng sử dụng cấu trúc BidResponse tương tự như cấu trúc của Authorized Buyers, với một số trường dành riêng được gửi cho những người tham gia Đặt giá thầu mở. Hãy xem Hướng dẫn phản hồi để tìm hiểu thêm về các trường dành riêng cho tính năng Đặt giá thầu mở mà bạn có thể phản hồi.

Lưu ý: Các yêu cầu giá thầu được gửi đến những người tham gia Đặt giá thầu mở phải nhận được phản hồi trong vòng 300 đến 1000 mili giây, tuỳ thuộc vào định dạng khoảng không quảng cáo. Để xác định yêu cầu cụ thể cho một yêu cầu nhất định, hãy kiểm tra trường BidRequest.tmax.

Tuỳ thuộc vào định dạng quảng cáo ưu tiên mà bạn dự định đặt giá thầu, cấu trúc phản hồi có thể khác nhau đáng kể. Hãy xem các hướng dẫn sau để giúp bạn định cấu hình ứng dụng đặt giá thầu nhằm phản hồi bằng giá thầu cho các định dạng quảng cáo phổ biến:

• Quảng cáo xen kẽ
• Quảng cáo dạng video
• Quảng cáo dạng video OpenRTB
• Quảng cáo gốc
• Quảng cáo gốc dạng video
• Quảng cáo Buyer SDK

Theo dõi số lượt hiển thị để giảm sự chênh lệch

Bạn nên sử dụng trường BidResponse.seatbid.bid.ext.impression_tracking_url không bắt buộc để truy xuất dữ liệu ở cấp lượt hiển thị về thời điểm Google ghi lại các sự kiện có tính phí mà bạn sẽ bị tính phí.

Giải quyết chênh lệch nhu cầu của Google (Thử nghiệm)

Tính năng này nhằm đảm bảo rằng số lượt hiển thị mà một sàn giao dịch tính phí phù hợp với số lượt hiển thị mà Google Display & Video 360 (DV360) thanh toán.

Bằng cách xác định chính xác những lượt hiển thị trên DV360 được phân phát thông qua tính năng Đặt giá thầu mở, Google có thể điều chỉnh cho phù hợp với sự khác biệt về quảng cáo rác và sự kiện có tính phí để đảm bảo bạn không bị tính phí cho những lượt hiển thị mà bạn không được thanh toán.

Truyền google_query_id trong yêu cầu giá thầu

Để đảm bảo số lượt hiển thị hợp lệ khớp với nhu cầu của Google, google_query_id phải được truyền nguyên trạng từ các yêu cầu Đặt giá thầu mở đến các nền tảng nhu cầu của Google. Đây là điều kiện tiên quyết để giải quyết chênh lệch trong tính năng Đặt giá thầu mở. Độ dài dự kiến hiện tại của google_query_id là khoảng 64 byte.

Truyền third_party_buyer_token trong phản hồi giá thầu

Trong trường hợp nền tảng nhu cầu của Google thắng phiên đấu giá nội bộ của một sàn giao dịch, trường third_party_buyer_token phải được truyền nguyên trạng trong phản hồi giá thầu thông qua lượt hiển thị Đặt giá thầu mở. Điều này cho phép các nền tảng nhà xuất bản của Google xác định rằng giá thầu chiến thắng của một đối tác Đặt giá thầu mở là giá thầu thay mặt cho nhu cầu của Google đối với cùng một cơ hội hiển thị. Độ dài tối đa hiện tại của trường này dự kiến là 150 byte.

Truyền nguyên trạng mã đánh dấu mẫu quảng cáo của Google trong các phản hồi giá thầu

Để đảm bảo rằng quy trình giải quyết chênh lệch áp dụng cho giá thầu từ nhu cầu của Google, một sàn giao dịch phải truyền dấu đánh dấu mẫu quảng cáo của Google mà không có bất kỳ trình bao bọc nào (thẻ tập lệnh, iframe hoặc trình bao bọc VAST). Do giải pháp chênh lệch, Google có thể vô hiệu hoá và không lập hoá đơn cho những lượt hiển thị trong Phiên đấu giá mở mà các nền tảng có nhu cầu của Google không tính. Google sẽ định kỳ kiểm tra mã đánh dấu mẫu quảng cáo để xác nhận rằng giá thầu có third_party_buyer_token được gửi thay cho nhu cầu của Google chứ không phải bất kỳ người mua nào khác.

Mẫu quảng cáo HTML5

Bạn phải gửi mã đánh dấu HTML của Google nguyên trạng, với các macro mở rộng dành riêng cho sàn giao dịch thường áp dụng và (không bắt buộc) các pixel hoặc tập lệnh theo dõi bổ sung mà sàn giao dịch thường thêm.

Google không thể áp dụng giải pháp chênh lệch nếu một sàn giao dịch bao bọc mẫu quảng cáo HTML của Google vào một thẻ (script, iframe hoặc các kỹ thuật khác) mà sau đó tải hoặc hiển thị mã HTML của Google.

Đáp ứng các yêu cầu kỹ thuật

Trong ví dụ này, mã HTML mẫu quảng cáo của Google (DV360) từ phản hồi giá thầu được truyền nguyên văn, được thêm vào đầu và cuối bằng mã HTML dành riêng cho sàn giao dịch.

<!-- START exchange-specific HTML header -->
<iframe src="https://exchange.example.com/impression?…" width="0" height="0" frameborder="0" scrolling="no" style="display:none;" marginheight="0" marginwidth="0"></iframe>
<!-- END exchange-specific HTML header -->
<!-- START HTML code as returned by Google in the bid response -->
<DIV STYLE="position: absolute; left: 0px; top: 0px; visibility: hidden;"><IMG SRC="https://pagead2.googlesyndication.com/pagead/gen_204?id=xbid&dbm_b=…" BORDER=0 WIDTH=1 HEIGHT=1 ALT="" STYLE="display:none"></DIV><iframe title="Blank" src="https://googleads.g.doubleclick.net/xbbe/pixel?d=…" style="display:none" aria-hidden="true"></iframe><div><div style="position:relative; display:inline-block;"><div class="GoogleActiveViewClass" id="DfaVisibilityIdentifier_…"><script>var url = 'https://googleads.g.doubleclick.net/dbm/ad?…';document.write('<script src="' + (window.rfl ? window.rfl(url) : url) + '"></s' + 'cript>');</script>…
<!-- END HTML code as returned by Google in the bid response -->
<!-- START exchange-specific HTML footer -->
<img src='https://exchange.example.com/track?…' width='0' height='0' style='display:none;'>
<!-- END exchange-specific HTML footer -->

Không đáp ứng các yêu cầu kỹ thuật

Trong ví dụ này, mã HTML mẫu quảng cáo do Google trả về sẽ bị làm rối mã trong phản hồi giá thầu do một sàn giao dịch cung cấp và không xuất hiện nguyên văn trong phản hồi giá thầu. Mã HTML do Google cung cấp có thể được một trình bao bọc do sàn giao dịch cung cấp kết xuất trong trình duyệt.

<!-- START exchange ad tag that encodes / renders Google creative in the browser -->
<!-- Google creatives markup from the bid response (adm) is not present verbatim -->
<span class="ad"><script type='text/javascript' src='https://exchange.example.com/ad?p=%%WINNING_PRICE%%&m=n_ybbRoVpsLlXSo8gVHRn-W0tynBt-Hoe8t8m0qwKhLFiaF-0gB0U4w-5pjeB8IMIkg7PcRri5iCIjBMMKDqg
…'></script></span>
<!-- END exchange ad tag that encodes / renders Google creative in the browser -->

Mẫu quảng cáo video VAST

Để đủ điều kiện giải quyết sự chênh lệch, một sàn giao dịch phải sử dụng một trong các phương pháp sau để điền VASTTagURI trong các phản hồi XML VAST:

1. Một sàn giao dịch có thể giữ nguyên giá trị của phần tử VASTTagURI trong tài liệu VAST XML do Google trả về trong trường BidResponse.seatbid.bid.adm nguyên trạng, với các hoạt động mở rộng macro dành riêng cho sàn giao dịch thường được áp dụng.
2. DV360 có thể điền sẵn trường BidResponse.seatbid.bid.adm.nurl bằng URL tài liệu VAST trong các phản hồi giá thầu cho một sàn giao dịch. Sau đó, một sàn giao dịch có thể truyền giá trị đó bằng thẻ VASTTagURI, với các macro dành riêng cho sàn giao dịch được mở rộng bình thường nếu cần.

Nếu cần, một sàn giao dịch có thể chỉ định các trình theo dõi sự kiện và lỗi VAST bổ sung trong tài liệu VAST XML.

Đáp ứng các yêu cầu kỹ thuật

Trong ví dụ này, URI VAST mẫu quảng cáo của Google (DV360) từ phản hồi giá thầu được truyền nguyên văn, trong đó một sàn giao dịch sẽ thêm trình theo dõi lỗi và sự kiện VAST cụ thể của sàn giao dịch đó.

<!-- START exchange VAST tag referencing Google creative -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="123456789"><Wrapper>

<!-- Google VAST URI from the bid response is present verbatim -->
<AdSystem>XBid</AdSystem><VASTAdTagURI><![CDATA[https://bid.g.doubleclick.net/dbm/vast?…]]></VASTAdTagURI>

<!-- START Exchange-specific event trackers -->

<Error><![CDATA[https://video.exchange.example.com/vast_error?error=[ERRORCODE]&…]]></Error><Impression><![CDATA[https://video.exchange.example.com/impression?price=%%WINNING_PRICE%%&…]]></Impression><Creatives><Creative id="1234567890" sequence="1"><Linear><TrackingEvents><Tracking event="creativeView"><![CDATA[https://video.exchange.example.com/track/view?…]]></Tracking><Tracking event="start"><![CDATA[https://video.exchange.example.com/track/start?…]]></Tracking><Tracking event="midpoint"><![CDATA[https://video.exchange.example.com/track/midpoint?…]]></Tracking></TrackingEvents><VideoClicks><ClickTracking><![CDATA[https://video.exchange.example.com/click?…]]></ClickTracking></VideoClicks>

<!-- END Exchange-specific event trackers -->

</Linear></Creative></Creatives></Wrapper></Ad></VAST>

<!-- END exchange VAST tag referencing Google creative -->

Không đáp ứng các yêu cầu kỹ thuật

Trong ví dụ này, mã VAST hoặc URI mẫu quảng cáo do Google trả về không xuất hiện nguyên văn trong phản hồi giá thầu, mà thay vào đó, một trình bao bọc VAST dành riêng cho sàn giao dịch được sử dụng. Trình bao bọc VAST do sàn giao dịch cung cấp có thể tải mã VAST do Google cung cấp (như được xác định trong phần tử VASTAdTagURI, https://video.exchange.example.com/creative?…) khi SDK tải một quảng cáo.

<!-- START exchange VAST tag that encodes or loads Google VAST creative subsequently -->
<!-- Google VAST URI or VAST document from the bid response is not present verbatim -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="1234567890"><Wrapper><AdSystem version="0.1">VideoExchange</AdSystem><VASTAdTagURI><![CDATA[https://video.exchange.example.com/creative?…]]></VASTAdTagURI><Error><![CDATA[https://video.exchange.example.com/error?ec=[ERRORCODE]]]></Error><Impression><![CDATA[https://video.exchange.example.com/imp?…]]></Impression><Creatives><Creative></Creative></Creatives></Wrapper></Ad></VAST>
<!-- END exchange VAST tag that encodes or loads Google VAST creative subsequently -->

Ưu đãi

Những đối tác trao đổi tham gia Đặt giá thầu mở có thể sử dụng Giao dịch ưu tiên (PD), Phiên đấu giá kín (PA) với Đặt giá thầu mở. Bạn phải chỉ định mã thoả thuận và loại thoả thuận như sau:

Trường	Mô tả
BidResponse.seatbid.bid.dealid	Mã thoả thuận trong không gian tên của đối tác trao đổi được liên kết với giá thầu và được báo cáo cho nhà xuất bản. Đây là văn bản UTF8 tuỳ ý và không được dài quá 64 byte.
BidResponse.seatbid.bid.ext.exchange_deal_type	Một enum chỉ định loại giao dịch. Điều này được báo cáo cho nhà xuất bản và ảnh hưởng đến cách xử lý giao dịch trong phiên đấu giá. Các giá trị có thể là: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

Sau đây là một phản hồi mẫu về giá thầu cho PD/PA.

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

So khớp cookie

Để điền sẵn bảng so khớp do Google lưu trữ, những người tham gia Đặt giá thầu mở có thể sử dụng bất kỳ lựa chọn nào dưới đây phù hợp nhất với nhu cầu của họ:

• So khớp cookie: Quy trình so khớp do người mua hoặc sàn giao dịch khởi tạo Tìm hiểu thêm.
• So khớp bằng pixel: So khớp do Google khởi tạo Tìm hiểu thêm.
• Cookie Match Assist: Quy trình so khớp do sàn giao dịch khởi tạo với các đơn vị đặt giá thầu Tìm hiểu thêm.

Lưu ý: Hiện tại, những người tham gia Đặt giá thầu mở không thể tạo, điền sẵn hoặc nhắm đến danh sách người dùng.

Quản lý độ trễ

Bạn nên sử dụng các vị trí giao dịch trong Hướng dẫn kết nối ngang hàng để ước tính độ trễ mà các điểm cuối của bên đặt giá thầu sẽ gặp phải khi phản hồi các yêu cầu đặt giá thầu đến.

Thông thường, khoảng không quảng cáo được gửi qua vị trí giao dịch gần nhất, nhưng điều này không được đảm bảo. Cách duy nhất để đảm bảo quyền truy cập vào tất cả các lượt hiển thị là có các điểm cuối của đơn vị đặt giá thầu ở tất cả các vị trí giao dịch.

Những sàn giao dịch lớn nhận được số lượng lớn yêu cầu đặt giá thầu nên cân nhắc việc tham gia vào một thoả thuận ngang hàng với Google để giảm độ trễ và sự biến động về độ trễ. Tìm hiểu thêm về hoạt động kết nối ngang hàng.

Macro nhấp chuột

Bạn nên triển khai macro lượt nhấp. Các chỉ số này sẽ cho phép báo cáo bao gồm lượt nhấp và các chỉ số bắt nguồn từ lượt nhấp cho tài khoản của bạn và cho những nhà xuất bản mà bạn hợp tác. Tìm hiểu thêm.

API

Khách hàng sử dụng tính năng Đặt giá thầu mở có thể sử dụng API REST của Authorized Buyers để truy cập vào dữ liệu có thể hữu ích cho mục đích khắc phục sự cố. Hiện tại, bạn chỉ có thể truy cập vào các tài nguyên API sau:

• Báo cáo hiệu suất phiên bản 1.4
• Khắc phục sự cố RTB phiên bản 2 beta 1

Bạn có thể liên hệ với Giám đốc Quản lý Khách hàng về Kỹ thuật để định cấu hình tài khoản của mình nhằm truy cập vào các API này và truy xuất mã tài khoản cần thiết để thực hiện các lệnh gọi API. Để được hỗ trợ kỹ thuật trong quá trình sử dụng các API này, bạn có thể liên hệ với bí danh hỗ trợ [e-mail].

Tài nguyên khác

• Các phương pháp hay nhất để quản lý các kết nối
• Sử dụng macro URL giá thầu
• Giải mã thông tin xác nhận giá nếu bạn sử dụng macro WINNING_PRICE
• Các phương pháp hay nhất và đề xuất về thử nghiệm

Yêu cầu và phản hồi mẫu về giá thầu

Bạn có thể tìm thấy các mẫu yêu cầu và phản hồi giá thầu cho tất cả các giao thức được hỗ trợ trong hướng dẫn về Yêu cầu và Phản hồi.