Facebook Ads 보고서 변환

이 문서에서는 Facebook Ads에서 BigQuery로 전송을 실행할 때 Facebook Ads 보고서가 변환되는 방식을 설명합니다.

Facebook Ads 보고서의 테이블 매핑

Facebook Ads 보고서를 BigQuery로 전송하면 보고서가 다음과 같은 BigQuery 테이블 및 뷰로 변환됩니다.

AdAccounts 보고서

Meta API 필드 이름 매핑된 BigQuery 필드 이름 유형 설명
id ID [KEY] 문자열 광고 계정의 ID입니다.
대상 문자열 광고 계정을 가져오는 데 사용되는 타겟입니다. 이 값은 모든 광고 계정을 가져오기 위해 `null`입니다.
account_id AccountId 문자열 Facebook에서 직접 볼 때 광고 계정의 ID입니다.
account_status AccountStatus 정수 계정 상태입니다. 1 = 활성, 2 = 사용 중지됨, 3 = 미결제, 7 = 검토 대기 중, 9 = 유예 기간, 101 = 일시적으로 사용 불가, 100 = 폐쇄 대기 중
age 연령 Double 광고 계정이 개설된 기간(일)입니다.
amount_spent AmountSpent 정수 계정에서 현재까지 지출한 총금액입니다. 이 값은 재설정할 수 있습니다.
balance 잔고 정수 미결제 청구 금액입니다.
business_city BusinessCity 문자열 비즈니스 주소의 도시입니다.
business_country_code BusinessCountryCode 문자열 비즈니스 주소의 국가 코드입니다.
business_name BusinessName 문자열 계정의 비즈니스 이름입니다.
business_state BusinessState 문자열 비즈니스 주소의 주 약어입니다.
business_street BusinessStreet 문자열 계정의 비즈니스 상세 주소의 첫 번째 줄입니다.
business_street2 BusinessStreet2 문자열 계정의 비즈니스 상세 주소의 두 번째 줄입니다.
business_zip BusinessZip 문자열 비즈니스 주소의 우편번호입니다.
capabilities 기능 문자열 이 광고 계정에 허용된 기능입니다.
created_time CreatedTime 날짜/시간 계정이 생성된 시간입니다.
currency 통화 문자열 계정 설정의 해당 값을 기반으로 계정에 사용되는 통화입니다.
min_campaign_group_spend_cap MinCampaignGroupSpendCap 문자열 최소 캠페인 그룹 지출 한도입니다.
name 이름 문자열 계정 이름입니다. 많은 계정의 이름이 지정되지 않으므로 이 필드는 비어 있을 수 있습니다.
offsite_pixels_tos_accepted OffsitePixelsTosAccepted 문자열 오프사이트 픽셀 서비스 약관 계약이 서명되었는지 여부를 나타냅니다.
owner OwnerId 문자열 광고 계정 소유자의 Facebook ID입니다.
spend_cap SpendCap 정수 이 계정에서 지출할 수 있는 최대 금액으로, 이 금액을 초과하면 캠페인이 일시중지됩니다. 값이 0이면 지출 한도가 없음을 의미합니다.
timezone_id TimezoneId 문자열 시간대의 ID입니다.
timezone_name TimezoneName 문자열 시간대 이름입니다.
timezone_offset_hours_utc TimezoneOffsetHoursUTC Double UTC와의 시간대 차이입니다.

AdInsights 보고서

