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

최종 업데이트: 2023년 10월 18일

이 가이드에서는 이전 버전에서 구조화된 데이터 파일(SDF) v7로 이전하는 과정과 통합을 더 효과적으로 최적화하기 위해 필요한 변경사항과 제안된 변경사항을 설명합니다.

v6와 v7의 차이점에 대한 전체 목록은 출시 노트를 참고하세요.

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

이전 버전에서 구조화된 데이터 파일 v7로 이전하려면 새 버전을 지정하고, 기존 열의 하위 집합에 대한 ID 공간을 업데이트하고, 새 열과의 통합을 추가해야 합니다.

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

새로운 구조화된 데이터 파일 버전으로 업데이트하려면 상위 파트너 및 광고주 리소스에 할당하는 버전과 Display & Video 360 API의 개별 다운로드 작업을 업데이트해야 합니다.

상위 리소스 설정 업데이트

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

인터페이스에서 설정
파트너 수준
원하는 파트너로 이동합니다. 왼쪽 탐색 메뉴의 파트너 설정 메뉴에서 기본 세부정보 페이지로 이동합니다. 구조화된 데이터 파일 섹션의 SDF 버전 구성을 v7로 업데이트합니다.
광고주 수준
원하는 광고주로 이동합니다. 왼쪽 탐색 메뉴의 광고주 설정 메뉴에서 기본 세부정보 페이지로 이동합니다. 구조화된 데이터 파일 섹션의 SDF 버전 구성을 v7로 업데이트합니다. 기본 버전이 파트너 수준에서 설정된 경우 이 설정을 수정하지 못할 수 있습니다.
API에서 설정
광고주 수준
advertisers.patch 요청을 실행하여 dataAccessConfig.sdfConfig.sdfConfig.versionSDF_VERSION_7로 업데이트하고 필요한 경우 dataAccessConfig.sdfConfig.overridePartnerSdfConfigTrue로 업데이트합니다.

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

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

필수 열의 ID 업데이트

v7에서는 일부 열에서 사용하는 ID 공간이 지원 중단된 항목 읽기 파일 제품에서 구조화된 데이터 파일을 분리하고 Display & Video 360 API와 같은 지원되는 도구와 더욱 일치하도록 업데이트되었습니다.

이 섹션에는 v6와 다른 ID를 사용하는 모든 열과 새 값에 대한 참조 정보를 검색하는 방법이 나와 있습니다.

게재 신청서

v7 열에 대한 이전 안내

앱 타겟팅 - 제외

앱 타겟팅 - 포함

'App Platform:App ID' 형식에 따라 앱 식별자를 사용하도록 업데이트된 열입니다. 예: 'APP:com.google.android.gm', 'APP:422689480', 'ANDROID_TV_APP:com.google.android.youtube.tvunplugged'

앱 플랫폼은 문자열 값으로 식별됩니다. 앱 ID는 관련 플랫폼에서 제공하는 ID입니다(예: Android Play 스토어의 번들 ID 또는 Apple App Store의 앱 ID).

브라우저 타겟팅 - 제외

브라우저 타겟팅 - 포함

이 열은 타겟팅 유형 TARGETING_TYPE_BROWSER에서 Display & Video 360 API TargetingOption 리소스의 targetingOptionId 값을 사용하도록 업데이트되었습니다.

targetingTypes.targetingOptions 서비스를 사용하여 TargetingOption 리소스를 개별적으로 가져오거나 페이지로 나눈 목록으로 가져옵니다.

이동통신사 타겟팅 - 제외

이동통신사 타겟팅 - 포함

이 열은 타겟팅 유형 TARGETING_TYPE_CARRIER_AND_ISP에서 Display & Video 360 API TargetingOption 리소스의 targetingOptionId 값을 사용하도록 업데이트되었습니다.

targetingTypes.targetingOptions 서비스를 사용하여 TargetingOption 리소스를 개별적으로 가져오거나 페이지로 나눈 목록으로 가져옵니다.

채널 타겟팅 - 제외

채널 타겟팅 - 포함

이 열은 Display & Video 360 API Channel 리소스의 channelId 값을 사용하도록 업데이트되었습니다.

advertisers.channelspartners.channels 서비스를 사용하여 Channel 리소스를 개별적으로 검색하거나 페이지로 나눈 목록으로 가져옵니다.

기기 타겟팅 - 제외

기기 타겟팅 - 포함

이 열은 다음 타겟팅 유형에서 Display & Video 360 API TargetingOption 리소스의 targetingOptionId 값을 사용하도록 업데이트되었습니다.

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

