구조화된 데이터 - v10 - 광고 그룹

형식에 대한 설명은 개요를 참고하세요.

필드	필수	유형	쓰기 가능	설명
광고그룹 ID	기존 광고 그룹을 수정할 때만 필요합니다.	정수	아니요	광고 그룹의 숫자 ID 값입니다. 비워 두면 새 광고 그룹 ID가 생성되고 고유 ID가 할당됩니다. 선택적으로 새 광고 그룹을 만들 때 새 광고 그룹에 TrueView 광고를 할당하기 위해 맞춤 식별자를 사용할 수 있습니다. 맞춤 식별자의 형식은 'ext[맞춤 식별자]'입니다(예: ext123). 파일이 업로드되고 처리되면 모든 맞춤 식별자는 DBM에서 할당된 ID로 대체되고, 해당 객체는 맞춤 식별자를 기반으로 연결됩니다 (예: 광고를 광고 그룹에 연결).
광고 항목 ID	예	정수	아니요	상위 광고 항목의 숫자 ID 값입니다. 이 광고 그룹과 동시에 생성 중인 광고 항목에 맞춤 식별자를 지정할 수 있습니다 (예: 'ext[맞춤 광고 항목 ID]').
광고 항목 이름	아니요	문자열	아니요	광고 항목 이름
이름	예	문자열	예	항목의 이름입니다.
상태	예	문자열	예	항목의 상태 설정입니다. 활성 일시중지됨 삭제됨
동영상 광고 형식	예	문자열	예	광고 그룹의 광고 형식입니다. 다음 값 중 하나를 선택합니다. 인스트림 인피드 동영상 광고 범퍼 건너뛸 수 없음 반응형 효율적 잠재고객 도달 YouTube 오디오 디맨드젠 캠페인
입찰 비용	예	float	예	'TrueView 입찰 전략 유형' 열에 설정된 입찰 유형을 기반으로 하는 광고 그룹의 최대 타겟 입찰 비용을 나타내는 값입니다. 예를 들어 'TrueView 입찰 전략 유형'이 '수동 CPV'인 경우 최대 비용입니다. 참고: 'TrueView 입찰 전략 유형' 열이 '전환수 최대화', '전환 가치 극대화' 또는 '클릭수 최대화'인 경우 업로드 시 이 열은 0이어야 합니다.
키워드 타겟팅 - 포함	아니요	문자열, 목록	예	타겟팅에 포함할 키워드 문자열 목록입니다. 이 목록은 알파벳순으로 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
키워드 타겟팅 - 제외	아니요	문자열, 목록	예	타겟팅에서 제외할 키워드 문자열 목록입니다. 이 목록은 알파벳순으로 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
카테고리 타겟팅 - 포함	아니요	문자열, 목록	예	타겟팅에 포함할 카테고리 목록입니다. 이 열은 타겟팅 유형 TARGETING_TYPE_CATEGORY에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다. 목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등) 이 목록은 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
카테고리 타겟팅 - 제외	아니요	문자열, 목록	예	타겟팅에서 제외할 카테고리 목록입니다. 이 열은 타겟팅 유형 TARGETING_TYPE_CATEGORY에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다. 목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등) 이 목록은 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - YouTube 채널 - 포함	아니요	문자열, 목록	예	포함할 YouTube 채널 목록입니다. 목록 형식 = (YouTube 채널 ID; YouTube 채널 ID; 등) '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - YouTube 채널 - 제외	아니요	문자열, 목록	예	제외할 YouTube 채널 목록입니다. 목록 형식 = (YouTube 채널 ID; YouTube 채널 ID; 등) '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - YouTube 동영상 - 포함	아니요	문자열, 목록	예	포함할 YouTube 동영상 목록입니다. 목록 형식 = (YouTube 동영상 ID; YouTube 동영상 ID; 등) '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - YouTube 동영상 - 제외	아니요	문자열, 목록	예	제외할 YouTube 동영상 목록입니다. 목록 형식 = (YouTube 동영상 ID; YouTube 동영상 ID; 등) '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - 인기 콘텐츠 - 포함	아니요	문자열, 목록	예	YouTube 및 Google 동영상 파트너에서 포함할 인기 콘텐츠 목록입니다. 개별 콘텐츠 분류에는 구조화된 'video_content::콘텐츠 분류 ID'가 있어야 합니다. 목록 형식 = (video_content::콘텐츠 분류 ID; video_content::콘텐츠 분류 ID; 등). '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - 인기 콘텐츠 - 제외	아니요	문자열, 목록	예	YouTube 및 Google 동영상 파트너에서 제외할 인기 콘텐츠 목록입니다. 개별 콘텐츠 분류에는 구조화된 'video_content::콘텐츠 그룹 ID'가 있어야 합니다. 목록 형식 = (video_content::콘텐츠 분류 ID; video_content::콘텐츠 분류 ID; 등). '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - URL - 포함	아니요	문자열, 목록	예	타겟팅에 포함할 URL 목록입니다. 목록은 URL 문자열로 구성됩니다. 목록 형식 = (someurl.com; someurltwo.com; etc.) '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - URL - 제외	아니요	문자열, 목록	예	타겟팅에서 제외할 URL 목록입니다. 목록은 URL 문자열로 구성됩니다. 목록 형식 = (someurl.com; someurltwo.com; etc.) '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - 앱 - 포함	아니요	문자열, 목록	예	타겟팅에서 제외할 모바일 앱 목록입니다. 목록은 앱 플랫폼 ID로 구성됩니다. ID는 관련 플랫폼에서 제공합니다(예: Android Play 스토어의 번들 ID(예: com.google.android.gm) 또는 Apple App Store의 앱 ID(예: 422689480)). 목록 형식 = (com.google.android.gm; 422689480; 등). '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - 앱 - 제외	아니요	문자열, 목록	예	타겟팅에서 제외할 모바일 앱 목록입니다. 목록은 앱 플랫폼 ID로 구성됩니다. ID는 관련 플랫폼에서 제공합니다(예: Android Play 스토어의 번들 ID(예: com.google.android.gm) 또는 Apple App Store의 앱 ID(예: 422689480)). 목록 형식 = (com.google.android.gm; 422689480; 등). '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - 앱 컬렉션 - 포함	아니요	문자열, 목록	예	타겟팅에 포함할 앱 컬렉션 목록입니다. 이 열은 타겟팅 유형 TARGETING_TYPE_APP_CATEGORY에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다. 목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등) '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
게재위치 타겟팅 - 앱 컬렉션 - 제외	아니요	문자열, 목록	예	타겟팅에서 제외할 앱 컬렉션 목록입니다. 이 열은 타겟팅 유형 TARGETING_TYPE_APP_CATEGORY에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다. 목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등) '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
인구통계 타겟팅 성별	예	문자열, 목록	예	타겟팅할 성별 목록입니다. 허용되는 값 중 하나 이상을 선택합니다. 여성 남성 알 수 없음 '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
인구통계학적 타겟팅 연령	예	문자열, 목록	예	타겟팅할 연령 목록입니다. 허용되는 값 중 하나 이상을 선택합니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
인구통계학적 타겟팅 가계 소득	예	문자열, 목록	예	타겟팅할 가계 소득 목록입니다. 허용되는 값 중 하나 이상을 선택합니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
인구통계학적 타겟팅 자녀 유무	예	문자열, 목록	예	타겟팅할 자녀 유무 목록입니다. 허용되는 값 중 하나 이상을 선택합니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
타겟팅 최적화	아니요	문자열	예	타겟팅 최적화를 사용 설정합니다. TRUE FALSE 타겟팅 최적화는 일부 입찰 전략과 호환되지 않습니다. 다음의 경우 이 열은 'FALSE'여야 합니다. '입찰 전략 유형'이 '고정'임 '입찰 전략 유형'이 '최적화된 vCPM'입니다. '입찰 전략 유형'이 '최대'이고 '입찰 전략 단위'가 'CIVA', 'IVO_TEN' 또는 'AV_VIEWED'인 경우 이 제한사항은 광고 항목이 상위 게재 신청서에서 위의 입찰 전략 중 하나를 상속하는 경우에도 적용됩니다. 게재 신청서 수준에서 설정된 입찰 전략은 게재 신청서의 '게재 신청서 최적화' 열이 'TRUE'로 설정된 경우 광고 항목에 상속됩니다.
잠재고객 확장 수준	아니요	정수	예	잠재고객 확장 수준입니다. 값이 0, 1, 2, 3인 광고 그룹에만 설정할 수 있습니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없음
잠재고객 확장 시드 목록 제외됨	아니요	문자열	예	잠재고객 확장 시드 목록이 제외되었습니다. TRUE FALSE '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없음
잠재고객 타겟팅 - 포함	아니요	문자열, 목록	예	포함할 잠재고객 목록의 목록입니다. 이 열은 Display & Video 360 API FirstPartyAndPartnerAudience 리소스 ID를 사용합니다. 목록 형식 = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; 등). 이 목록은 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
잠재고객 타겟팅 - 제외	아니요	문자열, 목록	예	제외할 잠재고객 목록입니다. 이 열은 Display & Video 360 API FirstPartyAndPartnerAudience 리소스 ID를 사용합니다. 목록 형식 = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; 등). 이 목록은 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
유사 잠재고객 타겟팅 - 포함	아니요	문자열, 목록	예	타겟팅에 포함할 유사 잠재고객 목록입니다. 목록 형식 = (유사 잠재고객 ID; 유사 잠재고객 ID; 등) 디맨드젠 광고 그룹에서만 사용할 수 있습니다.
유사 잠재고객 타겟팅 - 제외	아니요	문자열, 목록	예	타겟팅에서 제외할 유사 잠재고객 목록입니다. 목록 형식 = (유사 잠재고객 ID; 유사 잠재고객 ID; 등) 디맨드젠 광고 그룹에서만 사용할 수 있습니다.
관심분야 및 구매 의도 타겟팅 - 포함	아니요	문자열, 목록	예	제외할 관심분야 또는 구매 의도 잠재고객 목록입니다. 잠재고객 목록 ID는 Display & Video 360 인터페이스에서 가져올 수 있습니다. 목록 형식 = (잠재고객 ID; 잠재고객 ID; 등) 이 목록은 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
관심분야 및 구매 의도 타겟팅 - 제외	아니요	문자열, 목록	예	제외할 관심분야 또는 구매 의도 잠재고객 목록입니다. 잠재고객 목록 ID는 Display & Video 360 인터페이스에서 가져올 수 있습니다. 목록 형식 = (잠재고객 ID; 잠재고객 ID; 등) 이 목록은 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
생애 주요 이벤트 타겟팅 - 포함	아니요	문자열, 목록	예	포함할 생애 주요 이벤트 잠재고객 목록입니다. 잠재고객 목록 ID는 Display & Video 360 인터페이스에서 가져올 수 있습니다. 목록 형식 = (잠재고객 ID; 잠재고객 ID; 등) 이 목록은 오름차순으로 생성됩니다. '유형'이 'TrueView' 또는 '디맨드젠 캠페인'인 경우에만 유효합니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
생애 주요 이벤트 타겟팅 - 제외	아니요	문자열, 목록	예	제외할 생애 주요 이벤트 잠재고객 목록입니다. 잠재고객 목록 ID는 Display & Video 360 인터페이스에서 가져올 수 있습니다. 목록 형식 = (잠재고객 ID; 잠재고객 ID; 등) 이 목록은 오름차순으로 생성됩니다. '유형'이 'TrueView' 또는 '디맨드젠 캠페인'인 경우에만 유효합니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
세부 인구통계 타겟팅 - 포함	아니요	문자열, 목록	예	포함할 상세 인구통계 잠재고객 목록입니다. 잠재고객 목록 ID는 Display & Video 360 인터페이스에서 가져올 수 있습니다. 목록 형식 = (잠재고객 ID; 잠재고객 ID; 등) 이 목록은 오름차순으로 생성됩니다. '유형'이 'TrueView' 또는 '디맨드젠 캠페인'인 경우에만 유효합니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
상세 인구통계 타겟팅 - 제외	아니요	문자열, 목록	예	제외할 상세한 인구통계 잠재고객 목록입니다. 잠재고객 목록 ID는 Display & Video 360 인터페이스에서 가져올 수 있습니다. 목록 형식 = (잠재고객 ID; 잠재고객 ID; 등) 이 목록은 오름차순으로 생성됩니다. '유형'이 'TrueView' 또는 '디맨드젠 캠페인'인 경우에만 유효합니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
통합 잠재고객 타겟팅	아니요	문자열, 목록	예	타겟팅할 합성 잠재고객 목록의 목록입니다. 이 열은 Display & Video 360 API CombinedAudience 리소스 ID를 사용합니다. 목록 형식 = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; 등) 이 목록은 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
맞춤 목록 타겟팅	아니요	문자열, 목록	예	타겟팅할 맞춤 목록의 목록입니다. 이 열은 Display & Video 360 API CustomList 리소스 ID를 사용합니다. 목록 형식 = (CustomList.customListId; CustomList.customListId; 등) 이 목록은 오름차순으로 생성됩니다. '동영상 시퀀스' 광고 항목의 광고 그룹에는 사용할 수 없습니다.
언어 타겟팅 - 포함	아니요	문자열, 목록	예	타겟팅에 포함할 언어 목록입니다. 이 열은 타겟팅 유형 TARGETING_TYPE_LANGUAGE에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다. 목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등) 이 목록은 오름차순으로 생성됩니다. 다음 조건을 충족하는 경우에만 사용할 수 있습니다. '동영상 광고 형식' 열이 '디맨드젠 캠페인'으로 설정되어 있습니다. 상위 광고 항목의 지역 및 언어 타겟팅 수준이 UI에서 광고 그룹으로 설정되어 있습니다.
지역 타겟팅 - 포함	아니요	문자열, 목록	예	타겟팅에 포함할 지역 목록입니다. 이 열은 타겟팅 유형 TARGETING_TYPE_GEO_REGION에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다. 목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등) 이 목록은 오름차순으로 생성됩니다. 다음 조건을 충족하는 경우에만 사용할 수 있습니다. '동영상 광고 형식' 열이 '디맨드젠 캠페인'으로 설정되어 있습니다. 상위 광고 항목의 지역 및 언어 타겟팅 수준이 UI에서 광고 그룹으로 설정되어 있습니다.
지역 타겟팅 - 제외	아니요	문자열, 목록	예	타겟팅에서 제외할 지역 목록입니다. 이 열은 타겟팅 유형 TARGETING_TYPE_GEO_REGION에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다. 목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등) 이 목록은 오름차순으로 생성됩니다. 다음 조건을 충족하는 경우에만 사용할 수 있습니다. '동영상 광고 형식' 열이 '디맨드젠 캠페인'으로 설정되어 있습니다. 상위 광고 항목의 지역 및 언어 타겟팅 수준이 UI에서 광고 그룹으로 설정되어 있습니다.
지역 위치 목록 타겟팅 - 포함	아니요	문자열, 목록	예	포함할 지역 위치 목록 ID 목록입니다. 목록 형식 = (11; 22; 33;).
지역 위치 목록 타겟팅 - 제외	아니요	문자열, 목록	예	제외할 지역 위치 목록 ID 목록입니다. 목록 형식 = (11; 22; 33;).
디맨드젠 캠페인 인벤토리 소스 전략	디맨드젠 광고 그룹의 경우 예	문자열	예	디맨드젠 캠페인 인벤토리 소스 전략 모든 Google 인벤토리 모든 Google 및 디스플레이 네트워크 인벤토리 선택한 인벤토리
디맨드젠 캠페인 사용 설정 인벤토리 소스	아니요	문자열, 목록	예	디맨드젠이 사용 설정된 인벤토리 소스입니다. 인벤토리 소스 전략이 설정되지 않은 경우에 사용됩니다. YouTube 건너뛸 수 있는 광고 YouTube 인피드 광고 YouTube Shorts 광고 Gmail Discover Google 디스플레이 네트워크
제품 필터 유형	상위 항목에 '판매자 센터 계정 ID'가 설정된 경우 필수입니다.	문자열	예	제품 필터 옵션 선택입니다. 모든 제품 특정 제품 맞춤 라벨 제품 없음
제품 필터 설정	'제품 필터 유형'이 '특정 제품' 또는 '맞춤 라벨'인 경우 필수입니다.	문자열, 목록	예	제품 필터 설정입니다. '제품 필터 유형' 선택에 따라 ID 목록 또는 키-값 쌍으로 구성됩니다. '제품 필터 유형'이 '특정 제품'인 경우 목록에는 Google 판매자 센터에서 확인할 수 있는 숫자 제품 ID가 포함됩니다. 예: (1; 2; 3; 등) '제품 필터 유형'이 '맞춤 라벨'인 경우 목록에는 키가 '맞춤 라벨 [0-4]' 형식이고 값이 문자열인 키-값 쌍 목록이 포함됩니다. 예: (맞춤 라벨 0: 값; 맞춤 라벨 1: 값 등) '제품 필터 유형'이 '모든 제품' 또는 '제품 없음'인 경우 이 열은 비워 두어야 합니다.
동영상 시퀀스 단계 ID	상위 광고 항목 하위 유형이 '동영상 시퀀스'인 경우 필수	정수	예	이 광고 그룹이 속한 시퀀스 단계의 ID입니다. 이 광고 그룹을 만들기 전에 상위 광고 항목의 '동영상 시퀀스 단계'에 단계가 있어야 합니다. 이 필드는 설정 후 변경할 수 없습니다. '동영상 시퀀스' 광고 항목의 광고 그룹에만 사용할 수 있습니다.