Meta API 필드 이름 매핑된 BigQuery 필드 이름 유형 설명
대상 문자열 통계를 가져올 계정의 ID입니다.
date_start DateStart 날짜 통계를 가져올 시작 날짜입니다. Facebook UI에서는 '보고서 시작' 필드입니다.
date_stop DateEnd 날짜 통계를 가져올 종료일입니다. Facebook UI에서는 '보고서 종료' 필드입니다.
TimeIncrement 문자열 데이터 집계 일수입니다. 이 값은 1로 설정됩니다.
수준 문자열 결과를 나타낼 수준입니다. 이 값은 'ad'로 설정됩니다.
account_currency AccountCurrency 문자열 광고 계정에서 사용되는 통화입니다.
action_attribution_windows ActionAttributionWindows 문자열 행동의 기여도 분석 기간을 결정하는 쉼표로 구분된 목록입니다. 예를 들어 28d_click은 사용자가 광고를 클릭한 후 28일 동안 발생한 모든 액션을 API가 반환한다는 의미입니다. 이 옵션은 [1d_view,28d_click]으로 설정됩니다.
account_id AdAccountId 문자열 보고서 행과 연결된 광고 계정의 ID입니다.
account_name AdAccountName 문자열 보고서 행과 연결된 광고 계정의 이름입니다.
campaign_id CampaignId 문자열 보고서 행과 연결된 캠페인의 ID입니다.
campaign_name CampaignName 문자열 보고서 행과 연결된 캠페인의 이름입니다.
adset_id AdSetId 문자열 보고서 행과 연결된 광고 세트의 ID입니다.
adset_name AdSetName 문자열 보고서 행과 연결된 광고 세트의 이름입니다.
ad_id AdId 문자열 보고서 행과 연결된 광고의 ID입니다.
ad_name AdName 문자열 보고서 행과 연결된 광고의 이름입니다.
buying_type BuyingType 문자열 캠페인에서 타겟 광고 비용을 지불하는 방법입니다.
clicks 클릭수 Long 광고의 총 클릭수입니다. 홍보하는 항목에 따라 페이지 좋아요, 이벤트 응답 또는 앱 설치가 포함될 수 있습니다. Facebook UI에서는 '클릭수 (전체)' 필드입니다.
conversion_rate_ranking ConversionRateRanking 문자열 전환율 순위입니다.
cost_per_estimated_ad_recallers CostPerEstimatedAdRecallers 십진수 2일 이내에 질문을 받으면 광고를 본 것을 기억할 것으로 예상되는 추가 사용자 1인당 평균 비용입니다.
cost_per_inline_link_click CostPerInlineLinkClick 십진수 광고의 링크에 대한 평균 클릭당비용입니다.
cost_per_inline_post_engagement CostPerInlinePostEngagement 십진수 게시물의 참여당 평균 비용입니다.
cost_per_unique_click CostPerUniqueClick 십진수 이러한 광고의 순 클릭당 평균 비용으로, 지출액을 발생한 순 클릭수로 나누어 계산합니다.
cost_per_unique_inline_link_click CostPerUniqueInlineLinkClick 십진수 각 고유 인라인 링크 클릭에 지불한 평균 비용입니다.
cpc CPC 십진수 이러한 광고의 평균 클릭당비용으로, 지출액을 발생한 클릭수로 나누어 계산합니다.
cpm CPM 십진수 광고가 1,000회 노출되도록 지불한 평균 비용입니다.
cpp CPP 십진수 광고가 1,000명의 순 사용자에게 게재되는 데 지불한 평균 비용입니다.
ctr 클릭률 Double 발생한 클릭수를 노출수로 나눈 값입니다. Facebook UI에서는 CTR (전체) % 필드입니다.
estimated_ad_recall_rate EstimatedAdRecallRate Double 광고를 기억하는 것으로 추정되는 사용자 수를 광고가 도달한 사용자 수로 나눈 값입니다.
estimated_ad_recallers EstimatedAdRecallers Double 2일 이내에 질문을 받으면 광고를 본 것을 기억할 것으로 예상되는 추가 사용자 수입니다.
frequency 빈도 Double 각 사용자에게 광고가 게재된 평균 횟수입니다.
impressions 노출수 Long 광고가 게재된 횟수입니다. 모바일 앱에서는 광고가 처음 조회될 때 게재된 것으로 집계됩니다. 다른 모든 Facebook 인터페이스에서는 광고가 사용자의 뉴스 피드에 처음 게재될 때 또는 오른쪽 열에 게재될 때마다 게재됩니다.
inline_link_clicks InlineLinkClicks Long 광고의 링크를 클릭한 총횟수입니다.
inline_link_click_ctr InlineLinkClicksCounter Double 링크로 연결되는 인라인 클릭의 클릭률입니다.
inline_post_engagement InlinePostEngagement Long 게시물의 총 참여수입니다.
instant_experience_clicks_to_open InstantExperienceClicksToOpen Long META API의 instant_experience_clicks_to_open 필드에 해당합니다.
instant_experience_clicks_to_start InstantExperienceClicksToStart Long META API의 instant_experience_clicks_to_start 필드에 해당합니다.
instant_experience_outbound_clicks InstantExperienceOutboundClicks Long META API의 instant_experience_outbound_clicks 필드에 해당합니다.
objective 목표 문자열 캠페인에 선택한 목표입니다. 목표는 광고로 달성하고자 하는 목표를 반영합니다.
quality_ranking QualityRanking 문자열 품질 순위입니다.
reach 도달범위 Long 광고가 게재된 사용자 수입니다.
spend 지출 십진수 지금까지 지출한 총금액입니다.
UniqueClicks Long 광고를 클릭한 순 사용자의 총수입니다. 예를 들어 3명이 동일한 광고를 5번 클릭하면 순 클릭수는 3회로 집계됩니다.
UniqueCTR Double 광고를 클릭한 사용자 수를 도달한 사용자 수로 나눈 값입니다. 예를 들어 순 클릭수가 20회이고 광고가 1,000명의 순 사용자에게 게재된 경우 순 클릭률은 2%가 됩니다.
inline_link_clicks UniqueInlineLinkClicks Long 광고가 획득한 순 인라인 링크 클릭수입니다. Facebook UI에서는 '링크에 대한 고유 클릭수' 필드입니다.
UniqueInlineLinkClickCounter Double 링크로 연결되는 고유 인라인 클릭의 클릭률입니다.
UniqueLinkClicksCounter Double 링크 클릭의 고유 클릭률입니다. Facebook 외부로 연결되는 광고의 링크를 클릭한 사용자 수를 도달한 사용자 수로 나눈 값입니다. 예를 들어 링크에 대한 순 클릭수가 20회이고 광고가 1,000명의 순 사용자에게 게재되었다면 순 클릭률은 2%가 됩니다.
체크인 Int 광고에 기여한 체크인 수입니다.
EventResponses Int 광고에 기여한 이벤트 응답 수입니다.
inline_link_clicks LinkClicks Int 광고에 기여한 링크 클릭수입니다.
OfferSaves Int 광고에 기여한 수신 제안 수입니다.
outbound_clicks OutboundClicks Int 광고에 기여한 아웃바운드 클릭수입니다.
PageEngagements Int 광고로 인해 발생한 페이지 참여도 수입니다.
PageLikes Int 광고로 인해 발생한 페이지 좋아요 수입니다.
PageMentions Int 광고에 기여한 페이지 멘션 수입니다.
PagePhotoViews Int 광고로 인해 발생한 사진 조회수입니다.
PostComments Int 광고에 기여한 게시물 댓글 수입니다.
PostEngagements Int 광고로 인해 발생한 게시물 참여 수입니다.
PostShares Int 광고로 인해 발생한 게시물 공유 수입니다.
PostReactions Int 광고에 기여한 게시물 반응 수입니다.
PageTabViews Int 광고에 기여한 탭 조회수입니다.
리전 문자열 사용자가 광고를 조회한 지역입니다. 분류 필드입니다.
Video3SecondViews Int 광고에 기여한 동영상 조회수입니다. 3초 이상 또는 동영상 전체 (동영상이 3초 미만인 경우)가 재생되면 조회수로 집계됩니다.

