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