소스 - LINE 광고

개요

LINE 광고(구 Line Ads Platform)의 리포트 데이터를 전송하는 설정 도움말 페이지입니다.

설정 항목

STEP1 기본 설정

품목명	필수	내용
LINE 광고 연결 정보	예	LINE 광고 연결 정보를 선택해 주세요. 자세한 내용은 LINE 광고 연결 정보를 참조하세요.
광고 계정 ID	예	LINE Ad Manager 관리 화면의 광고 계정 탭에서 데이터 수집 대상 광고 계정 ID를 확인하고 입력하세요.
다운로드 종류	예	성과 보고서, 마스터 데이터(광고) 중 하나를 선택해 주세요.

성과 보고서

품목명	필수	내용
보고서 종류	예	보고서 유형을 선택합니다. 각 보고서의 개요는 데이터 종류를, 컬럼 단위의 자세한 내용은 컬럼 상세를 참고하세요.
데이터 수집 기간	예	보고서 추출 대상 기간을 `yyyy-MM-dd` 형식으로 입력하세요.
커스텀 컨버젼스	No	원하는 사용자 지정 전환이 있는 경우 여기에 입력하세요. 맞춤 전환에 대한 자세한 내용은 웹사이트 전환 측정하기에서 확인할 수 있습니다.

커스텀 전환 설정 시 주의사항

기존 전송 설정에 대한 사용자 지정 변환 설정을 추가, 변경, 삭제한 경우 '자동 데이터 설정 선택'에서 자동 데이터 설정 실행을 선택해 주세요.

마스터 데이터(광고)

품목명	필수	내용
마스터 데이터 종류	예	마스터 데이터의 종류를 선택합니다. 각 데이터에 대한 개요는 데이터 종류를, 컬럼 단위의 자세한 내용은 컬럼 상세를 참고하세요.

데이터 종류

성과 보고서

종류	보고서 내용
광고 계정	광고 계정 단위의 일별 리포트를 확인할 수 있습니다.
캠페인	캠페인 단위의 일별 리포트를 확인할 수 있습니다.
광고 그룹	광고 그룹 단위의 일별 리포트를 확인할 수 있습니다.
광고	광고 단위의 일별 리포트를 얻을 수 있습니다.

마스터 데이터(광고)

종류	보고서 내용
캠페인	캠페인의 마스터 데이터를 얻을 수 있습니다.
광고 그룹	광고 그룹의 마스터 데이터를 얻을 수 있습니다.
광고	광고의 마스터 데이터를 얻을 수 있습니다.

컬럼 상세

취득 대상에서 제외된 컬럼

2019년 5월 이전 데이터에 포함된 아래 컬럼은 포함되지 않습니다.
* 볼 수 있는 인상
* CVF 신청

성과 보고서

각 열의 상세 정보

각 컬럼에 대한 자세한 내용은 LINE Ads API 문서에서 확인할 수 있습니다.

