Đị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à người mua khác tận dụng tính nă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 Google Ad Manager và AdMob.

Để tham gia tính năng Đặt giá thầu mở, hãy thiết lập một chế độ đặ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 và gửi người đặt giá thầu điểm cuối đến người quản lý tài khoản của Google để kiểm tra nhằm xác minh rằng hoạt động tích hợp chính xác. Quy trình này chỉ cần thực hiện một lần.

Giới hạn việc tích hợp để chọn nhà xuất bản

Bạn có thể vẫn tích hợp tính năng Đặt giá thầu mở ở "chế độ riêng tư" cho đến khi bạn sẵn sàng chấp nhận yêu cầu của mọi nhà xuất bản. Khi ở chế độ riêng tư, bạn có thể làm việc với nhóm quản lý tài khoản của bạn để kết nối với một số nhà xuất bản và vẫn có thể trạng thái này cho đến khi bạn sẵn sàng mở rộng quy mô. Sau khi thoát khỏi chế độ riêng tư, tài khoản sẽ được hiển thị cho tất cả các nhà xuất bản.

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

Bạn nên sử dụng phương thức triển khai OpenRTB của Google. Giao thức RTB của Google không được dùng nữa. Tìm hiểu thêm.

Triển khai OpenRTB của Google

Phương thức triển khai OpenRTB của Google không hỗ trợ tất cả các tính năng có trong Đặc tả OpenRTB và thêm phần mở rộng cho Authorized Buyers và Open Chức năng dành riêng cho chiến lược đặt giá thầu. Để tìm hiểu thêm về OpenRTB của Google và mối quan hệ giữa việc này với Authorized Buyers độc quyền Giao thức Đặt giá thầu theo thời gian thực, hãy xem Hướng dẫn 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ấu trúc BidRequest giống như được uỷ quyền Tuy nhiên, một số trường chỉ dành riêng cho người mua tham gia Đặt giá thầu mở. 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.

Trả lời với một 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 độc quyền được gửi đến tính năng Đặt giá thầu mở người tham gia. 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ể phản hồi.

Lưu ý: Các yêu cầu giá thầu được gửi đến người tham gia tính năng Đặt giá thầu mở sẽ 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ể đối với một yêu cầu cụ thể, hãy kiểm tra trường BidRequest.tmax.

Phản hồi, tuỳ thuộc vào định dạng quảng cáo ưu tiên mà bạn định đặt giá thầu cấu trúc có thể khác nhau đáng kể. Hãy xem các hướng dẫn sau để biết bạn có thể định cấu hình ứng dụng bên đặt giá thầu để phản hồi 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 SDK của bên mua

Theo dõi số lần hiển thị để giảm sự khác biệt

Bạn nên sử dụng impression_tracking_url (không bắt buộc) để truy xuất dữ liệu ở cấp lượt hiển thị khi Google ghi lại dữ liệu có thể lập hoá đơn các sự kiện mà bạn sẽ bị tính phí. Đối với OpenRTB, thông tin này được nêu dưới dạng BidResponse.seatbid[].bid[].ext.impression_tracking_url, và dưới vai trò là BidResponse.ad[].impression_tracking_url trong Google giao thức.

Giải pháp về sự chênh lệch về nhu cầu của Google (Phiên bản thử nghiệm beta)

Tính năng này nhằm đảm bảo rằng số lần hiển thị mà Exchange được lập hoá đơn phù hợp với số lần hiển thị được thanh toán bởi Mạng Hiển thị của Google và Video 360 (DV360).

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

Áp dụng google_query_id trong yêu cầu giá thầu

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

Áp dụng third_party_buyer_token trong giá thầu phản hồi

Trong trường hợp nền tảng nhu cầu của Google giành được giải pháp trong phiên đấu giá, trường third_party_buyer_token phải được truyền theo nguyên trạng trong giá thầu phản hồ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 của nhà xuất bản của Google để xác định rằng giá thầu giành chiến thắng trong phiên đấu giá mở Đối tác đặt giá thầu là bên đặt giá thầu thay mặt cho nhu cầu của Google cho cùng một lượt hiển thị cơ hội. Độ dài tối đa hiện tại của trường này dự kiến là 150 byte.

Chuyển mã đánh dấu mẫu quảng cáo của Google giống như trong phản hồi giá thầu

Để đảm bảo rằng giải pháp chênh lệch áp dụng cho các giá thầu từ Nhu cầu của Google, trao đổi là bắt buộc để tuyên truyền đánh dấu quảng cáo của Google 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 khác biệt, Google có thể vô hiệu hoá và không lập hoá đơn cho những Số lượt hiển thị đặt giá thầu không được các nền tảng nhu cầu của Google tính. Điều khoản sẽ kiểm tra định kỳ mã đánh dấu mẫu quảng cáo để xác nhận rằng giá thầu third_party_buyer_token đã được gửi thay mặt cho nhu cầu của Google và chứ không phải bất kỳ người mua nào khác.

