Display & Video 360 API를 사용하여 YouTube + 파트너 광고 항목, 광고그룹, 광고 리소스, YouTube + 파트너 광고 게재와 관련된 타겟팅을 가져올 수 있습니다. YouTube + 파트너 리소스와 타겟팅은 UI를 통해서만 만들거나 업데이트할 수 있습니다.
이 페이지에서는 Display & Video 360 API를 사용하여 YouTube + 파트너 리소스를 식별하고 관련 타겟팅을 검색하는 방법과 UI에서 구조화된 데이터 파일 (SDF)을 사용하여 YouTube 및 파트너 리소스를 일괄적으로 생성 및 업데이트하는 방법을 설명합니다.
YouTube + 파트너 리소스 확인
YouTube + 파트너 리소스는 특정 유형의 광고 항목, 광고 그룹, 광고로 구성됩니다.
광고 항목
다음 LineItemType 값의 광고 항목은 YouTube + 파트너 광고 항목이며 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTIONLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIOLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACHLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCYLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
YouTube + 파트너 광고 항목과 관련된 설정은 LineItem 리소스의
youtubeAndPartnersSettings 필드에서
가져올 수 있습니다.
YouTube 광고그룹 및 광고
YouTube 광고그룹 및 광고는 YouTube 및 파트너 광고 항목의 하위 리소스로, 추가 사양을 지정할 수 있습니다.
YouTube + 파트너 광고 항목에는 여러 AdGroup 리소스가 있을 수 있으며 각 리소스에는 자체 추가 타겟팅 및 입찰 전략이 있습니다. 각 AdGroup 리소스 아래에는 광고 형식이 동일한 여러 AdGroupAd 리소스가 있을 수 있으며, 각 리소스에는 자체 광고 소재 정보와 추가 추적 URL 목록이 있습니다.
타겟팅 검색
YouTube 및 파트너 광고 게재에 사용되는 타겟팅은 광고주 수준, 광고 항목 수준, 광고그룹 수준에서 할당됩니다.
상위 리소스에서 상속된 YouTube + 파트너 타겟팅은 YouTube 및 파트너 이외의 리소스의 표준처럼 하위 리소스의 타겟팅 설정에 반영되지 않습니다.
YouTube 및 파트너 광고 게재와 관련된 모든 타겟팅을 가져오려면 다음을 실행해야 합니다.
advertisers.listAssignedTargetingOptions를 사용하여 상위 광고주에게 할당된 타겟팅을 검색합니다.advertisers.lineItems.bulkListAssignedTargetingOptions를 사용하여 상위 광고 항목에 할당된 타겟팅을 검색합니다.- 그런 다음
advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions를 사용하여 상위 광고 그룹에 할당된 타겟팅을 가져올 수 있습니다.
YouTube 타겟팅 수정 시도 중
YouTube + 파트너 리소스와 마찬가지로 Display & Video 360 API를 사용하여 YouTube 및 파트너 타겟팅을 수정 할 수 없습니다. 다음 타겟팅을 수정하려고 하면 오류가 반환됩니다.
TARGETING_TYPE_SESSION_POSITION,TARGETING_TYPE_YOUTUBE_CHANNEL및TARGETING_TYPE_YOUTUBE_VIDEO타겟팅 유형의 임의 수준에서 할당된 타겟팅- YouTube + 파트너 광고 항목 리소스에 할당된 타겟팅입니다.
- 타겟팅이
AdGroup리소스에 할당되었습니다.
SDF UI 업로드를 사용하여 만들기 및 업데이트
Display & Video 360 API를 사용하여 YouTube + 파트너 리소스를 만들거나 업데이트할 수는 없지만, Display & Video 360 UI를 통한 구조화된 데이터 파일 (SDF) 업로드를 사용하여 YouTube + 파트너 광고 항목, 광고그룹, 광고를 일괄적으로 만들거나 업데이트할 수 있습니다.
이러한 리소스는 광고 항목, YouTube 광고그룹, YouTube 광고 파일 형식을 통해 SDF로 표현됩니다.
Display & Video 360 API를 사용하여 구조화된 데이터 파일을 생성하고 다운로드할 수 있습니다. 기존 행을 수정하여 기존 리소스를 변경하거나 새 행을 추가하여 새 리소스를 만들고 Display & Video 360 UI를 통해 업데이트된 파일을 업로드합니다.