최종 업데이트: 2024년 11월 12일
이 가이드에서는 구조화된 데이터 파일 v7.1 사용에서 v8로 이전하는 프로세스를 안내하고 통합에 영향을 줄 수 있는 두 버전 간의 변경사항을 설명합니다.
v7.1과 v8의 차이점은 출시 노트를 참고하세요.
구조화된 데이터 파일 버전 이전
이전 버전에서 구조화된 데이터 파일(SDF) v8로 이전하는 방법은 다음과 같습니다.
- v8을 사용하도록 리소스와 SDF 생성 작업을 업데이트합니다.
- 생성 시 유형을 식별하도록 광고 리소스 로직을 업데이트합니다.
- 디맨드젠 리소스를 읽고, 만들고, 업데이트하는 새로운 로직을 추가합니다.
구조화된 데이터 파일 버전 업데이트
새 구조화된 데이터 파일 버전을 사용하려면 상위 파트너 및 광고주 리소스에서 할당된 버전을 업데이트하고 Display & Video 360 API에서 개별 다운로드 작업을 만들 때 새 버전을 사용하세요.
상위 리소스 설정 업데이트
기본 구조화된 데이터 파일 버전은 파트너 및 광고주 리소스 수준에서 설정됩니다. 이 버전은 인터페이스 또는 API를 통해 구조화된 데이터 파일을 다운로드할 때 기본값으로 사용됩니다.
인터페이스에 설정
파트너 수준에서
- 원하는 파트너로 이동합니다.
- 왼쪽 탐색 메뉴에서 파트너 설정 메뉴를 펼치고 기본 세부정보 페이지로 이동합니다.
- 구조화된 데이터 파일 섹션에서 SDF 버전 구성을 v8으로 업데이트합니다.
광고주 수준
- 원하는 광고주로 이동합니다.
- 왼쪽 탐색 메뉴에서 광고주 설정 메뉴를 펼치고 기본 세부정보 페이지로 이동합니다.
- 구조화된 데이터 파일 섹션에서 SDF 버전 구성을 v8으로 업데이트합니다. 기본 버전이 파트너 수준에서 설정된 경우 이 설정을 수정할 수 없습니다.
API에 설정
- 파트너 수준
- API의 파트너 수준에서는 기본 SDF 버전을 설정할 수 없습니다.
- 광고주 수준
dataAccessConfig.sdfConfig.sdfConfig.version를SDF_VERSION_8로, 필요한 경우dataAccessConfig.sdfConfig.overridePartnerSdfConfig를True로 업데이트하기 위한advertisers.patch요청을 실행합니다.
API에서 sdfdownloadtasks.create 요청 업데이트
Display & Video 360 API를 사용하여 sdfdownloadtasks.create 요청을 실행할 때는 요청 본문의 version 필드를 SDF_VERSION_8로 설정합니다.
광고 리소스에서 유형 지정
v8에서는 광고 파일에 Ad Type 열을 추가하여 각 행으로 표시되는 광고 유형을 표시합니다. 이 새 열은 필수이며 v8 광고 파일을 다운로드할 때 기존 리소스에 채워집니다.
기존 광고를 업데이트할 때는 이 열의 값을 변경하면 안 됩니다.
새 광고를 만들 때는 이 열을 열 설명에 나열된 값 중 하나로 채워야 합니다.
디맨드젠 리소스의 로직 업데이트
v8은 광고 항목, 광고 그룹, 광고 파일을 사용하여 디맨드젠 캠페인을 생성, 검색, 업데이트하는 기능을 지원합니다. 수요 생성 리소스는 타임스탬프 확인에 다른 로직을 사용하고, 추가 열을 채워야 하며, 세 가지 파일 유형에 걸쳐 새로운 제한사항으로 제한됩니다.
타임스탬프 확인
디맨드젠 캠페인 이외의 모든 광고 항목의 경우 광고 항목 파일의 Timestamp 열이 다운로드 시 광고 항목이 마지막으로 수정된 시간으로 채워집니다. 이 값은 SDF를 사용하여 광고 항목을 업데이트할 때 원본 파일이 다운로드된 이후 광고 항목이 업데이트되지 않았는지 확인하는 데 사용됩니다. 이 경우 업데이트가 실패합니다.
디맨드젠 캠페인 광고 항목의 경우 Timestamp 열과 함께 제공되는 인증이 다르게 작동합니다. 디맨드젠 캠페인 광고 항목 항목의 경우 다운로드 시 현재 시간이 열에 채워집니다. 업로드 시 Display & Video 360은 지정된 타임스탬프 이후 24시간이 지났는지 확인합니다. 24시간이 지났다면 원본 파일 항목이 비활성 상태로 간주되어 업데이트가 실패합니다. 이 경우 파일을 다시 다운로드하고 최신 버전을 기반으로 업데이트합니다. 이 새로운 인증 방법은 지난 24시간 동안 적용된 변경사항을 덮어쓰는 것을 방지하지는 않습니다. 실수로 덮어쓰는 일이 없도록 업로드하는 파일에 업데이트하려는 디맨드젠 캠페인 광고 항목만 포함하세요.
필수 열
다음 파일 형식에는 해당 파일 형식의 모든 항목에 필요한 열 외에도 특정 수요 생성 리소스에 필요한 열이 있습니다.
광고 항목
다음
광고 항목
Type 열 값에 필요한 열
|
||||
| 디맨드젠 캠페인 |
|
|||
광고
다음
광고
Ad Type 열 값에 필요한 열
|
|||||||||
| 디맨드젠 캠페인 캐러셀 |
|
||||||||
| 디맨드젠 캠페인 이미지 |
|
||||||||
| 디맨드젠 캠페인 제품 |
|
||||||||
| 디맨드젠 캠페인 동영상 |
|
||||||||
업데이트된 제한사항
특정 디맨드젠 캠페인 광고 항목 및 광고에 필요한 새로운 열 외에도 광고 항목, 광고 그룹, 광고 파일 유형의 여러 열에 디맨드젠 리소스에 적용되는 새로운 사용 제한이 있습니다.
이러한 제한사항은 다양하며 해당 열에 따라 다르므로 이 가이드에서는 모든 제한사항을 나열하지는 않습니다. SDF 업로드를 사용하여 디맨드젠 리소스를 만들거나 업데이트하기 전에 광고 항목, 광고 그룹, 광고 파일 유형에 관한 v8 참조 문서를 자세히 읽어 보시기 바랍니다.