Mẫu quảng cáo HTML5

Đối tác trao đổi phải gửi mã đánh dấu HTML của Google theo nguyên trạng, kèm theo thường áp dụng cho các đối tượng trao đổi quảng cáo cụ thể và (không bắt buộc) các pixel theo dõi bổ sung hoặc các tập lệnh mà một sàn giao dịch thường thêm.

Google không thể áp dụng giải pháp khác biệt nếu một sàn giao dịch gói Google Quảng cáo HTML vào một thẻ (script, iframe hoặc vị trí khác) kỹ thuật) để tải hoặc hiển thị mã HTML của Google.

Đáp ứng 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ừ mục giá thầu phản hồi được truyền nguyên văn, được thêm vào trước và nối với 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 của mẫu quảng cáo do Google trả về bị làm rối mã nguồn trong giá thầu phản hồi do đối tác trao đổi cung cấp và không xuất hiện nguyên văn trong giá thầu phản hồi. Mã HTML do Google cung cấp có thể được hiển thị bằng trình bao bọc do Exchange cung cấp 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 giải quyết khoản chênh lệch, sàn giao dịch phải sử dụng một trong các phương pháp sau để điền VASTTagURI vào Phản hồi XML của VAST:

1. Hoạt động trao đổi có thể giữ nguyên giá trị của phần tử VASTTagURI dưới dạng một phần của tài liệu XML VAST do Google trả về trong trường adm theo nguyên trạng, với việc mở rộng macro theo sàn giao dịch cụ thể thường áp dụng.
2. DV360 có thể điền URL của tài liệu VAST vào trường nurl trong giá thầu phản hồi cho một sàn giao dịch. Sau đó, một sàn giao dịch có thể chuyển giá trị của nurl mà Google (DV360) phản hồi trong VASTTagURI với các macro trao đổi cụ thể được mở rộng bình thường khi cần.

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

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

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

Trường	Mô tả
Giao thức OpenRTB: BidResponse.seatbid[].bid[].dealid Giao thức của Google: BidResponse.ad[].adslot[].exchange_deal_id	Mã giao dịch từ không gian tên của sàn giao dịch đượ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.
Giao thức OpenRTB: BidResponse.seatbid[].bid[].ext.exchange_deal_type Giao thức của Google: BidResponse.ad[].adslot[].exchange_deal_type	Một giá trị 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 thoả thuận được xử lý trong phiên đấu giá. Các giá trị có thể sử dụng là: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

Dưới đây là phản hồi giá thầu OpenRTB mẫu cho PD/PA.

Mẫu bên dưới sử dụng các trường OpenRTB cho PD/PA (dealid, exchange_deal_type); nếu sử dụng giao thức Authorized Buyers, các trường phản hồi giá thầu cho PD/PA sẽ là exchange_deal_id và exchange_deal_type.

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 dữ liệu được lưu trữ trên Google bảng so khớp, 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 bên dưới phù hợp nhất với mình cần:

• So khớp cookie: So khớp do người mua hoặc sàn giao dịch thực hiện Tìm hiểu thêm.
• So khớp pixel: So khớp do Google khởi tạo Tìm hiểu thêm.
• Hỗ trợ so khớp cookie: So khớp do trao đổi thực hiện với bên đặt giá thầu Tìm hiểu thêm.

Lưu ý: Người tham gia tính năng Đặ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 tại thời điểm này.

Quản lý độ trễ

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

Khoảng không quảng cáo thường được gửi qua địa điểm giao dịch, 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 cho 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ả các vị trí giao dịch.

Bạn nên xem xét các sàn giao dịch lớn nhận được số lượng lớn yêu cầu giá thầu tham gia một thoả thuận kết nối ngang hàng với Google để giảm độ trễ và độ trễ biến động. Tìm hiểu thêm về kết nối ngang hàng.

Macro nhấp chuột

Bạn nên triển khai macro nhấp chuột. Những chế độ cài đặt này sẽ cho phép báo cáo bao gồm số lượt nhấp và chỉ số bắt nguồn từ lượt nhấp cho tài khoản của bạn cũng như cho nhà xuất bản 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 dữ liệu có thể hữu ích cho mục đích khắc phục sự cố. Chỉ hiện 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 hỗ trợ kỹ thuật để định cấu hình tài khoản của mình để truy cập các API này cũng như để truy xuất mã tài khoản cần thiết để tạo API cuộc gọi. Để được hỗ trợ kỹ thuật khi 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ý việ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 ticket_PRICE
• Các đề xuất và phương pháp hay nhất về thử nghiệm

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

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