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

Tính năng Đặt giá thầu mở cho phép các sàn giao dịch và 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 trên khoảng không quảng cáo của Google Ad Manager và AdMob.

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

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

Quá trình tích hợp tính năng Đặ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 của bất kỳ nhà xuất bản nào. Khi ở chế độ riêng tư, bạn có thể làm việc với nhóm tài khoản để 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 khỏi 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

Cách triển khai OpenRTB của Google không hỗ trợ tất cả tính năng có trong quy cách OpenRTB, đồng thời thêm các tiện ích cho Authorized Buyers và chức năng dành riêng cho tính năng Đặ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 một cấu trúc BidRequest với Người mua được uỷ quyền, nhưng một số trường chỉ được gửi đến những người tham gia tính năng Đặ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ư Authorized Buyers, với một số trường dành riêng được gửi đến những người tham gia tính năng Đặt giá thầu mở. Hãy xem Hướng dẫn trả lờ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ể sử dụng để trả lời.

Lưu ý: Yêu cầu giá thầu được gửi đến những người tham gia tính năng Đặt giá thầu mở sẽ nhận được phản hồi trong vòng từ 300 đến 1.000 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 đây để giúp bạn định cấu hình ứng dụng bên đặ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ó thể lập hoá đơn mà bạn sẽ phải trả phí.

Giải pháp về sự chênh lệch về 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 hệ thống trao đổi được tính phí phải phù hợp với số lượt hiển thị mà Google Display & Video 360 (DV360) trả phí.

Bằng cách xác định chính xác số lượt hiển thị DV360 được phân phát bằng tính năng Đặt giá thầu mở, Google có thể điều chỉnh sự chênh lệch về sự kiện có thể lập hoá đơn và quảng cáo không phù hợp để đả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 nhau trên 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 sự chênh lệch trong tính năng Đặt giá thầu mở. Chiều 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 giành chiến thắng trong phiên đấu giá nội bộ của một nền tảng trao đổi, trường third_party_buyer_token phải được truyền nguyên trạng trong phản hồi giá thầu trở lại 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 cho 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 mã đánh dấu mẫu quảng cáo của Google nguyên trạng trong phản hồi giá thầu

Để đảm bảo rằng cách giải quyết sự khác biệt áp dụng cho giá thầu từ nhu cầu của Google, bạn phải có một hệ thống trao đổi để truyền tải mã đá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 việc giải quyết sự khác biệt, Google có thể vô hiệu hoá và không lập hoá đơn cho những lượt hiển thị Đặt giá thầu mở mà các nền tảng 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 mặt 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

Một hệ thống trao đổi bắt buộc phải gửi mã đánh dấu HTML của Google nguyên trạng, với các phần mở rộng macro dành riêng cho hệ thống trao đổi thường áp dụng và tuỳ ý thêm các pixel hoặc tập lệnh theo dõi bổ sung mà hệ thống trao đổi thường thêm vào.

Google không thể áp dụng giải pháp xử lý sự khác biệt nếu một nền tảng trao đổi gói quảng cáo HTML của Google vào một thẻ (script, iframe hoặc các kỹ thuật khác) 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à thêm vào bằng mã HTML dành riêng cho nền tảng trao đổi.

<!-- 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 của mẫu quảng cáo do Google trả về bị làm rối trong phản hồi giá thầu do một nền tảng trao đổi 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 trình bao bọc do nền tảng trao đổi cung cấp hiển thị 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 dạng video VAST

Để đủ điều kiện sử dụng tính năng giải quyết sự khác biệt, một nền tảng trao đổi 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 hệ thống trao đổi có thể giữ nguyên giá trị của phần tử VASTTagURI trong tài liệu XML VAST do Google trả về trong trường BidResponse.seatbid.bid.adm nguyên trạng, với các phần mở rộng macro dành riêng cho hệ thống trao đổi thường áp dụng.
2. DV360 có thể điền URL tài liệu VAST vào trường BidResponse.seatbid.bid.adm.nurl trong phản hồi giá thầu cho một nền tảng trao đổi. 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.

Một nền tảng trao đổi có thể chỉ định trình theo dõi lỗi và sự kiện VAST bổ sung trong tài liệu XML VAST nếu cần.

Đá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 hệ thống trao đổi sẽ thêm trình theo dõi lỗi và sự kiện VAST cụ thể.

<!-- 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 do Google trả về của mẫu quảng cáo không xuất hiện nguyên văn trong phản hồi giá thầu, thay vào đó, trình bao bọc VAST dành riêng cho sàn giao dịch sẽ được sử dụng. Mã VAST do Google cung cấp có thể được tải bằng trình bao bọc VAST do nền tảng trao đổi cung cấp (như được xác định trong phần tử VASTAdTagURI, https://video.exchange.example.com/creative?…) khi SDK tải 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

Các nền tảng trao đổi tham gia tính năng Đặ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ính năng Đặt giá thầu mở. Bạn phải chỉ định mã và loại giao dịch như sau:

Trường	Mô tả
BidResponse.seatbid.bid.dealid	Mã giao dịch từ không gian tên của nền tảng 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 vượt quá 64 byte.
BidResponse.seatbid.bid.ext.exchange_deal_type	Một enum chỉ định loại giao dịch. Thông tin 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ể có là: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

Sau đây là phản hồi giá thầu mẫ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 bảng so khớp do Google lưu trữ, người tham gia tính năng Đặ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: So khớp do người mua hoặc bên trao đổi khởi tạo Tìm hiểu thêm.
• So khớp Pixel: Tính năng so khớp do Google khởi tạo Tìm hiểu thêm.
• Hỗ trợ so khớp cookie: Tính năng so khớp do bên giao dịch khởi tạo với bên đặt giá thầu của họ Tìm hiểu thêm.

Lưu ý: Người tham gia tính năng Đặt giá thầu mở hiện không thể tạo, điền sẵn hoặc nhắm mục tiêu theo 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 có trong Hướng dẫn liên kết ngang để ước tính độ trễ mà các điểm cuối của bên đặt giá thầu sẽ có khi phản hồi các yêu cầu giá thầu đến.

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

Các sàn giao dịch lớn nhận được nhiều yêu cầu giá thầu nên cân nhắc việc ký thoả thuận liên kết ngang hàng với Google để giảm độ trễ và sự biến động về độ trễ. Tìm hiểu thêm về tính năng liên kết 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 số 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 các 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 2beta1

Bạn có thể liên hệ với Nhà quản lý tài khoản về kỹ thuật để định cấu hình tài khoản 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 lệnh gọi API. Để được hỗ trợ kỹ thuật về cách 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 báo xác nhận giá nếu bạn sử dụng macro WINNING_PRICE
• Các đề xuất và phương pháp hay nhất về kiểm thử

Mẫu yêu cầu và phản hồi giá thầu

Bạn có thể tìm thấy mẫu yêu cầu giá thầu và phản hồi 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.