AdInsightsActions 보고서

Meta API 필드 이름 매핑된 BigQuery 필드 이름 유형 설명
대상 문자열 통계를 가져올 계정의 ID입니다.
date_start DateStart 날짜 통계를 가져올 시작일입니다. Facebook UI에서는 '보고서 시작' 필드입니다.
date_stop DateEnd 날짜 통계를 가져올 종료일입니다. Facebook UI에서는 '보고서 종료' 필드입니다.
TimeIncrement 문자열 데이터 집계 일수입니다. 이 값은 1로 설정됩니다.
수준 문자열 결과를 나타낼 수준입니다. 값은 ad로 설정됩니다.
action_attribution_windows ActionAttributionWindows 문자열 작업의 기여 분석 기간을 결정하는 쉼표로 구분된 목록입니다. 예를 들어 28d_click은 사용자가 광고를 클릭한 후 28일 동안 발생한 모든 액션을 API가 반환한다는 의미입니다. 기본 옵션은 [1d_view,7d_click]을 의미합니다. 가능한 값은 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click, default입니다.
ActionCollection 문자열 가져올 작업 컬렉션입니다. 값은 Actions로 설정됩니다.
account_id AdAccountId 문자열 보고서 행과 연결된 광고 계정의 ID입니다.
account_name AdAccountName 문자열 보고서 행과 연결된 광고 계정의 이름입니다.
campaign_id CampaignId 문자열 보고서 행과 연결된 캠페인의 ID입니다.
campaign_name CampaignName 문자열 보고서 행과 연결된 캠페인의 이름입니다.
adset_id AdSetId 문자열 보고서 행과 연결된 광고 세트의 ID입니다.
adset_name AdSetName 문자열 보고서 행과 연결된 광고 세트의 이름입니다.
ad_id AdId 문자열 보고서 행과 연결된 광고의 ID입니다.
ad_name AdName 문자열 보고서 행과 연결된 광고의 이름입니다.
actions.value ActionValue 정수 기본 기여 분석 기간의 측정항목 값입니다.
actions.1d_click Action1dClick 문자열 광고를 클릭한 후 1일이 지난 시점의 기여 분석 기간의 측정항목 값입니다.
actions.1d_view Action1dView 문자열 광고를 본 후 1일의 기여 분석 기간의 측정항목 값입니다.
actions.7d_click Action7dClick 문자열 광고 클릭 후 7일의 기여 분석 기간의 측정항목 값입니다.
actions.7d_view Action7dView 문자열 광고를 본 후 7일의 기여 분석 기간의 측정항목 값입니다.
actions.28d_click Action28dClick 문자열 광고 클릭 후 28일의 기여 분석 기간의 측정항목 값입니다.
actions.28d_view Action28dView 문자열 광고를 본 후 28일의 기여 산정 기간의 측정항목 값입니다.
actions.dda ActionDDA 문자열 데이터 기반 모델로 구동되는 기여 분석 기간의 측정항목 값입니다.