API 워크플로

거래 만들기

1. external_deal_id 필터를 사용하여 LIST 제품으로 제품이 이미 생성되었는지 확인합니다. External_deal_id는 모든 제품에서 고유해야 합니다.

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. 주문 만들기 이름은 DV3에서 생성되며, 나중에 검색할 수 있도록 시스템에 이 ID를 저장하는 것이 좋습니다.

3. 주문 아래에 제품 만들기 제품 이름은 DV3에서 생성되며, 나중에 검색할 수 있도록 시스템에 이 ID를 저장하는 것이 좋습니다.

   또는 항상 external_deal_id로 LIST를 실행할 수 있습니다. 이름 필드에는 주문 ID와 제품 ID가 모두 포함되어 있으므로 이 방법으로 상위를 쉽게 식별할 수 있습니다.

특가 취소

1. 주문 상태를 취소됨으로 업데이트 주문이 수락되지 않은 경우에만 취소를 지원합니다. 취소됨은 최종 상태입니다. 주문이 취소되면 다시 활성화할 수 없습니다.

할인 세부정보 가져오기

1. 주문의 세부정보를 가져옵니다. 사용자가 주문을 수락, 보관 또는 취소하면 상태가 업데이트됩니다.
2. 제품 세부정보 가져오기

특가 목록 가져오기

1. 상태 필터를 사용하여 LIST 주문을 통해 수락된 주문과 수락 대기 중인 주문을 모두 가져옵니다.
2. external_deal_id 필터를 사용하여 제품을 나열합니다.
3. 주문 내 모든 제품을 나열합니다.

거래 업데이트

1. 게시자 연락처 정보의 순서를 업데이트합니다.
   1. 이름은 업데이트를 허용하지 않습니다(field_mask에서 설정할 수 없음). 상태는 API를 통해서만 취소됨으로 설정할 수 있습니다.
   2. partner_id는 업데이트가 허용되지 않습니다.
2. 특정 거래 기간 업데이트에 대한 제품을 업데이트합니다.
   1. name, externalDealId, transactionType, pricingType, updateTime은 업데이트할 수 없습니다.
   2. displayName 업데이트에는 사용자 수락이 필요하지 않습니다.
   3. rateDetails, creativeConfig를 업데이트하면 상위 주문 상태가 수락 대기 중으로 변경됩니다. DV3 광고주는 이전 주문의 수락 여부와 관계없이 협상 페이지에서 새 약관에 동의하라는 메시지를 받게 됩니다.

사용자가 혜택을 수락했는지 확인

1. 해당 주문 ID를 알고 있는 경우 주문 가져오기 상태 필드를 확인합니다.
2. 주문 ID가 추적되지 않은 경우: external_deal_id 필터로 제품 나열, 제품 이름에서 주문 이름 파악, 주문 가져오기 상태 필드를 확인합니다.

사용자가 거래를 구성했는지 확인합니다(PG만 해당).

1. 인벤토리 소스를 가져옵니다. 이름은 'exchanges/{exchangeId}/inventorysources/{external_deal_id}'입니다. 구매자 상태를 확인하세요.
   1. 예약 특가
      1. BUYER_STATUS_ACTIVE는 거래가 수락되고 구성되었음을 의미합니다. DV3가 거래 약관과 일치하는 입찰 요청을 수신할 때 거래가 이 상태에서 지출될 것으로 예상됩니다. 거래 구성 단계에서 광고 항목이 자동으로 생성됩니다. 자세한 내용은 거래 구성을 참고하세요.
      2. BUYER_STATUS_PENDING는 주문이 수락되었지만 거래가 아직 구성되지 않았음을 의미합니다. 이 상태에서는 지출이 발생하지 않습니다.
      3. BUYER_STATUS_PAUSED는 광고주가 거래를 명시적으로 일시중지했음을 의미합니다. 이 상태에서는 지출이 발생하지 않습니다.
   2. 예약이 아닌 거래
      1. BUYER_STATUS_ACTIVE는 거래가 수락되었음을 의미합니다. DV3가 거래 약관과 일치하는 입찰 요청을 수신하고, 이 거래를 타겟팅하는 활성 광고 항목이 있으며, 입찰 요청이 광고 항목 타겟팅 기준과 일치하는 경우 거래가 이 상태에서 지출될 것으로 예상됩니다. 자세한 내용은 광고 항목을 참고하세요.** 광고 항목에서 거래를 타겟팅했는지 여부를 쿼리하는 판매자 API는 없습니다. **
      2. BUYER_STATUS_PENDING해당 사항 없음
      3. BUYER_STATUS_PAUSED는 광고주가 거래를 명시적으로 일시중지했음을 의미합니다. 이 상태에서는 지출이 발생하지 않습니다.

수락 후 거래 일시중지/일시중지 해제

1. 인벤토리 소스 판매자 상태를 업데이트합니다.
   1. 일시중지/일시중지 해제는 거래 게재에 영향을 미치지 않습니다. 판매자가 거래를 일시중지하면 광고주에게 참고용 문자열 메시지만 표시됩니다. 이를 통해 광고주는 지출이 없는 거래의 문제를 해결할 수 있습니다.

재협상 (수락 후 거래 업데이트)

재협상은 구매자가 수락한 후 거래에 적용된 업데이트를 의미합니다. 이는 거래소와 구매자 모두에게 승인된 거래에 새로운 변경사항을 푸시하는 데 매우 유용합니다. 예를 들어 거래소에서 수락된 거래의 거래 종료 시간이 올바르지 않다는 것을 알게 될 수 있습니다. 거래가 아직 시작되지 않은 경우 거래소는 DV3 업데이트 제품을 사용하여 DV3 구매자에게 업데이트를 푸시할 수 있습니다.

허용되는 변경사항과 허용되지 않는 변경사항

startTime, endTime, rateDetails, creativeConfig 등 일부 게재에 중요한 필드를 제외한 모든 필드를 변경할 수 있습니다. 이러한 게재에 중요한 필드에 대한 유효성 검사가 있습니다. 일반적으로 creativeConfig를 제외한 필드는 혜택의 시작 시간이 1일 이상 지난 경우 업데이트가 허용됩니다. 시작 시간은 과거이지만 종료 시간은 미래인 진행 중인 특가에는 증분 업데이트만 허용됩니다. 종료 시간이 지난 완료된 거래는 변경할 수 없습니다. 예를 들어 1년 전에 완료된 거래의 rateDetails를 업데이트하는 것은 허용되지 않습니다. 이러한 경우 DV3 업데이트 제품에서 유효성 검사 오류가 발생합니다.