최종 업데이트: 2023년 10월 18일
이 가이드에서는 이전 버전에서 구조화된 데이터 파일(SDF) v7로 이전하는 과정과 통합을 더 효과적으로 최적화하기 위해 필요한 변경사항과 제안된 변경사항을 설명합니다.
v6과 v7의 차이점 전체 목록은 출시 노트를 참고하세요.
구조화된 데이터 파일 버전 이전
이전 버전에서 구조화된 데이터 파일 v7로 이전하려면 새 버전을 지정하고, 기존 열 하위 집합의 ID 공간을 업데이트하고, 새 열과의 통합을 추가해야 합니다.
구조화된 데이터 파일 버전 업데이트
새로운 구조화된 데이터 파일 버전으로 업데이트하려면 상위 파트너 및 광고주 리소스에 할당하는 버전과 Display & Video 360 API에서 개별 다운로드 작업을 업데이트해야 합니다.
상위 리소스 설정 업데이트
구조화된 데이터 파일의 기본 버전은 파트너 및 광고주 리소스 수준에서 설정됩니다. 이 버전은 인터페이스 또는 API를 통해 구조화된 데이터 파일을 다운로드할 때 기본값으로 사용됩니다.
인터페이스에서 설정
- 파트너 수준
- 원하는 파트너로 이동합니다. 왼쪽 탐색 메뉴의 파트너 설정 메뉴에서 기본 세부정보 페이지로 이동합니다. 구조화된 데이터 파일 섹션의 SDF 버전 구성을 v7로 업데이트합니다.
- 광고주 수준
- 원하는 광고주로 이동합니다. 왼쪽 탐색 메뉴의 광고주 설정 메뉴에서 기본 세부정보 페이지로 이동합니다. 구조화된 데이터 파일 섹션의 SDF 버전 구성을 v7로 업데이트합니다. 기본 버전이 파트너 수준에서 설정된 경우 이 설정을 수정하지 못할 수 있습니다.
API에서 설정
- 광고주 수준
advertisers.patch요청을 실행하여dataAccessConfig.sdfConfig.sdfConfig.version를SDF_VERSION_7로 업데이트하고 필요한 경우dataAccessConfig.sdfConfig.overridePartnerSdfConfig를True로 업데이트합니다.
API에서 sdfdownloadtasks.create 요청 업데이트
Display & Video 360 API를 사용하여 sdfdownloadtasks.create 요청을 실행할 때 요청 본문의 version 필드를 SDF_VERSION_7로 설정합니다.
필수 열의 ID 업데이트
v7에서는 일부 열에서 사용되는 ID 공간이 지원 중단된 항목 읽기 파일 제품에서 구조화된 데이터 파일을 분리하고 Display & Video 360 API와 같이 지원되는 도구와 더욱 일치하도록 업데이트되었습니다.
이 섹션에는 v6과 다른 ID를 사용하는 모든 열과 새 값의 참조 정보를 검색하는 방법에 대한 안내가 나와 있습니다.
게재 신청서
| v7 열 이전 안내 | |
|---|---|
|
앱 타겟팅 - 제외 앱 타겟팅 - 포함 |
이 열은 ' 앱 플랫폼은 문자열 값으로 식별됩니다. 앱 ID는 관련 플랫폼에서 제공하는 ID입니다(예: Android Play 스토어의 번들 ID 또는 Apple App Store의 앱 ID). |
|
브라우저 타겟팅 - 제외 브라우저 타겟팅 - 포함 |
이 열은 타겟팅 유형
|
|
이동통신사 타겟팅 - 제외 이동통신사 타겟팅 - 포함 |
이 열은 타겟팅 유형
|
|
채널 타겟팅 - 제외 채널 타겟팅 - 포함 |
이 열은 Display & Video 360 API
|
|
기기 타겟팅 - 제외 기기 타겟팅 - 포함 |
이 열은 다음 타겟팅 유형에서 Display & Video 360 API
|
| DAR 채널 측정 |
이 열은 Display & Video 360 API
|
사이트 타겟팅 - 제외 사이트 타겟팅 - 포함 |
이 열은 URL 문자열을 통해 사이트를 식별할 수 있도록 업데이트되었습니다. |
광고 항목
| v7 열 이전 안내 | |
|---|---|
|
앱 타겟팅 - 제외 앱 타겟팅 - 포함 |
이 열은 ' 앱 플랫폼은 문자열 값으로 식별됩니다. 앱 ID는 관련 플랫폼에서 제공하는 ID입니다(예: Android Play 스토어의 번들 ID 또는 Apple App Store의 앱 ID). |
| 입찰 배율 |
이 열은 앱 및 사이트 행 유형에 새로운 기준 ID를 사용하도록 업데이트되었습니다. app 행 유형이 기준 ID에 앱 플랫폼 및 앱 플랫폼 ID의 연결된 문자열 값(콜론으로 구분)을 사용하도록 업데이트되었습니다. 앱 플랫폼은 문자열 값으로 식별됩니다. 앱 ID는 관련 플랫폼에서 제공하는 ID입니다(예: Android Play 스토어의 번들 ID 또는 Apple App Store의 앱 ID). URL 문자열을 기준 ID로 사용하도록 site 행 유형이 업데이트되었습니다. |
|
브라우저 타겟팅 - 제외 브라우저 타겟팅 - 포함 |
이 열은 타겟팅 유형
|
|
이동통신사 타겟팅 - 제외 이동통신사 타겟팅 - 포함 |
이 열은 타겟팅 유형
|
|
채널 타겟팅 - 제외 채널 타겟팅 - 포함 |
이 열은 Display & Video 360 API
|
|
기기 타겟팅 - 제외 기기 타겟팅 - 포함 |
이 열은 다음 타겟팅 유형에서 Display & Video 360 API
|
사이트 타겟팅 - 제외 사이트 타겟팅 - 포함 |
이 열은 URL 문자열을 통해 사이트를 식별할 수 있도록 업데이트되었습니다. |
미디어 제품
| v7 열 이전 안내 | |
|---|---|
|
채널 타겟팅 - 제외 채널 타겟팅 - 포함 |
이 열은 Display & Video 360 API
|
| 기기 타겟팅 - 포함 |
이 열은 다음 타겟팅 유형에서 Display & Video 360 API
|
v6 이후 추가된 열과의 통합 추가
v6에서 v7로 이전하는 경우 다음 열을 관련 파일에 추가해야 합니다.
| 파일 형식 | 열 |
|---|---|
| 광고 항목 | TrueView 타겟 게재빈도 횟수 |
| 광고 항목 | TrueView 타겟 게재빈도 시간 창 |
| YouTube 광고그룹 | 타겟팅 최적화 |
이전 구조화된 데이터 파일 버전에서 이전하는 경우 구조화된 데이터 파일 출시 노트에서 현재 버전과 SDF v6 사이에 추가된 추가 열에 관한 정보를 확인하세요.
기타 변경사항
또한 v7에서는 통합을 간소화하고 지원 중단된 항목 읽기 파일을 참조용으로 사용하지 않는 데 도움이 되도록 몇 가지 피상적인 변경사항을 도입했습니다.
일부 열의 새로운 목록 정렬
SDF v7은 파일 생성 시 특정 목록 열의 안정적인 순서를 보장합니다. 이렇게 하면 동작이 더 일관되고 검토도 쉬워집니다. 이 순서는 파일 업로드에는 적용되지 않지만 이후에 업데이트된 파일을 생성할 때 적용됩니다.
이제 v7 출시 노트에서 숫자 또는 알파벳 오름차순으로 생성되는 열의 전체 목록을 확인하세요.
새 ID 참조 추천
여러 열의 정의를 업데이트하여 지원 중단된 항목 읽기 파일에 대한 참조를 삭제하고 대신 다른 ID 조회 방법을 권장합니다.
다음 열에서 반환된 값은 SDF v6에서와 다르지 않지만 v7 열 설명에서 확인할 수 있는 새로운 권장 방법을 사용하여 ID를 가져오도록 통합을 업데이트하는 것이 좋습니다.
| 파일 형식 및 열 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign |
|
|||||||||||||||||||||
| 게재 신청서 |
|
|||||||||||||||||||||
| 광고 항목 |
|
|||||||||||||||||||||
| 미디어 제품 |
|
|||||||||||||||||||||
| YouTube 광고 그룹 |
|
|||||||||||||||||||||