구조화된 데이터 파일 (SDF)은 특별한 형식으로 지정된 CSV 파일입니다. Display & Video 360에서 리소스를 일괄적으로 가져오고, 만들고, 수정할 수 있습니다. SDF를 다운로드하고 수정하고 다시 업로드하여 리소스를 일괄적으로 업데이트합니다.
Display & Video 360 UI는 SDF 다운로드 및 업로드를 지원합니다. Display & Video 360 API는 SDF 다운로드를 지원합니다.
형식
SDF는 표준과 QA라는 두 가지 기본 형식 중 하나를 사용합니다.
- 표준 형식 파일을 다운로드하고 업로드할 수 있습니다. 이러한 파일의 데이터는 업로드 시 정확성을 보장하기 위해 숫자 ID를 사용할 수 있습니다. 데이터를 해석하려면 참조 정보가 필요할 수 있습니다.
- QA 형식 파일을 다운로드할 수 있습니다. 이러한 파일은 표준 형식 파일과 동일한 데이터를 제공하지만 사람이 더 쉽게 읽을 수 있는 값을 사용합니다. 예를 들어 일부 열은 ID 대신 표시 이름을 사용할 수 있습니다. 이 형식에 해당하는 열은 'Qa' 접미사를 사용합니다.
파일 형식
SDF는 7가지 리소스 유형을 지원합니다. 각 리소스 유형에는 자체 열 구조가 있는 자체 파일 유형이 있습니다. 지원되는 리소스 유형은 다음과 같습니다.
- 캠페인
- 게재 신청서
- 광고 항목
- 광고그룹
- 광고
- 인벤토리 소스
- 미디어 제품
광고 항목 및 광고 그룹 파일 유형만 QA 형식을 지원합니다.
새 SDF 버전은 정기적으로 출시되며 이전 버전은 지원 중단됩니다. 새 버전에서는 파일 유형 열 구조가 업데이트됩니다. 필요한 경우 새 SDF 버전에는 출시 시 이전 가이드가 포함됩니다.
다운로드 오류
SDF 다운로드로 인해 파일 생성 오류와 건너뛴 리소스라는 두 가지 유형의 오류가 발생할 수 있습니다.
파일 생성 오류
SDF 생성이 오류로 종료될 수 있습니다. Display & Video 360 API를 사용할 때 생성이 실패하면 완료된 작업에서 Status 객체를 사용하여 error 필드를 설정합니다. Status 객체에는 오류의 원인을 설명하는 메시지가 포함됩니다.
이러한 오류에 대한 자세한 내용은 오류 및 경고 가이드 페이지를 참고하세요.
건너뛴 오류
SDF는 일부 리소스 하위 유형을 지원하지 않습니다. 리소스를 SDF에 포함할 수 없는 경우 '건너뜀' 파일 (예: SDF-LineItems-Skipped.csv)이 다운로드에 포함됩니다. 이 파일은 2열 구조입니다. 첫 번째 열은 건너뛴 리소스를 식별합니다. 두 번째 열에는 제외 이유가 설명되어 있습니다.
파일 업로드
Display & Video 360 UI를 사용하여 SDF를 업로드하여 새 리소스를 만들거나 기존 리소스를 업데이트합니다.
SDF로 리소스를 업데이트하거나 생성할 때 오류를 최소화하려면 다음 단계를 따르세요.
- Display & Video 360 API 또는 UI를 사용하여 SDF를 다운로드합니다.
- 기존 파일 항목을 수정하여 기존 리소스를 업데이트합니다.
- 파일 항목을 추가하여 새 리소스를 만듭니다.
- 새롭거나 업데이트되지 않은 항목을 삭제합니다. 이렇게 하면 파일 크기가 줄어들고 의도치 않은 업데이트 가능성이 없어집니다.
- Display & Video 360 UI에 파일을 업로드합니다.
SDF가 업로드되고 처리되면 SDF-ResultFile.zip 파일을 다운로드할 수 있습니다. 이 ZIP 파일에는 다음 두 가지 파일이 포함될 수 있습니다.
SDF-{ResourceType}-Updated-ResultFile.csv: 업데이트되거나 생성된 리소스가 나열됩니다.SDF-{ResourceType}-Failed-ResultFile.csv: 실패한 작업과 관련 오류 메시지를 나열합니다.
ZIP 파일에는 파일이 하나 또는 두 개 모두 포함될 수 있습니다.