개요
검색 광고에서 데이터를 전송하는 설정에 대한 도움말 페이지입니다.
Yahoo! 광고 API를 이용하여 데이터를 수집합니다.
제약조건
- 전송 용량 제한 있음
설정 항목
STEP1 기본 설정
| 품목명 | 필수 | 기본값 | 내용 |
|---|---|---|---|
| Yahoo! 광고 API 연결 정보 | 예 | ----------------------------------------------------------------------------------------------. | 미리 등록되어 있는 Yahoo! 광고 API 연결 정보 중 이번 전송 설정에 필요한 권한을 가진 것을 선택합니다. |
| 기본 계정 ID | 예 | ----------------------------------------------------------------------------------------------. | 연결 정보의 Yahoo! JAPAN 비즈니스 ID가 직접 권한이 있는 계정(MCC 계정, 광고 계정)을 선택합니다. 선택한 계정과 그 하위의 모든 계정에 대한 조작이 가능합니다. |
| 계정 ID | 예 | ----------------------------------------------------------------------------------------------. | 선택한 기본 계정 ID로 조작 가능한 데이터 수집 대상 계정 ID를 입력합니다. 계정 ID는 검색광고 관리 화면에서 확인할 수 있습니다. |
| 서비스 | 예 | ReportDefinitionService |
데이터 수집 대상 서비스를 아래에서 선택합니다.ReportDefinitionServiceCampaignExportService |
ReportDefinitionService를 선택한 경우
| 품목명 | 필수 | 기본값 | 내용 |
|---|---|---|---|
| 보고서 종류 | 예 | ----------------------------------------------------------------------------------------------. | 보고서 종류를 선택합니다. 각 보고서마다 얻을 수 있는 항목이 다릅니다. |
| 데이터 수집 기간 | 예 | ----------------------------------------------------------------------------------------------. | 검색 범위의 시작일, 종료일을 입력합니다.YYYYYMMDD 형식으로 입력하세요. (예:) 20201119) |
| 컬럼 | No | ----------------------------------------------------------------------------------------------. | 조회할 컬럼(필드)을 입력합니다. 자세한 내용은 아래 ReportDefinitionService에서 얻을 수 있는 필드를 참고하세요. |
| 필터 설정 | No | ----------------------------------------------------------------------------------------------. | 노출이 1 이상인 레코드만 전송할지 여부를 선택할 수 있습니다. |
보고서 템플릿 불러오기
보고서 유형에서 보고서 템플릿이 있는 보고서를 선택한 경우, 보고서 템플릿 불러오기를 클릭하면 해당 보고서 유형의 주요 필드를 일괄적으로 설정할 수 있습니다.
획득할 수 있는 필드
ReportDefinitionService에서 조회할 수 있는 필드들
Yahoo! 마케팅 솔루션 공식 자료에 나와 있는 내용입니다.
조회하고자 하는 보고서 유형의 csv 파일을 열고, 필드명/Field Name 열을 참조하세요.
동작 구분 / Behavior Type
공식 자료의 csv 파일에서 동작 구분/행동 유형 열은 Yahoo! 광고 API에서 검색어 필터링의 동작 유형을 나타냅니다.
ATTRIBUTE: 보고서의 속성을 나타냅니다.SEGMENT: 검색의 축을 나타냅니다.METRIC: 세분화를 통해 얻은 수치를 나타냅니다.
임프레션이 없는, 동작구획 구분이
SEGMENT인 필드
동작 구분이 SEGMENT인 필드는 노출 수가 0인 경우, 필터 설정이 비활성화되어 있어도 검색되지 않습니다.
동시 취득할 수 없는 필드
API 사양상 동시에 조회할 수 없는 필드 조합이 존재합니다.
공식 자료의 csv 파일에서 조합 불가 필드/Not compatible fields 열을 참조하세요.
CampaignExportService에서 가져오는 필드들
서비스에서CampaignExportService를 선택하면 아래 필드가 자동으로 로드됩니다.
전송 시 컬럼 이름을 변경하고 싶거나 불필요한 필드가 있는 경우, 전송 설정 STEP2의 컬럼 정의에서 편집해 주세요.
| 필드명 | 필드명 개요(일본어) | 필드명 개요(영어) |
|---|---|---|
CAMPAIGN_NAME |
캠페인명 | 캠페인명 |
AD_GROUP_NAME |
광고 그룹명 | 광고 그룹명 |
ENTITY_NAME |
구성 요소의 종류 | 구성요소 유형 |
ENTITY_STATUS |
배송 설정 | 디스플레이 설정 |
DISPLAY_STATUS |
배송 현황 | 디스플레이 상태 |
BULK_MATCH_TYPE |
매치 타입 | Match Type |
TERM |
키워드 | 키워드 |
MANU_OPT_BID |
입찰 가격 | Bid |
AD_NAME |
광고명 | 광고명 |
BULK_AD_TYPE |
광고 유형 | 광고 유형 |
HEADLINE_1 |
제목1 | Title1 |
HEADLINE_2 |
제목2 | Title2 |
HEADLINE_3 |
타이틀 3 | Title3 |
DESCRIPTION1 |
설명문1 | 설명1 |
DESCRIPTION2 |
설명문2 | 설명2 |
DISPLAY_URL |
표시 URL | URL 표시 |
PATH_1 |
디렉토리1 | 디렉토리1 |
PATH_2 |
디렉토리2 | 디렉토리2 |
ADVANCED_URL |
최종 링크 URL | 최종 URL |
ADVANCED_MOBILE_URL |
스마트폰용 URL | 스마트폰 최종 URL |
TRACKING_URL |
추적 URL | 추적 URL |
CUSTOM_PARAMETER |
사용자 지정 매개변수 | 사용자 지정 매개 변수 |
BUDGET_AMOUNT |
캠페인 예산(일당) | 캠페인 일일 예산 |
START_YMD |
캠페인 시작일 | 캠페인 시작일 |
END_YMD |
캠페인 종료일 | 캠페인 종료일 |
PLATFORM_BID_MULTIPLIER |
스마트폰 입찰가격 조정률(%) | 스마트폰 입찰가 조정 (%) |
BULK_DEVICE_PREFERENCE |
우선순위 장치 | 초점 장치 |
CAMPAIGN_TYPE |
캠페인 유형 | 캠페인 유형 |
AD_ROTATION_MODE |
효과 높은 광고 우선 표시 | 성과가 좋은 광고를 자주 집행 |
LABELS |
라벨 | 라벨 |
CAMPAIGN_ID |
캠페인 ID | 캠페인 ID |
AD_GROUP_ID |
광고 그룹 ID | 광고 그룹 ID |
CRITERION_ID |
키워드 ID | 키워드 ID |
AD_ID |
광고 ID | Ad ID |
AD_TRACK_ID |
추적용 광고 ID | Ad Track ID |
RAS_HEADLINE_1 |
타이틀1(자산) | Title 1 (자산) |
RAS_HEADLINE_POSITION1 |
제목1의 표시 위치 | Title 1 Position |
RAS_HEADLINE_2 |
타이틀 2 (자산) | Title 2 (자산) |
RAS_HEADLINE_POSITION2 |
타이틀 2의 표시 위치 | Title 2 Position |
RAS_HEADLINE_3 |
타이틀 3 (자산) | Title 3 (자산) |
RAS_HEADLINE_POSITION3 |
타이틀 3의 표시 위치 | Title 3 Position |
RAS_HEADLINE_4 |
타이틀 4 (자산) | Title 4 (자산) |
RAS_HEADLINE_POSITION4 |
타이틀 4의 표시 위치 | Title 4 Position |
RAS_HEADLINE_5 |
타이틀 5 (자산) | Title 5 (자산) |
RAS_HEADLINE_POSITION5 |
제목 5의 표시 위치 | Title 5 Position |
RAS_HEADLINE_6 |
타이틀 6 (자산) | Title 6 (자산) |
RAS_HEADLINE_POSITION6 |
제목 6의 표시 위치 | Title 6 Position |
RAS_HEADLINE_7 |
타이틀 7 (자산) | Title 7 (자산) |
RAS_HEADLINE_POSITION7 |
제목 7의 표시 위치 | Title 7 Position |
RAS_HEADLINE_8 |
타이틀 8 (자산) | Title 8 (자산) |
RAS_HEADLINE_POSITION8 |
제목 8의 표시 위치 | Title 8 Position |
RAS_HEADLINE_9 |
타이틀 9 (자산) | Title 9 (자산) |
RAS_HEADLINE_POSITION9 |
타이틀 9의 표시 위치 | Title 9 Position |
RAS_HEADLINE_10 |
타이틀 10 (자산) | Title 10 (자산) |
RAS_HEADLINE_POSITION10 |
타이틀 10의 표시 위치 | Title 10 Position |
RAS_HEADLINE_11 |
타이틀 11 (자산) | Title 11 (자산) |
RAS_HEADLINE_POSITION11 |
제목 11의 표시 위치 | Title 11 Position |
RAS_HEADLINE_12 |
타이틀 12 (자산) | Title 12 (자산) |
RAS_HEADLINE_POSITION12 |
제목 12의 표시 위치 | Title 12 Position |
RAS_HEADLINE_13 |
타이틀 13 (자산) | Title 13 (자산) |
RAS_HEADLINE_POSITION13 |
제목 13의 표시 위치 | Title 13 Position |
RAS_HEADLINE_14 |
타이틀 14 (자산) | Title 14 (자산) |
RAS_HEADLINE_POSITION14 |
제목 14의 표시 위치 | Title 14 Position |
RAS_HEADLINE_15 |
타이틀 15 (자산) | Title 15 (자산) |
RAS_HEADLINE_POSITION15 |
제목 15의 표시 위치 | Title 15 Position |
RAS_DESCRIPTION1 |
설명문1(자산) | 설명 1 (자산) |
RAS_DESCRIPTION_POSITION1 |
설명문1 표시 위치 | 설명 1 포지션 |
RAS_DESCRIPTION2 |
설명문2(자산) | 설명 2 (자산) |
RAS_DESCRIPTION_POSITION2 |
설명문 2의 표시 위치 | 설명 2 포지션 |
RAS_DESCRIPTION3 |
설명문 3 (자산) | 설명 3 (자산) |
RAS_DESCRIPTION_POSITION3 |
설명문 3의 표시 위치 | 설명 3 포지션 |
RAS_DESCRIPTION4 |
설명문4 (자산) | 설명 4 (자산) |
RAS_DESCRIPTION_POSITION4 |
설명문 4의 표시 위치 | 설명 4 Position |
ASSET_ID |
광고 표시 옵션 ID | 광고 표시 옵션 ID |
ASSET_TYPE |
광고 표시 옵션의 종류 | 광고 표시 옵션 유형 |
ASSET_ADVANCED_URL |
퀵링크 최종 링크 URL | QuickLink 최종 URL |
ASSET_ADVANCED_MOBILE_URL |
퀵링크 스마트폰용 URL | QuickLink 스마트폰 최종 URL |
ASSET_TRACKING_URL |
빠른 링크 추적 URL | QuickLink 추적 URL |
ASSET_CUSTOM_PARAMETER |
퀵링크 커스텀 파라미터 | QuickLink 커스텀 파라미터 |
ASSET_LINK_TEXT |
빠른 링크 텍스트 | QuickLink 텍스트 |
ASSET_DESCRIPTION1 |
퀵링크 설명문1 | QuickLink 설명 1 |
ASSET_DESCRIPTION2 |
퀵링크 설명문2 | QuickLink 설명 2 |
ASSET_CALLOUT_TEXT |
보충용 텍스트 | 콜아웃 텍스트 |
ASSET_HEADER |
보충 카테고리 | 카테고리 |
ASSET_VALUE_1 |
보충 내용1 | Text 1 |
ASSET_VALUE_2 |
보충 내용2 | Text 2 |
ASSET_VALUE_3 |
보충 내용3 | Text 3 |
ASSET_VALUE_4 |
보충 내용4 | Text 4 |
ASSET_VALUE_5 |
보충 내용5 | Text 5 |
ASSET_VALUE_6 |
보충 내용6 | Text 6 |
ASSET_VALUE_7 |
보충 내용7 | Text 7 |
ASSET_VALUE_8 |
보충 내용8 | Text 8 |
ASSET_VALUE_9 |
보충 내용9 | Text 9 |
ASSET_VALUE_10 |
보충 내용10 | Text 10 |
ASSET_PHONE_NUMBER |
전화번호 | 전화번호 |
CAMPAIGN_TRACK_ID |
추적용 캠페인 ID | 캠페인 트랙 ID |
AD_GROUP_TRACK_ID |
추적용 광고 그룹 ID | 광고 그룹 트랙 ID |
CRITERION_TRACK_ID |
추적용 키워드 ID | 키워드 트랙 ID |
ASSET_IMAGE_NAME |
||
ASSET_ASPECT_RATIO |