targetingTypes.targetingOptions 서비스를 사용하여 TargetingOption 리소스를 개별적으로 가져오거나 페이지로 나눈 목록으로 가져옵니다.

DAR 채널 측정

이 열은 Display & Video 360 API Channel 리소스의 channelId 값을 사용하도록 업데이트되었습니다.

advertisers.channelspartners.channels 서비스를 사용하여 Channel 리소스를 개별적으로 검색하거나 페이지로 나눈 목록으로 가져옵니다.

사이트 타겟팅 - 제외

사이트 타겟팅 - 포함

이 열은 URL 문자열을 통해 사이트를 식별할 수 있도록 업데이트되었습니다.

광고 항목

v7 열에 대한 이전 안내

앱 타겟팅 - 제외

앱 타겟팅 - 포함

'App Platform:App ID' 형식에 따라 앱 식별자를 사용하도록 업데이트된 열입니다. 예: 'APP:com.google.android.gm', 'APP:422689480', 'ANDROID_TV_APP:com.google.android.youtube.tvunplugged'

앱 플랫폼은 문자열 값으로 식별됩니다. 앱 ID는 관련 플랫폼에서 제공하는 ID입니다(예: Android Play 스토어의 번들 ID 또는 Apple App Store의 앱 ID).

입찰 배율

이 열은 사이트 행 유형에 새 기준 ID를 사용하도록 업데이트되었습니다.

기준 ID에 앱 플랫폼 및 앱 플랫폼 ID의 연결된 문자열 값(콜론으로 구분)을 사용하도록 app 행 유형이 업데이트되었습니다. 앱 플랫폼은 문자열 값으로 식별됩니다. 앱 ID는 관련 플랫폼에서 제공하는 ID입니다(예: Android Play 스토어의 번들 ID 또는 Apple App Store의 앱 ID).

URL 문자열을 기준 ID로 사용하도록 사이트 행 유형이 업데이트되었습니다.

브라우저 타겟팅 - 제외

브라우저 타겟팅 - 포함

이 열은 타겟팅 유형 TARGETING_TYPE_BROWSER에서 Display & Video 360 API TargetingOption 리소스의 targetingOptionId 값을 사용하도록 업데이트되었습니다.

targetingTypes.targetingOptions 서비스를 사용하여 TargetingOption 리소스를 개별적으로 가져오거나 페이지로 나눈 목록으로 가져옵니다.

이동통신사 타겟팅 - 제외

이동통신사 타겟팅 - 포함

이 열은 타겟팅 유형 TARGETING_TYPE_CARRIER_AND_ISP에서 Display & Video 360 API TargetingOption 리소스의 targetingOptionId 값을 사용하도록 업데이트되었습니다.

targetingTypes.targetingOptions 서비스를 사용하여 TargetingOption 리소스를 개별적으로 가져오거나 페이지로 나눈 목록으로 가져옵니다.

채널 타겟팅 - 제외

채널 타겟팅 - 포함

이 열은 Display & Video 360 API Channel 리소스의 channelId 값을 사용하도록 업데이트되었습니다.

advertisers.channelspartners.channels 서비스를 사용하여 Channel 리소스를 개별적으로 검색하거나 페이지로 나눈 목록으로 가져옵니다.

기기 타겟팅 - 제외

기기 타겟팅 - 포함

이 열은 다음 타겟팅 유형에서 Display & Video 360 API TargetingOption 리소스의 targetingOptionId 값을 사용하도록 업데이트되었습니다.

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

targetingTypes.targetingOptions 서비스를 사용하여 TargetingOption 리소스를 개별적으로 가져오거나 페이지로 나눈 목록으로 가져옵니다.

사이트 타겟팅 - 제외

사이트 타겟팅 - 포함

이 열은 URL 문자열을 통해 사이트를 식별할 수 있도록 업데이트되었습니다.

미디어 제품

v7 열에 대한 이전 안내

채널 타겟팅 - 제외

채널 타겟팅 - 포함

이 열은 Display & Video 360 API Channel 리소스의 channelId 값을 사용하도록 업데이트되었습니다.

advertisers.channelspartners.channels 서비스를 사용하여 Channel 리소스를 개별적으로 검색하거나 페이지로 나눈 목록으로 가져옵니다.

기기 타겟팅 - 포함

이 열은 다음 타겟팅 유형에서 Display & Video 360 API TargetingOption 리소스의 targetingOptionId 값을 사용하도록 업데이트되었습니다.

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