컬럼 이름 | 내용 | 값 예시 | 광고 계정 | 캠페인 | 광고 그룹 | 광고 | 광고 | 광고
| --------------------------------- | ---------------------------------------------- | --------------------------- | --------- | -------- | ------- | --- |
| day | 날짜 | 2019-12-24 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 날짜 | ✓ | 2019-12-24
| ad_account_name | 광고 계정명 | Sample Report | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Sample Report
| ad_account_id | 광고 계정 ID | A12345678900 | ✓ | ✓ | ✓ | ✓ | ✓ | | ad_account_id | 광고 계정 ID | A12345678900
| campaign_name | 캠페인명 | Sample 캠페인 3 | - | ✓ | ✓ | ✓ | ✓ | ✓ | 캠페인 이름
| campaign_id | 캠페인 ID | 1230000000000 | - | | ✓ | ✓ | ✓ | ✓ | - | ✓ | ✓ | | 캠페인 ID
| campaign_objective | キャンペーンの目的 | VISIT_MY_WEBSITE | - | ✓ | ✓ | ✓ |
| ad_group_name | 광고 그룹 이름 | 광고 그룹 : 광고 그룹 201801151037 | - | | - | ✓ | | ✓ |
| ad_group_id | 광고 그룹 ID | 2230000000000 | - | - | ✓ | ✓ | ✓ | | | ad_group_id | 광고 그룹 ID | 2230000000000 | - | - | - | ✓ | | ✓ |
| ad_name | 광고명 | 광고 : 광고 201801151037 | - | - | - | - | ✓ | |
| ad_id | 광고 ID | 3230000000000 | - | - | - | - | ✓ | | | | - - - - - - - - - - - - | | | | | | | ad_id
| title | 광고 제목 | Sample Title | - | - | - - | - | ✓ | | | | | 제목
| description | 광고 설명 | Sample Description | - | - | - - | - | ✓ |
| impressions | 노출 수 | 56 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 노출 수
| cpm | CPM(Cost Per Mille) | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | CPM(Cost Per Mille)
| clicks | 클릭수 | 1 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 클릭 수
| ctr | CTR(Click Through Rate) | 1.79 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | CTR(클릭률)
| cpc | CPC（Cost Per Click） | 24000 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | CPC(Cost Per Click)
| cv | CV（Conversion） | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | CV(전환)
| cvr | CVR（Conversion Rate） | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | CVR(전환율)
| CPA | CPA(Cost Per Acquisition) | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | CPA(Cost Per Acquisition)
| cost | 비용 | 24000 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 비용
| currency | 통화 | JPY | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 통화
reach_estimated | 도달 수(추정치) | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | reach_estimated | 도달수(추정치)
| video_starts | 동영상 시청 시작 횟수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | video_starts | 동영상 조회 수
3_second_video_views | 3초간 재생 횟수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0
| cost_per_3_second_playback | 3秒再生1回あたりのコスト | 0 | ✓ | ✓ | ✓ | ✓ |
| video_watches_at_p25 | 25% 재생 횟수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0
| video_watches_at_p50 | 50% 재생 횟수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0
| video_watches_at_p75 | 75% 재생 횟수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0
| video_watches_at_p95 | 95% 재생 횟수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0
| video_completions | 動画視聴完了回数 | 0 | ✓ | ✓ | ✓ | ✓ |
| cost_per_complete_video_view | 동영상 시청 완료 1회당 비용 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
installs_clicks | 설치 횟수(클릭) | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 설치 횟수(클릭)
| installs_views | 설치 수(조회수) | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 설치 수(뷰) | 0
installs_clicks_and_views | 설치 횟수(클릭 수 + 조회수) | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓
| installs_sk_ad_network | SKAdNetwork測定のインストール数 | 0 | ✓ | ✓ | ✓ | - |
install_rate_clicks | 설치율(클릭) | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 설치율(클릭)
| install_rate_sk_ad_network | SKAdNetwork測定のインストール率 | 0.00 | ✓ | ✓ | ✓ | - |
cost_per_install_clicks | 설치 단가(클릭) | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0
cost_per_install_clicks_and_views | 설치 단가(클릭수 + 조회수) | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
cost_per_install_sk_ad_network | SKAdNetwork 측정 설치 1회당 비용 | 0 | ✓ | ✓ | ✓ | ✓ | - |
| open | 앱 실행 수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | open | 앱 실행 횟수
open_rate | 앱 실행률 | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | open_rate | 앱 실행율
| cost_per_open | アプリ起動1回あたりのコスト | 0 | ✓ | ✓ | ✓ | ✓ |
view_home_screen | 홈 조회 수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | view_home_screen
| view_home_rate | 홈 조회 수 | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | view_home_rate | 홈 조회 수
| cost_per_view_home | 홈 조회 1회당 비용 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| category_view | 카테고리 조회 수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 카테고리 조회 수
| category_view_rate | 카테고리 조회 수 | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 카테고리 조회율
| cost_per_view_category | 카테고리 조회 건당 비용 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
| view_product | 상품 조회 수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 상품 조회 수
| product_view_rate | 상품 조회율 | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 상품 조회율
| cost_per_view_product | 상품 조회 건당 비용 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| search | 검색 수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 검색 수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 검색 수
| search_rate | 검색률 | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 검색율
| cost_per_search | 검색 건당 비용 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | cost_per_search | 검색 건당 비용
add_to_cart | 장바구니 추가 수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | add_to_cart | 카트 추가 수
add_to_cart_rate | 장바구니 추가 비율 | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
| cost_per_add_to_cart | 장바구니 추가 1회당 비용 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| purchase | 구매 수 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 구매 수
| purchase_rate | 구매율 | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 구매율
| cost_per_purchase | 購入一件あたりのコスト | 0 | ✓ | ✓ | ✓ | ✓ |
| level_achieved | レベル達成数 | 0 | ✓ | ✓ | ✓ | ✓ |
level_achieved_rate | 레벨 달성률 | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 레벨 달성률
cost_per_level_achieved | 레벨 달성 1회당 비용 | 0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓
| tutorial_complete | チュートリアル完了数 | 0 | ✓ | ✓ | ✓ | ✓ |
tutorial_percent_complete | 튜토리얼 완료율 | 0.00 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | tutorial_percent_completes
| cost_per_tutorial_completion | チュートリアル完了1回あたりのコスト | 0 | ✓ | ✓ | ✓ | ✓ |

마스터 데이터(광고)

각 열의 상세 정보

각 컬럼에 대한 자세한 내용은 LINE Ads API documentation의 각 페이지를 참고하시기 바랍니다.

캠페인

