형식에 대한 설명은 개요를 참고하세요.
| 필드 | 필수 | 유형 | 쓰기 가능 | 설명 |
|---|---|---|---|---|
| 광고 ID | 기존 광고를 수정할 때만 필요합니다. | 정수 | 아니요 | 광고 그룹 광고의 숫자 ID 값입니다. 비워 두면 새 광고가 생성되고 고유 ID가 할당됩니다. |
| 광고그룹 ID | 예 | 정수 | 아니요 | 상위 광고 그룹의 숫자 ID 값입니다. 이 광고와 동시에 생성 중인 광고 그룹에 맞춤 식별자를 지정할 수 있습니다 (예: 'ext[맞춤 광고 그룹 ID]'). |
| 광고그룹 이름 | 아니요 | 문자열 | 아니요 | 광고그룹 이름 |
| 이름 | 예 | 문자열 | 예 | 항목의 이름입니다. |
| 상태 | 예 | 문자열 | 예 | 항목의 상태 설정입니다.
|
| 광고 유형 | YouTube 및 디맨드젠 광고에 필요 | 문자열 | 예 | 광고의 광고 형식입니다. 인스트림 및 인피드 동영상은 CPV 기준으로 판매되는 YouTube 동영상 광고 유형입니다. 범퍼 광고는 CPM 기준으로 판매되는 6초 이하의 동영상 YouTube 광고입니다. 건너뛸 수 없는 동영상 광고는 CPM 기준으로 판매되는 6~15초 길이의 인스트림 YouTube 광고입니다. YouTube 오디오는 오디오 YouTube 광고입니다. 반응형 동영상 광고는 여러 형식으로 게재되는 YouTube 광고 유형입니다. 동영상이 충분히 짧은 경우 효율적 잠재고객 도달 광고가 YouTube 범퍼 광고로 게재되고, 그렇지 않은 경우에는 YouTube 인스트림 광고로 게재됩니다. 디맨드젠 동영상 광고는 YouTube를 포함하되 이에 국한되지 않는 여러 형식에 게재됩니다. 디맨드젠 이미지 광고에는 이미지가 표시됩니다. 디맨드젠 캐러셀 광고에는 카드가 표시됩니다. 디맨드젠 제품 광고에는 제품이 표시됩니다. 다음 값 중 하나를 선택합니다.
|
| 동영상 ID | YouTube 및 디맨드젠 동영상 광고에 필요 | 문자열 | 예 | YouTube 동영상 ID |
| 표시 URL | 인스트림 광고 및 범퍼 광고의 경우 예 | 문자열 | 예 | 광고 표시 URL |
| 방문 페이지 URL | 인스트림 광고, 범퍼 광고, 디맨드젠 광고에 필요 | 문자열 | 예 | 광고 방문 페이지 URL |
| DCM 추적 - 게재위치 ID | DCM 추적 광고를 업데이트할 때만 필요합니다. | 정수 | 예 | 해당 추적 광고의 DCM 게재위치의 숫자 ID 값입니다. DCM 추적 광고를 삭제하려면 DCM 추적 - 게재위치 ID, DCM 추적 - 광고 ID, DCM 추적 - 광고 소재 ID 열 세 개를 비워 둡니다. |
| DCM 추적 - 광고 ID | DCM 추적 광고를 업데이트할 때만 필요합니다. | 정수 | 예 | 해당 추적 광고의 DCM 광고의 숫자 ID 값입니다.DCM 추적 광고를 삭제하려면 DCM 추적 - 게재위치 ID, DCM 추적 - 광고 ID, DCM 추적 - 광고 소재 ID 열 세 개를 비워 둡니다. |
| DCM 추적 - 광고 소재 ID | DCM 추적 광고를 업데이트할 때만 필요합니다. | 정수 | 예 | 해당 추적 광고의 광고 소재의 숫자 ID 값입니다.DCM 추적 광고를 삭제하려면 DCM 추적 - 게재위치 ID, DCM 추적 - 광고 ID, DCM 추적 - 광고 소재 ID 열 세 개를 비워 둡니다. |
| 클릭 추적 광고 URL | 아니요 | 문자열 | 예 | 광고 클릭 추적기 URL |
| 클릭 추적 광고 URL 매개변수 | 아니요 | 문자열, 목록 목록 | 예 | 클릭 추적 광고 URL 맞춤 매개변수 형식 = (name1; value1;); (name2; value2;); 등 |
| 액션 유도하기 | 상위 광고 항목이 YouTube 동영상 액션 광고 항목이고, '광고 제목'이 비어 있지 않거나, '광고 유형'이 '디맨드젠 동영상', '디맨드젠 이미지', '디맨드젠 캐러셀'인 경우 필수사항입니다. | 문자열 | 예 | 클릭 유도 문구 버튼의 라벨입니다 (1줄, 최대 10자). |
| 광고 제목 | 디맨드젠 광고에 필요 | 문자열 | 예 | 클릭 유도 문구 오버레이의 광고 제목입니다(1줄, 최대 15자(영문 기준)). |
| 표시 URL 경로 1 | 아니요 | 문자열 | 예 | 표시 URL 경로 1 |
| 표시 URL 경로 2 | 아니요 | 문자열 | 예 | 표시 URL 경로 2 |
| 인피드 동영상 썸네일 | 인피드 동영상의 경우 예 | 문자열 | 예 | 동영상 디스커버리 광고에 사용할 동영상 썸네일
|
| 인피드 동영상 광고 제목 | 인피드 동영상 및 디맨드젠 광고에 필요 | 문자열 | 예 | 디스커버리 광고 또는 반응형 광고의 광고 제목 텍스트 또는 디맨드젠 광고의 긴 광고 제목입니다. |
| 내용 입력란 1 | 인피드 동영상 및 디맨드젠 광고에 필요 | 문자열 | 예 | 디스커버리 광고 내용 입력란 1 텍스트 또는 반응형 광고 내용 입력란 |
| 설명 2 | 인피드 동영상에 필요 | 문자열 | 예 | 디스커버리 광고 설명 2 텍스트 |
| 인피드 동영상 방문 페이지 | 인피드 동영상의 경우 예 | 문자열 | 예 | 디스커버리 광고 방문 페이지 |
| 모바일 방문 페이지 URL | 아니요 | 문자열 | 예 | 모바일 기기의 광고 방문 페이지 URL |
| 비즈니스 이름 | 디맨드젠 광고에 필요 | 문자열 | 예 | 광고 중인 비즈니스의 이름 |
| 방문 페이지 URL 접미사 | 아니요 | 문자열 | 예 | 방문 페이지 URL의 접미사 |
| 로고 저작물 ID | 디맨드젠 광고에 필요 | string, list | 예 | 로고의 저작물 ID 목록입니다. 이 목록은 숫자순으로 오름차순으로 생성됩니다. |
| 마케팅 이미지 확장 소재 ID | '광고 유형'이 '디맨드젠 이미지'인 경우 필수사항입니다. | string, list | 예 | 마케팅 이미지의 확장 소재 ID 목록입니다. 이 목록은 오름차순으로 생성됩니다. |
| 디맨드젠 카드 | '광고 유형'이 '디맨드젠 캐러셀'인 경우 필수입니다. | 문자열, 목록 목록 | 예 | 다음과 같은 형식으로 카드 목록을 정의합니다. (최종 URL, 최종 모바일, URL, 광고 제목, 클릭 유도 문구 텍스트, 마케팅 이미지 확장 소재 ID, 추가 마케팅 확장 소재 ID...). 예: (google.com; mobile.google.com; 광고 제목; 여기를 클릭하세요; 10020; 20020; 30020)각 마케팅 저작물에는 고유한 가로세로 비율이 있어야 합니다. 광고에 속한 카드 중 하나에 정사각형 마케팅 이미지가 있는 경우 해당 광고에 속한 모든 카드에 정사각형 마케팅 이미지가 있어야 합니다 (다른 가로세로 비율에도 적용됨). |
| 컴패니언 배너 애셋 ID | 아니요 | string, list | 예 | 컴패니언 배너의 애셋 ID 목록입니다. 이 목록은 숫자순으로 오름차순으로 생성됩니다. 동영상 실적, 디맨드젠 동영상, 인스트림, 범퍼, 건너뛸 수 없는 광고에 지원됩니다. 목록 형식 = 100; 200; |