보장 프로그래매틱 거래에서는 고정 가격으로 구매할 노출수를 판매자와 협상합니다. 보장 프로그래매틱 거래의 제안서를 수락하면 협상된 조건에 따라 판매자의 인벤토리를 구매하게 됩니다. 규정 준수를 모니터링하기 위한 약정과 도구에 대해 자세히 알아보려면 보장 프로그래매틱 SLA 프레임워크를 설명하는 고객센터 문서를 참조하세요.
만들기
보장 프로그래매틱 거래는 협상이 제안 요청서 (RFP)로 시작될 때 생성됩니다. buyers.proposals.sendRfp
로 판매자에게 RFP를 전송하여 협상을 시작할 수 있습니다.
결과 제안서가 보장 프로그래매틱 거래에 적합하려면 RFP에 programmaticGuaranteedTerms
가 포함되어야 합니다. 판매자는 Marketplace API에서 제안서로 표시되는 RFP를 보낼 수도 있습니다. 생성된 후에는 buyers.proposals.list
를 사용하는 거래의 제안서를 찾을 수 있으며, 나와 판매자 간의 협상이 시작될 수 있습니다.
협상
보장 프로그래매틱 거래의 제안서가 생성되면 양측이 모두 만족하거나 제안서가 취소될 때까지 제안서와 해당 거래를 조정하여 판매자와 협상할 수 있습니다. 협상에 성공하면 다음 중 하나를 수행할 수 있습니다.
- 제안서 또는 거래 변경사항 폴링: 제안서 또는 해당 거래가 변경될 때마다
proposalRevision
이 증가합니다. 이를 사용하면 판매자가 제안서를 수락했거나 카운터 오퍼로 응답한 시점을 감지할 수 있습니다. - 제안서
또는 거래
패치:
제안서를 수정하거나 판매자에게 반대 오퍼를 전송합니다. 이렇게 하면
proposalRevision
가 증가합니다. - 판매자와 커뮤니케이션: 제안서에는 구매자와 판매자에게 표시되는 메모가 포함됩니다. 예를 들어 메모를 추가하여 제안서 또는 거래의 변경사항에 대한 컨텍스트를 제공할 수 있습니다.
게재 완료 및 준비
제안서에 만족하고 state
이 BUYER_ACCEPTANCE_REQUESTED
이면 제안서를 수락할 수 있습니다.
이렇게 하면 거래가 확정되고, flightStartTime
에서 게재를 시작합니다.
광고 소재가 준비되었을 때만 거래가 게재되도록 하려면 기술 계정 관리자에게 문의하여 이 기본 동작을 보장 프로그래매틱 거래를 선택 해제하고, 게재할 준비가 되었을 때 수동으로 신호를 보내는 것이 좋습니다. 보장 프로그래매틱 거래의 게재 준비가 되면 수동으로 신호를 보내는 워크플로의 예는 다음과 같습니다.
- 판매자와 제안서 협상
- 실시간 입찰 API를 사용하여 광고 소재를 제출하여 검토: 게재하려는 광고 소재는 검토 및 승인을 받아야 거래에서 사용할 수 있습니다.
- 제안서 수락: 제안서가 수락되면 수락된 거래가 확정된 거래에 반영됩니다.
- 실시간 입찰 API를 사용하여 이전에 제출한 광고 소재를 가져오고, 광고 소재가 실시간 입찰에서 거래 입찰에 사용하도록 승인되었는지 확인:
dealsPolicyCompliance
를 확인하여 광고 소재가 승인되었는지, 들어오는 거래 입찰 요청에 대한 응답으로 게재될 수 있는지 확인합니다. - 확정된 거래에 사용될 모든 광고 소재 추가: 거래 게재를 시작하기 전에 광고 소재를 사용하려는 거래에 추가하는 것이 좋습니다.
- 거래를 게재할 준비가 되었다고 수동으로 신호: 거래가 게재될 준비가 되면 구성된
flightStartTime
에서 거래의 입찰 요청을 받기 시작하며,flightEndTime
또는impressionCap
에 도달할 때까지 계속됩니다.
재협상
거래가 완료된 후 구매자 또는 판매자는 제안서 또는 거래를 수정하여 재협상을 시작할 수 있습니다. 재협상 중에 finalizedDeals
리소스는 이전 계약을 반영하며 가능한 경우 이를 기반으로 계속 게재합니다. 대신 deals
리소스는
재협상의 현재 상태를 반영하며, 초기 협상과 유사하게 진행됩니다.
게시자와 판매자가 모두 재협상된 거래를 수락하면 처음 체결된 거래를 덮어쓰고 새 계약에 따라 게재됩니다. 취소된 경우 재협상이 시작되기 전의 거래 상태로 돌아갑니다.
보장 프로그래매틱 거래의 노출에 입찰하기
보장 프로그래매틱 거래의 게재가 시작되면 실시간 입찰 통합이 해당 거래의 입찰 요청을 수신하고 거래 조건(예: 일정 기간 동안 설정된 노출수에 대한 특정 가격)에 따라 입찰해야 합니다.
특정 입찰 요청에 둘 이상의 PG 거래가 포함될 수 있습니다. 이 경우 요청에서 제출된 각 거래 ID에 대해 응답해야 합니다. 보장 프로그래매틱 거래와 직접 관련된 필드는 다음과 같습니다.
Google 프로토콜 | OpenRTB 프로토콜 | 설명 |
---|---|---|
BidRequest.adslot.matching_ad_data.direct_deal.direct_deal_id
|
BidRequest.imp.pmp.deals.id
|
거래의 고유 식별자입니다. 이 값은 Marketplace API에서 반환한 거래의 리소스 ID와 같습니다. |
BidRequest.adslot.matching_ad_data.direct_deal.deal_type
|
BidRequest.imp.pmp.deals.ext.deal_type
|
PROGRAMMATIC_GUARANTEED 또는 OpenRTB JSON의 경우 '3'으로 설정되는 입찰 유형입니다.
|
BidRequest.adslot.matching_ad_data.direct_deal.fixed_cpm_micros
|
BidRequest.imp.pmp.deals.bidfloor
|
구매자와 판매자가 동의한 거래의 CPM과 동일하며 Marketplace API에서 fixedPrice 로 표시됩니다. 보장 프로그래매틱 거래의 경우 이 값은 입찰 응답에 지정된 모든 값을 재정의합니다.
|
BidRequest.adslot.matching_ad_data.direct_deal.publisher_blocks_overridden
|
BidRequest.imp.pmp.deals.ext.publisher_blocks_overridden
|
보장 프로그래매틱 거래의 경우 항상 true 입니다. 즉, 제외된 카테고리가 허용됩니다.
|
BidRequest.adslot.matching_ad_data.direct_deal.must_bid
|
BidRequest.imp.pmp.deals.ext.must_bid
|
구매자가 거래에 입찰해야 하는지 여부를 나타냅니다. 예를 들어 거래가 일정보다 빠른 경우 False로 설정되고 입찰이 선택사항입니다. 그렇지 않으면 입찰이 필요합니다. 즉, 입찰에 실패하면 거래 게재 및 인벤토리 가용성에 부정적인 영향을 미칠 수 있습니다. |
게재 일시중지 및 재개
일시적으로 입찰할 수 없는 경우 buyers.finalizedDeals.pause
메서드를 사용하여 확정된 보장 프로그래매틱 거래를 일시중지해야 합니다. 예를 들어 광고 소재가 처음에 승인되었지만 비승인되어 다시 제출해야 하는 경우 이렇게 할 수 있습니다. 이렇게 하면 거래에 대한 입찰 요청을 받을 수 없지만 거래 조건으로 협상된 의무는 모두 충족해야 합니다.
확정된 거래의 게재를 재개하려면 buyers.finalizedDeals.resume
를 사용하면 됩니다.