구조화된 데이터 파일 (SDF)과 Display & Video 360 API 모두 Display & Video 360 리소스 구성의 일괄 관리를 지원합니다. 도구마다 고유한 제한사항이 있습니다. 이 가이드에서는 두 도구를 모두 사용하여 기존 구현을 최적화하는 방법을 제안합니다.
이미 구조화된 데이터 파일을 사용하는 경우
Display & Video 360 API를 사용하여 파일 및 관련 메타데이터의 프로그래매틱 검색을 통해 SDF 통합을 지원합니다.
API를 사용하여 파일 생성 및 다운로드
기본적으로 Display & Video 360 인터페이스를 사용하여 구조화된 데이터 파일을 수동으로 다운로드합니다. 이러한 다운로드는 일반적으로 단일 광고주로 제한되며 특정 리소스 페이지에서 시작해야 합니다. 인터페이스를 통해 다량의 SDF 데이터를 다운로드하는 것은 복잡하고 시간이 오래 걸릴 수 있습니다.
Display & Video 360 API를 사용해 프로그래매틱 방식으로 구조화된 데이터 파일을 생성하고 다운로드하면 이 프로세스를 간소화할 수 있습니다. 이 기능을 구현하는 방법에 관한 단계별 안내는 가이드를 참고하세요.
API를 사용하여 참조 ID 조회
구조화된 데이터 파일에는 Display & Video 360 리소스의 구성이 반영됩니다. 대부분의 SDF 열은 숫자 ID를 사용하여 다른 리소스 또는 타겟팅 구성을 식별합니다. SDF 데이터를 읽고 수정할 때 이러한 ID를 이해하려면 참조가 필요한 경우가 많습니다.
Display & Video 360 API를 사용하여 참조 정보를 일괄적으로 가져옵니다. 관련 리소스의 GET 또는 LIST 함수를 사용하여 대부분의 SDF 열에서 사용하는 ID를 검색할 수 있습니다.
구조화된 데이터 파일을 파싱하고 수정할 때 캐시된 정보를 사용할 수 있도록 참조 정보를 프로그래매틱 방식으로 가져오고 캐시합니다. 정기적으로 캐시를 업데이트하고, SDF를 파싱하여 새 리소스의 정보를 검색할 때 필요한 경우 알 수 없는 ID를 실시간으로 조회할 수 있습니다.
사용 가능한 API 서비스 및 메서드의 전체 목록은 API 참조 문서를 확인하세요.
기존 예외
구조화된 데이터 파일에 사용되는 참조 ID 중 일부는 Display & Video 360 API를 사용하여 가져올 수 없습니다.
- 관심분야 및 구매 의도 타겟팅: Display & Video 360 인터페이스에서 이러한 열에 사용된 잠재고객 ID를 검색합니다.
- 전환 플러드라이트 활동 ID: 이 열에 사용된 플러드라이트 활동 ID를 Display & Video 360 인터페이스에서 가져옵니다.
- 인벤토리 소스 타겟팅: 게시된 SDF 교환 참조에서 이러한 열에 사용된 Exchange ID를 검색합니다. Display & Video 360 API를 사용하여 이러한 열에 사용된 인벤토리 소스 ID와 하위 거래소 ID를 가져옵니다.
- 앱 타겟팅: 이러한 열에 사용된 앱 ID를 관련 앱 플랫폼에서 검색합니다.
이미 Display & Video 360 API를 사용하는 경우
SDF를 사용하여 YouTube와 파트너 리소스의 일괄 생성 및 업데이트를 통해 Display & Video 360 API 통합을 지원합니다.
SDF 업로드를 사용하여 YouTube + 파트너 리소스 업데이트
Display & Video 360 API를 사용하여 특정 유형의 광고 항목, 광고그룹, 광고와 같은 YouTube + 파트너 리소스를 만들거나 업데이트할 수 없습니다. 이러한 리소스의 구성 및 할당된 타겟팅을 검색할 수 있지만 모든 업데이트는 Display & Video 360 인터페이스를 통해 실행해야 합니다. 이렇게 하면 일괄 작업이 제한되고 이러한 리소스를 업데이트할 수 있는 속도가 제한됩니다.
구조화된 데이터 파일 업로드를 사용하면 Display & Video 360 인터페이스를 통해 YouTube + 파트너 리소스를 일괄적으로 만들거나 업데이트할 수 있습니다. 구조화된 데이터 파일을 수동으로 업로드해야 하지만 대부분의 프로세스, 즉 파일을 프로그래매틱 방식으로 검색하고 수정하는 작업은 대부분 완료할 수 있습니다.
자세한 내용은 SDF 다운로드에 관한 API 가이드 및 SDF 업로드 문서를 참고하세요.