구조화된 데이터 파일 v9로 이전

최종 업데이트: 2025년 8월 21일

이 가이드에서는 다음 프로세스를 안내합니다.

  • Display & Video 360 UI 또는 API를 사용하여 선택한 구조화된 데이터 파일 버전을 v9로 업데이트합니다.
  • 지원 중단된 구조화된 데이터 파일 버전 (v7, v7.1, v8 또는 v8.1)에서 v9로 통합을 이전합니다. 현재 버전과 v9 간의 변경사항을 자세히 설명하는 페이지를 안내하여 통합에 영향을 미칠 수 있는 변경사항을 파악할 수 있습니다. 경우에 따라 2025년 9월 8일부터 v9를 사용하여 SDF를 업로드해야 합니다.

버전과 v9 간의 차이점 전체 목록은 각 버전에 맞는 이전 페이지를 참고하세요.

구조화된 데이터 파일 버전 업데이트

v9를 사용하려면 구조화된 데이터 파일을 다운로드하고 업로드할 때 v9를 사용하도록 리소스와 SDF 생성 작업을 업데이트해야 합니다.

구조화된 데이터 파일 버전 업데이트

새 구조화된 데이터 파일 버전을 사용하려면 상위 파트너 및 광고주 리소스에서 할당된 버전을 업데이트하고 Display & Video 360 API에서 개별 다운로드 작업을 만들 때 새 버전을 사용하세요.

상위 리소스 설정 업데이트

파트너 및 광고주 리소스 수준에서 기본 구조화된 데이터 파일 버전을 설정합니다. 이 버전은 인터페이스 또는 API를 통해 구조화된 데이터 파일을 다운로드할 때 기본값으로 사용됩니다.

인터페이스에 설정

파트너 수준:

  1. 원하는 파트너로 이동합니다.
  2. 왼쪽 탐색 메뉴의 파트너 설정 메뉴에서 기본 세부정보 페이지로 이동합니다.
  3. 구조화된 데이터 파일 섹션에서 SDF 버전 구성을 v9로 업데이트합니다.

광고주 수준:

  1. 원하는 광고주로 이동합니다.
  2. 왼쪽 탐색 메뉴의 광고주 설정 메뉴에서 기본 세부정보 페이지로 이동합니다.
  3. 구조화된 데이터 파일 섹션의 SDF 버전 구성을 v9로 업데이트합니다. 기본 버전이 파트너 수준에서 설정된 경우 이 설정을 수정할 수 없습니다.

API에서 설정

파트너 수준: API에서는 파트너 수준에서 기본 SDF 버전을 설정할 수 없습니다.

광고주 수준: advertisers.patch 요청을 보내 dataAccessConfig.sdfConfig.sdfConfig.versionSDF_VERSION_9로 업데이트하고 필요한 경우 dataAccessConfig.sdfConfig.overridePartnerSdfConfig을 True로 업데이트합니다.

API에서 sdfdownloadtasks.create 요청 업데이트

Display & Video 360 API를 사용하여 sdfdownloadtasks.create 요청을 할 때는 요청 본문의 version 필드를 SDF_VERSION_9로 설정합니다.

현재 SDF 버전에서 이전

다음 페이지에서는 현재 버전에서 v9로 이전할 때 통합에 적용해야 하는 필수 업데이트를 안내하고 버전 간의 모든 변경사항 목록을 제공합니다.