칼럼명	내용	값 예시
id	캠페인 ID	9086311996634
이름	캠페인명	웹사이트 전환: 웹 사이트 전환 202009231306
campaign_objective	캠페인 목적	WEBSITE_CONVERSION
configured_status	캠페인 현황	PAUSED
spending_limit_type	지출 한도 종류	MONTHLY
spending_limit_micro	미시적 지출 한도	10000000000
start_date	시작일시	2020-09-23T13:06:00+09:00
end_date	종료일시	1970-01-01T00:00:00:00Z
active_cbo	캠페인 예산 최적화	False
bid_strategy	입찰 전략	SET_MAX
daily_budget_micro	예산 최적화를 위한 일별 예산	1200000000000000
delivery_status	광고 송출 현황	PAUSED
delivery_status_reasons	광고 게재 상태의 이유	[{'code': 'CAMPAIGN_PAUSED'}]
created_date	작성일시	2020-09-23T13:06:19+09:00
modified_date	업데이트 날짜	2021-04-14T08:20:33+09:00
removed_date	삭제일시	2021-12-22T19:39:03+09:00

광고 그룹

칼럼명	내용	값 예시
id	광고 그룹 ID	8390071699113
campaign_id	광고 그룹을 부모로 하는 캠페인 ID	3149071698613
이름	광고 그룹명	광고 그룹: 광고 그룹 201912201044
media_app	광고그룹 앱 매체	{"id": 100, "name": "hoge", ... , "removedDate": "2021-12-22T19:39:03+09:00"}
configured_status	광고 그룹 상태	ACTIVE
ad_group_learning	광고 그룹 학습 정보	{'learningStatus': 'LEARNING', 'learningStatusCode': 'LEARNING', 'learningStatusCode': 'learning'. 110, 'lastLearningStartTs': '마지막학습시작' 1617843000, 'lastLearningEndTs': 1617843000. 1577589600, 'targetReachRatio': 1577589600. 0.325, 'hasLearningCompletionHistory': 0.325. True}
bid_type	입찰 유형	CPC
bid_amount_micro	마이크로 입찰 금액	200000000
bid_strategy	입찰 전략	SET_MAX
daily_budget_micro	예산 최적화를 위한 일별 예산	500000000
auto_bid_type	자동입찰의 종류	CLICK
auto_bid_conversion_id	사용자 지정 전환 ID
first_auto_bid_conversion_id	광고 그룹으로 설정된 첫 번째 맞춤 전환
타겟팅	광고 그룹 대상	{'country': 'JP', 'ssps': ['1', '2']'includeAdvancedTargetings': 'includeAdvancedTargetings'. [{'interests': ['4']}]}
dpa_destination_type	DPA 대상의 종류	APP_STORE_URL
dpa_destination_url	DPA 대상 URL
rnf_start_date	리치 시작 날짜 및 시간	2021-11-28T04:28:14+09:00
rnf_end_date	리치 종료일시	2021-11-28T04:28:14+09:00
rnf_frequency	도달 빈도	2
in_stream_video_included	인스트림 광고 유무	False
delivery_status	광고 송출 현황	NOT_DELIVERING
delivery_status_reasons	광고 게재 상태의 이유	[{'code': 'CAMPAIGN_ENDED'}, {'code': 'CAMPAIGN_PAUSED'}, {'code': 'ACTIVE_ad_group_learning'}]
created_date	작성일시	2019-12-20T10:45:30+09:00
modified_date	업데이트 날짜	2021-04-12T15:33:35+09:00
removed_date	삭제일시	2021-04-12T15:33:35+09:00

칼럼명	내용	값 예시
id	광고 ID	6165682099767
ad_account_id	광고를 부모로 하는 광고 계정 ID	A41527163126
ad_group_id	광고를 부모로 하는 광고 그룹 ID	8390071699113
이름	광고명	광고: 광고 201912201045
creative	광고 크리에이티브	{'id': 5165682099767, 'creativeFormat': 5165682099767. 'IMAGE', 'title': 'image', 'title' 'TROCCO', 'description': 'description'. '데이터 통합 완전 자동화 서비스'},}
configured_status	광고 상태	ACTIVE
imp_track_url	노출 추적 URL
view_track_url	뷰스루 전환 추적 URL 보기
small_delivery	CreativeFormat을 이용한 광고	false
delivery_status	광고 송출 현황	NOT_DELIVERING
delivery_status_reasons	광고 게재 상태의 이유	[{'code': 'CAMPAIGN_ENDED'}, {'code': 'CAMPAIGN_PAUSED'}, {'code': 'ACTIVE_ad_group_learning'}]
created_date	작성일시	2021-04-08T16:28:07+09:00
modified_date	업데이트 날짜	2021-04-08T16:28:07+09:00
removed_date	삭제일시	2021-04-08T16:28:07+09:00