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

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

필드필수유형쓰기 가능설명
광고그룹 ID기존 광고 그룹을 수정할 때만 필요합니다.정수아니요광고 그룹의 숫자 ID 값입니다. 비워 두면 새 광고 그룹 ID가 생성되고 고유 ID가 할당됩니다. 원하는 경우 새 광고 그룹을 만들 때 맞춤 식별자를 사용하여 새 광고 그룹에 TrueView 광고를 할당할 수 있습니다. 맞춤 식별자의 형식은 'ext[맞춤 식별자]'입니다(예: ext123). 파일이 업로드되고 처리되면 모든 맞춤 식별자는 DBM에서 할당된 ID로 대체되고, 해당 객체는 맞춤 식별자를 기반으로 연결됩니다 (예: 광고와 광고 그룹).
광고 항목 ID예정수아니요상위 광고 항목의 숫자 ID 값입니다. 이 광고 그룹과 동시에 생성 중인 광고 항목에 맞춤 식별자를 지정할 수 있습니다 (예: 'ext[맞춤 광고 항목 ID]').
광고 항목 이름아니요문자열아니요광고 항목 이름
이름예문자열예항목의 이름입니다.
상태예문자열예항목의 상태 설정입니다.
  • 활성
  • 일시중지됨
  • 삭제됨
동영상 광고 형식예문자열예광고 그룹의 광고 형식입니다.

다음 값 중 하나를 선택합니다.
  • 인스트림
  • 인피드 동영상 광고
  • 범퍼 광고
  • 건너뛸 수 없음
  • 반응형
  • 효율적 잠재고객 도달
  • YouTube 오디오
  • 디맨드젠 캠페인
입찰가예float예'TrueView 입찰 전략 유형' 열에 설정된 입찰 유형에 따라 광고 그룹의 최대 타겟 입찰가를 나타내는 값입니다. 예를 들어 'TrueView 입찰 전략 유형'이 '수동 CPV'인 경우 최대 조회당비용입니다.

참고: 'TrueView 입찰 전략 유형' 열이 '전환수 최대화', '전환 가치 극대화' 또는 '클릭수 최대화'인 경우 업로드 시 이 열은 0이어야 합니다.
키워드 타겟팅 - 포함아니요string, list예

타겟팅에 포함할 키워드 문자열 목록입니다.

이 목록은 알파벳순으로 오름차순으로 생성됩니다.

키워드 타겟팅 - 제외아니요string, list예

타겟팅에서 제외할 키워드 문자열 목록입니다.

이 목록은 알파벳순으로 오름차순으로 생성됩니다.

카테고리 타겟팅 - 포함아니요string, list예

타겟팅에 포함할 카테고리 목록입니다. 이 열은 타겟팅 유형 TARGETING_TYPE_CATEGORY에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다.

목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등). 이 목록은 숫자순으로 오름차순으로 생성됩니다.

카테고리 타겟팅 - 제외아니요string, list예타겟팅에서 제외할 카테고리의 목록입니다. 이 열은 타겟팅 유형 TARGETING_TYPE_CATEGORY에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다.

목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등). 이 목록은 숫자순으로 오름차순으로 생성됩니다.

게재위치 타겟팅 - YouTube 채널 - 포함아니요string, list예포함할 YouTube 채널 목록
게재위치 타겟팅 - YouTube 채널 - 제외아니요string, list예제외할 YouTube 채널 목록입니다.
게재위치 타겟팅 - YouTube 동영상 - 포함아니요string, list예포함할 YouTube 동영상 목록
게재위치 타겟팅 - YouTube 동영상 - 제외아니요string, list예제외할 YouTube 동영상 목록입니다.
게재위치 타겟팅 - 인기 콘텐츠 - 포함아니요string, list예YouTube 및 Google 동영상 파트너에서 인기 있는 콘텐츠 목록입니다. 허용되는 값 중 하나 이상을 선택합니다.
  • youtube_popular_content::001a1
  • gvp_popular_content::global_tier2
  • video_content::<ID>
게재위치 타겟팅 - URL - 포함아니요string, list예포함할 URL 목록입니다.
게재위치 타겟팅 - URL - 제외아니요string, list예제외할 URL 목록입니다.
게재위치 타겟팅 - 앱 - 포함아니요string, list예포함할 모바일 앱 목록입니다.
게재위치 타겟팅 - 앱 - 제외아니요string, list예제외할 모바일 앱 목록입니다.
게재위치 타겟팅 - 앱 컬렉션 - 포함아니요string, list예타겟팅에 포함할 앱 컬렉션 목록입니다. 목록 형식= 앱 컬렉션 ID; 앱 컬렉션 ID;
게재위치 타겟팅 - 앱 모음 - 제외아니요string, list예타겟팅에서 제외할 앱 모음의 목록입니다. 목록 형식= 앱 컬렉션 ID; 앱 컬렉션 ID;
인구통계학적 타겟팅 - 성별예string, list예타겟팅할 성별 목록입니다. 허용되는 값 중 하나 이상을 선택합니다.
  • 여성
  • 남성
  • 알 수 없음
