API 워크플로

이 가이드에서는 Deal Sync API를 사용하여 거래를 생성, 취소, 검색, 업데이트, 협상하는 일반적인 API 워크플로를 설명합니다.

거래 만들기

  1. externalDealId 필터로 나열 제품을 호출하여 제품이 이미 생성되었는지 확인합니다. 필터 문자열에서 camelCase externalDealId와 snake_case external_deal_id가 모두 지원됩니다. external_deal_id는 모든 제품에서 고유해야 합니다.

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

  2. 주문 만들기. 주문 이름은 DV360에서 생성되며, 향후 검색을 위해 이 ID를 시스템에 저장하는 것이 좋습니다.

  3. 주문 에서 제품을 만듭니다. 제품 이름은 DV360에서 생성되며, 향후 검색을 위해 이 ID를 시스템에 저장하는 것이 좋습니다.

또는 external_deal_id로 나열을 호출할 수 있습니다. 리소스 이름에는 주문 ID와 제품 ID가 모두 포함되어 있으므로 상위 주문을 식별할 수 있습니다.

거래 취소

  1. 주문 상태를 CANCELED로 업데이트합니다. 취소는 주문이 아직 수락되지 않은 경우에만 지원됩니다. 취소됨은 최종 상태입니다. 주문은 취소된 후 다시 활성화할 수 없습니다. 주문에 제품이 포함되어 있는 경우 external_deal_id를 재사용할 수 없습니다.

거래 세부정보 가져오기

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

거래 목록 가져오기

  1. 상태 필터로 주문을 나열하여 수락된 주문 또는 수락 대기 중인 주문을 모두 가져옵니다.
  2. LIST external_deal_id필터로 제품을 나열합니다.
  3. 주문 내의 모든 제품을 나열합니다.

거래 업데이트

  1. 게시자 연락처 정보에 대한 주문을 업데이트합니다.
    1. name 은 업데이트할 수 없으며 (updateMask에서 설정할 수 없음) API를 사용하여 상태를 CANCELED로만 설정할 수 있습니다.
    2. partner_id는 업데이트할 수 없습니다.
  2. 특정 거래 기간 업데이트를 위해 제품을 업데이트합니다.
    1. name, externalDealId, transactionType, pricingType, updateTime 업데이트할 수 없습니다.
    2. displayName을 업데이트하는 데 사용자 재수락이 필요하지 않습니다.
    3. rateDetails 또는 creativeConfig를 업데이트하면 상위 주문 상태가 PENDING_ACCEPTANCE로 변경됩니다. 이전 주문이 이미 수락되었는지 여부와 관계없이 DV360 광고주에게 협상 페이지에서 새 약관을 수락하라는 메시지가 표시됩니다.

사용자가 거래를 수락했는지 확인

  1. 해당 주문 이름을 알고 있는 경우 주문 을 가져옵니다. status 필드를 확인합니다.
  2. 주문 이름이 추적되지 않은 경우: external_deal_id 필터로 제품을 나열하고 제품 이름에서 주문 이름을 식별한 후 주문 가져오기를 호출합니다. status 필드를 확인합니다.

사용자가 거래를 구성했는지 확인 (보장 프로그래매틱만 해당)

  1. 인벤토리 소스를 가져옵니다. 리소스 이름은 exchanges/{exchangeId}/inventorysources/{external_deal_id}입니다. 구매자 상태를 확인합니다.
    1. 예약 거래:
      1. BUYER_STATUS_ACTIVE: 거래가 수락되고 구성되었습니다. DV360에서 거래 기간과 일치하는 입찰 요청을 수신하면 거래가 지출을 시작합니다. 거래 구성 중에 광고 항목이 자동으로 생성됩니다. 자세한 내용은 거래 구성 을 참고하세요.
      2. BUYER_STATUS_PENDING: 주문이 수락되었지만 거래가 아직 구성되지 않았습니다. 이 상태에서는 지출이 발생하지 않습니다.
      3. BUYER_STATUS_PAUSED: 거래가 광고주에 의해 일시중지되었습니다. 이 상태에서는 지출이 발생하지 않습니다.
    2. 비예약 거래:
      1. BUYER_STATUS_ACTIVE: 거래가 수락되었습니다. DV360에서 일치하는 입찰 요청을 수신하고, 활성 광고 항목이 거래를 타겟팅하며, 입찰 요청이 광고 항목 타겟팅 기준과 일치하면 거래가 지출을 시작합니다. 자세한 내용은 Line Items를 참고하세요. (참고: 거래가 광고 항목에 의해 타겟팅되는지 쿼리하는 판매자 API는 없습니다).
      2. BUYER_STATUS_PENDING: 비예약 거래에는 적용되지 않습니다.
      3. BUYER_STATUS_PAUSED: 거래가 광고주에 의해 명시적으로 일시중지되었습니다. 이 상태에서는 지출이 발생하지 않습니다.

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

  1. 인벤토리 소스 판매자 상태를업데이트합니다.
    1. 일시중지 또는 일시중지 해제해도 거래 게재가 중지되지 않습니다. 판매자가 거래를 일시중지하면 DV360 UI에 광고주에게 지출되지 않는 거래의 문제를 해결하는 데 도움이 되는 정보 메시지가 표시됩니다.

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

재협상은 구매자가 수락한 후 거래에 적용되는 업데이트를 의미합니다. 이를 통해 익스체인지와 구매자는 기존 거래의 약관을 조정할 수 있습니다. 예를 들어 익스체인지에서 수락된 거래의 게재 종료 시간이 잘못된 것을 발견할 수 있습니다. 익스체인지는 제품 패치 를 사용하여 거래가 게재되기 전에 DV360 구매자에게 업데이트를 푸시할 수 있습니다.

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

거래 협상 및 재협상 규칙에 대한 자세한 내용은 Display &Video 360 고객센터 도움말을 참고하세요.

이전
항목 구조
다음
베타 프로세스