targetingTypes.targetingOptions 서비스를 사용하여 TargetingOption 리소스를 개별적으로 가져오거나 페이지로 나눈 목록으로 가져옵니다.

v6 이후 추가된 열과의 통합 추가

v6에서 v7로 이전하는 경우 관련 파일에 다음 열을 추가해야 합니다.

파일 형식
광고 항목 TrueView 타겟 게재빈도 집계
광고 항목 TrueView 타겟 게재빈도 기간
YouTube 광고그룹 타겟팅 최적화

이전 구조화된 데이터 파일 버전에서 이전하는 경우 구조화된 데이터 파일 출시 노트에서 현재 버전과 SDF v6 사이에 추가된 열에 관한 정보를 확인하세요.

기타 변경사항

또한 v7에서는 통합을 간소화하고 지원 중단된 항목 읽기 파일을 참조용으로 사용하지 않도록 피상적인 변경사항을 적용했습니다.

열 하위 집합의 새로운 목록 정렬

SDF v7은 파일 생성 시 특정 목록 열의 안정적인 순서를 보장합니다. 이렇게 하면 더 일관된 동작이 이루어지고 더 쉽게 검토할 수 있습니다. 이 순서는 파일 업로드 시 적용되지 않지만 나중에 업데이트된 파일을 생성할 때 적용됩니다.

이제 오름차순 또는 알파벳순으로 생성되는 열의 전체 목록은 v7 출시 노트를 참고하세요.

새 ID 참조 추천

지원 중단된 항목 읽기 파일에 대한 참조를 삭제하고 대신 다른 ID 조회 방법을 권장하기 위해 여러 열의 정의를 업데이트했습니다.

다음 열에서 반환되는 값은 SDF v6와 다르지 않지만 v7 열 설명에서 확인할 수 있는 새로운 권장 방법을 사용하여 ID를 가져오도록 통합을 업데이트하는 것이 좋습니다.

파일 형식 및 해당 열
Campaign
지역 타겟팅 - 제외
지역 타겟팅 - 포함
인벤토리 소스 타겟팅 - 제외
인벤토리 소스 타겟팅 - 포함
언어 타겟팅 - 제외
언어 타겟팅 - 포함
게재 신청서
관심분야 및 구매 의도 타겟팅 - 제외
관심분야 및 구매 의도 타겟팅 - 포함
앱 컬렉션 타겟팅 - 제외
앱 컬렉션 타겟팅 - 포함
잠재고객 타겟팅 - 제외
잠재고객 타겟팅 - 포함
카테고리 타겟팅 - 제외
카테고리 타겟팅 - 포함
콘텐츠 장르 타겟팅 - 제외
콘텐츠 장르 타겟팅 - 포함
맞춤 목록 타겟팅
지역 타겟팅 - 제외
지역 타겟팅 - 포함
인벤토리 소스 타겟팅 - 제외
인벤토리 소스 타겟팅 - 포함
키워드 목록 타겟팅 - 제외
언어 타겟팅 - 제외
언어 타겟팅 - 포함
광고 항목
관심분야 및 구매 의도 타겟팅 - 제외
관심분야 및 구매 의도 타겟팅 - 포함
앱 컬렉션 타겟팅 - 제외
앱 컬렉션 타겟팅 - 포함
잠재고객 타겟팅 - 제외
잠재고객 타겟팅 - 포함
카테고리 타겟팅 - 제외
카테고리 타겟팅 - 포함
통합 잠재고객 타겟팅
콘텐츠 장르 타겟팅 - 제외
콘텐츠 장르 타겟팅 - 포함
전환 플러드라이트 활동 ID
광고 소재 할당
맞춤 목록 타겟팅
지역 타겟팅 - 제외
지역 타겟팅 - 포함
인벤토리 소스 타겟팅 - 제외
인벤토리 소스 타겟팅 - 포함
키워드 목록 타겟팅 - 제외
언어 타겟팅 - 제외
언어 타겟팅 - 포함
미디어 제품
잠재고객 타겟팅 - 제외
잠재고객 타겟팅 - 포함
카테고리 타겟팅 - 제외
카테고리 타겟팅 - 포함
지역 타겟팅 - 포함
언어 타겟팅 - 제외
언어 타겟팅 - 포함
YouTube 광고 그룹
관심분야 및 구매 의도 타겟팅 - 제외
관심분야 및 구매 의도 타겟팅 - 포함
잠재고객 타겟팅 - 제외
잠재고객 타겟팅 - 포함
카테고리 타겟팅 - 제외
카테고리 타겟팅 - 포함
맞춤 목록 타겟팅