인구통계학적 타겟팅 연령예string, list예타겟팅할 연령 목록입니다. 허용되는 값을 하나 이상 선택합니다.
  • 18-24
  • 만 25~34세
  • 만 35~44세
  • 만 45~54세
  • 만 55-64세
  • 65+
  • 알 수 없음
인구통계학적 타겟팅 가계 소득예string, list예타겟팅할 가계 소득 목록입니다. 허용되는 값을 하나 이상 선택합니다.
  • 상위 10%
  • 11~20%
  • 21~30%
  • 31~40%
  • 41~50%
  • 하위 50%
  • 알 수 없음
인구통계학적 타겟팅 자녀 유무예string, list예타겟팅할 자녀 유무 목록입니다. 허용되는 값을 하나 이상 선택합니다.
  • 자녀 있음
  • 자녀 없음
  • 알 수 없음
타겟팅 최적화아니요문자열예타겟팅 최적화를 사용 설정합니다.
  • TRUE
  • FALSE

타겟팅 최적화는 일부 입찰 전략과 호환되지 않습니다. 다음과 같은 경우 이 열은 'FALSE'여야 합니다.
  • '입찰 전략 유형'이 '최적화된 vCPM'임
  • '입찰 전략 유형'이 '최대'이고 '입찰 전략 단위'가 'CIVA', 'IVO_TEN' 또는 'AV_VIEWED'임
잠재고객 확장 수준아니요정수예잠재고객 확장 수준 값이 0, 1, 2, 3인 AdGroups로만 설정할 수 있습니다.
잠재고객 확장 시드 목록 제외됨아니요문자열예잠재고객 확장 시드 목록 제외를 사용 설정합니다.
  • TRUE
  • FALSE
잠재고객 타겟팅 - 포함아니요string, list예

포함할 잠재고객 목록

이 열은 Display & Video 360 API FirstAndThirdPartyAudience 리소스 ID를 사용합니다.

목록 형식 = (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; 등). 이 목록은 숫자순으로 오름차순으로 생성됩니다.

잠재고객 타겟팅 - 제외아니요string, list예

제외할 잠재고객 목록입니다.

이 열은 Display & Video 360 API FirstAndThirdPartyAudience 리소스 ID를 사용합니다.

목록 형식 = (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; 등). 이 목록은 숫자순으로 오름차순으로 생성됩니다.

유사 잠재고객 타겟팅 - 포함아니요string, list예

타겟팅에 포함할 유사 잠재고객 목록입니다.

목록 형식: 유사 잠재고객 ID, 유사 잠재고객 ID

디맨드젠 광고 그룹에서만 사용할 수 있습니다.
유사 잠재고객 타겟팅 - 제외아니요string, list예

타겟팅에서 제외할 유사 잠재고객 목록입니다.

목록 형식: 유사 잠재고객 ID, 유사 잠재고객 ID

디맨드젠 광고 그룹에서만 사용할 수 있습니다.
관심분야 및 구매 의도 타겟팅 - 포함아니요string, list예

포함할 관심분야 또는 구매 의도 잠재고객 목록

잠재고객 목록 ID는 Display & Video 360 인터페이스에서 가져올 수 있습니다.

목록 형식 = (잠재고객 ID, 잠재고객 ID 등) 이 목록은 숫자순으로 오름차순으로 생성됩니다.

관심분야 및 구매 의도 타겟팅 - 제외아니요string, list예

제외할 관심분야 또는 구매 의도 잠재고객 목록

잠재고객 목록 ID는 Display & Video 360 인터페이스에서 가져올 수 있습니다.

목록 형식 = (잠재고객 ID, 잠재고객 ID 등) 이 목록은 숫자순으로 오름차순으로 생성됩니다.

맞춤 목록 타겟팅아니요string, list예

타겟팅할 맞춤 목록의 목록입니다.

이 열은 Display & Video 360 API CustomList 리소스 ID를 사용합니다.

목록 형식 = (CustomList.customListId; CustomList.customListId; 등). 이 목록은 숫자순으로 오름차순으로 생성됩니다.

언어 타겟팅 - 포함아니요string, list예

타겟팅에 포함할 언어 목록입니다.

이 열은 타겟팅 유형 TARGETING_TYPE_LANGUAGE에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다.

목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등). 이 목록은 숫자순으로 오름차순으로 생성됩니다.

디맨드젠 광고 그룹에서만 사용할 수 있습니다.
지역 타겟팅 - 포함아니요string, list예

타겟팅에 포함할 지역 목록입니다.

이 열은 타겟팅 유형 TARGETING_TYPE_GEO_REGION에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다.

목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등). 이 목록은 숫자순으로 오름차순으로 생성됩니다.

디맨드젠 광고 그룹에서만 사용할 수 있습니다.
지역 타겟팅 - 제외아니요string, list예

타겟팅에서 제외할 지역 목록입니다.

이 열은 타겟팅 유형 TARGETING_TYPE_GEO_REGION에 Display & Video 360 API TargetingOption 리소스 ID를 사용합니다.

목록 형식 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 등). 이 목록은 숫자순으로 오름차순으로 생성됩니다.

디맨드젠 광고 그룹에서만 사용할 수 있습니다.