이 페이지의 일부 또는 모든 정보는 S3NS의 Cloud de Confiance에 적용되지 않을 수 있습니다. 자세한 내용은
Google Cloud와의 차이점을 참조하세요.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
이 문서에서는 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 |
클릭수 |
긴 형식 |
광고의 총 클릭수입니다. 홍보하는 항목에 따라 페이지 좋아요, 이벤트 응답 또는 앱 설치가 포함될 수 있습니다. Facebook UI에서는 클릭수(전체) 필드입니다. |
conversion_rate_ranking |
ConversionRateRanking |
문자열 |
전환율 순위입니다. |
cost_per_estimated_ad_recallers |
CostPerEstimatedAdRecallers |
십진수 |
추가 사용자 1인당 평균 비용으로, 2일 이내에 질문을 받으면 광고를 본 것을 기억할 것으로 예상되는 것입니다. |
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에서는 클릭률(전체) % 필드입니다. |
estimated_ad_recall_rate |
EstimatedAdRecallRate |
Double |
광고를 기억하는 것으로 추정되는 사용자 수를 광고 도달범위로 나눈 값입니다. |
estimated_ad_recallers |
EstimatedAdRecallers |
Double |
2일 이내에 질문을 받으면 광고를 본 것을 기억할 것으로 예상되는 추가 사용자 수입니다. |
frequency |
빈도 |
Double |
각 사용자에게 광고가 게재된 평균 횟수입니다. |
impressions |
노출수 |
긴 형식 |
광고가 게재된 횟수입니다. 모바일 앱에서는 광고가 처음 조회될 때 게재된 것으로 집계됩니다. 다른 모든 Facebook 인터페이스에서는 광고가 사용자의 뉴스 피드에 처음 게재될 때 또는 오른쪽 열에 게재될 때마다 표시됩니다. |
inline_link_clicks |
InlineLinkClicks |
긴 형식 |
광고의 링크에 대한 총 클릭수입니다. |
inline_link_click_ctr |
InlineLinkClicksCounter |
Double |
링크로 연결되는 인라인 클릭의 클릭률입니다. |
inline_post_engagement |
InlinePostEngagement |
긴 형식 |
게시물의 총 참여수입니다. |
instant_experience_clicks_to_open |
InstantExperienceClicksToOpen |
긴 형식 |
META API의 instant_experience_clicks_to_open 필드에 해당합니다. |
instant_experience_clicks_to_start |
InstantExperienceClicksToStart |
긴 형식 |
META API의 instant_experience_clicks_to_start 필드에 해당합니다. |
instant_experience_outbound_clicks |
InstantExperienceOutboundClicks |
긴 형식 |
META API의 instant_experience_outbound_clicks 필드에 해당합니다. |
objective |
목표 |
문자열 |
캠페인에 대해 선택한 목표입니다. 목표는 광고를 통해 달성하려는 목표를 반영합니다. |
quality_ranking |
QualityRanking |
문자열 |
품질 순위입니다. |
reach |
도달범위 |
긴 형식 |
광고가 게재된 사용자 수입니다. |
spend |
지출 |
십진수 |
지금까지 지출한 총금액입니다. |
|
UniqueClicks |
긴 형식 |
광고를 클릭한 총 순 사용자 수입니다. 예를 들어 3명이 동일한 광고를 5번 클릭하면 순 클릭수는 3회로 집계됩니다. |
|
UniqueCTR |
Double |
광고를 클릭한 사용자 수를 도달한 사용자 수로 나눈 값입니다. 예를 들어 순 클릭수가 20회이고 광고가 1,000명의 순 사용자에게 게재된 경우 순 클릭률은 2%가 됩니다. |
inline_link_clicks |
UniqueInlineLinkClicks |
긴 형식 |
광고가 획득한 순 인라인 링크 클릭수입니다. 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초 미만인 경우) 전체가 재생된 경우 조회수로 집계됩니다. |
| 일반적인 분류 |
|
연령 |
문자열 |
이 행의 측정항목에 대한 연령대입니다. |
|
성별 |
문자열 |
이 행의 측정항목에 대한 성별입니다. |
|
국가 |
문자열 |
이 행의 측정항목에 대한 국가입니다. |
|
지역 |
문자열 |
사용자가 광고를 조회한 리전입니다. |
|
FrequencyValue |
문자열 |
도달범위 및 게재빈도 캠페인의 광고가 각 사용자에게 게재된 횟수입니다. |
|
HStatsByAdvertiserTZ |
문자열 |
광고주의 통계가 집계된 기간입니다. |
|
HStatsByAudienceTZ |
문자열 |
잠재고객의 통계가 수집된 기간입니다. |
|
ImpressionDevice |
문자열 |
광고를 보는 데 사용된 기기입니다. |
|
PlatformPosition |
문자열 |
플랫폼에서의 위치입니다. |
|
PublisherPlatform |
문자열 |
광고가 게시된 플랫폼입니다. |
|
ProductId |
문자열 |
광고에 광고된 제품 ID입니다. |
AdInsightsActions 보고서
ACTION_COLLECTION은 광고에 대해 사용자가 취한 액션 유형을 나타냅니다. 액션 컬렉션의 전체 목록은 액션 컬렉션을 참조하세요.
| 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 |
문자열 |
이는 전송 시 선택한 액션 컬렉션에서 가져온 값입니다. |
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 |
문자열 |
보고서 행과 연결된 광고의 이름입니다. |
ACTION_COLLECTION.value |
ActionValue |
정수 |
기본 기여 산정 기간의 측정항목 값입니다.
Facebook Ads는 이 데이터 유형 매핑을 업데이트할 계획입니다. 자세한 내용은 2026년 7월 25일을 참고하세요. |
ACTION_COLLECTION.1d_click |
Action1dClick |
문자열 |
광고를 클릭한 후 1일 간의 기여 산정 기간의 측정항목 값입니다. |
ACTION_COLLECTION.1d_view |
Action1dView |
문자열 |
광고를 조회한 후 1일 간의 기여 산정 기간의 측정항목 값입니다. |
ACTION_COLLECTION.7d_click |
Action7dClick |
문자열 |
광고를 클릭한 후 7일 간의 기여 산정 기간의 측정항목 값입니다. |
ACTION_COLLECTION.7d_view |
Action7dView |
문자열 |
광고를 조회한 후 7일 간의 기여 산정 기간의 측정항목 값입니다. |
ACTION_COLLECTION.28d_click |
Action28dClick |
문자열 |
광고를 클릭한 후 28일 간의 기여 산정 기간의 측정항목 값입니다. |
ACTION_COLLECTION.28d_view |
Action28dView |
문자열 |
광고를 조회한 후 28일 간의 기여 산정 기간의 측정항목 값입니다. |
ACTION_COLLECTION.dda |
ActionDDA |
문자열 |
데이터 기반 모델로 구동되는 기여 산정 기간의 측정항목 값입니다. |
| 일반적인 분류 |
|
연령 |
문자열 |
이 행의 측정항목에 대한 연령대입니다. |
|
성별 |
문자열 |
이 행의 측정항목에 대한 성별입니다. |
|
국가 |
문자열 |
이 행의 측정항목에 대한 국가입니다. |
|
지역 |
문자열 |
사용자가 광고를 조회한 리전입니다. |
|
FrequencyValue |
문자열 |
도달범위 및 게재빈도 캠페인의 광고가 각 사용자에게 게재된 횟수입니다. |
|
HStatsByAdvertiserTZ |
문자열 |
광고주의 통계가 집계된 기간입니다. |
|
HStatsByAudienceTZ |
문자열 |
잠재고객의 통계가 수집된 기간입니다. |
|
ImpressionDevice |
문자열 |
광고를 보는 데 사용된 기기입니다. |
|
PlatformPosition |
문자열 |
플랫폼에서의 위치입니다. |
|
PublisherPlatform |
문자열 |
광고가 게시된 플랫폼입니다. |
|
ProductId |
문자열 |
광고에 광고된 제품 ID입니다. |
| 액션 분석 |
|
ActionType |
문자열 |
광고가 사용자에게 게재된 후 사용자가 광고를 클릭하지 않았더라도 광고에 대해 취한 액션의 종류입니다. |
|
ActionCanvasComponentName |
문자열 |
Canvas 광고 내 구성요소의 이름입니다. |
|
ActionCarouselCardId |
문자열 |
사용자가 광고를 볼 때 참여한 특정 캐러셀 카드의 ID입니다. |
|
ActionCarouselCardName |
문자열 |
사용자가 광고를 볼 때 참여한 특정 캐러셀 카드입니다. 카드는 광고 헤드라인으로 식별됩니다. |
|
ActionDestination |
문자열 |
사용자가 광고를 클릭한 후 연결되는 도착 페이지입니다. |
|
ActionDevice |
문자열 |
추적 중인 전환 이벤트가 발생한 기기입니다. |
|
ActionReaction |
문자열 |
광고 또는 부스트된 게시물에 대한 반응 수입니다. |
|
ActionTargetId |
문자열 |
사용자가 광고를 클릭한 후 연결되는 도착 페이지의 ID입니다. |
|
ActionVideoSound |
문자열 |
사용자가 동영상 광고를 시청할 때의 알림음 상태(켜짐/꺼짐)입니다. |
|
ActionVideoType |
문자열 |
동영상 측정항목 분석입니다. |
|
ActionConvertedProductId |
문자열 |
전환된 제품 ID - Collaborative Ads용입니다. |
AdInsightsMMM 보고서
| Meta API 필드 이름 |
매핑된 BigQuery 필드 이름 |
유형 |
설명 |
| 대상 | 문자열 | 통계를 가져올 계정의 ID입니다. |
| TimeIncrement | 문자열 | 데이터 집계 일수입니다. |
account_id | AccountId | 문자열 | 행과 연결된 광고 계정의 ID입니다. |
campaign_id | CampaignId | 문자열 | 행과 연결된 캠페인의 ID입니다. |
adset_id | AdSetId | 문자열 | 행과 연결된 광고 세트의 ID입니다. |
date_start | DateStart | 날짜 | 통계 검색 시작일입니다. |
date_stop | DateEnd | 날짜 | 통계 검색의 종료일입니다. |
impressions | 노출수 | 긴 형식 | 광고가 게재된 횟수입니다. |
spend | 지출 | 십진수 | 총 지출 금액입니다. |
country | 국가 | 문자열 | 측정항목의 국가입니다. |
region | 리전 | 문자열 | 광고가 조회된 지역입니다. |
dma | DMA | 문자열 | 측정항목의 지정 시장 지역입니다. |
device_platform | DevicePlatform | 문자열 | 사용된 기기의 플랫폼입니다. |
platform_position | PlatformPosition | 문자열 | 플랫폼에서의 위치입니다. |
publisher_platform | PublisherPlatform | 문자열 | 게시자 플랫폼입니다. |
creative_media_type | CreativeMediaType | 문자열 | 광고 소재에 사용된 미디어 유형입니다. |
Ads 보고서
| Meta API 필드 이름 |
매핑된 BigQuery 필드 이름 |
유형 |
설명 |
id | ID | 문자열 | 광고의 ID입니다. |
| 대상 | 문자열 | 광고를 가져오는 데 사용되는 타겟 필드입니다. |
name | 이름 | 문자열 | 광고의 이름입니다. |
status | AdStatus | 문자열 | 광고의 상태입니다. |
bid_info | BidInfo | 문자열 | 광고와 연결된 입찰 정보입니다. |
bid_type | BidType | 문자열 | 광고와 연결된 입찰 유형입니다. |
campaign_id | CampaignId | 문자열 | 캠페인의 ID입니다. |
adset_id | AdSetId | 문자열 | 광고 세트의 ID입니다. |
creative | AdCreativeId | 문자열 | 광고 소재의 ID입니다. |
configured_status | ConfiguredStatus | 문자열 | 광고의 구성된 상태입니다. |
created_time | CreatedTime | 날짜/시간 | 광고 생성 시간입니다. |
updated_time | UpdatedTime | 날짜/시간 | 광고의 마지막 업데이트 시간입니다. |
conversion_specs | ConversionSpecs | 문자열 | 변환 사양입니다. |
failed_delivery_checks | FailedDeliveryChecks | 문자열 | 전송 실패 확인에 관한 정보입니다. |
recommendations | 권장사항 | 문자열 | 광고에 대한 추천입니다. |
tracking_specs | TrackingSpecs | JSON | 추적 사양입니다. |
ad_active_time | AdActiveTime | 문자열 | 활성 시간 매개변수입니다. |
ad_schedule_end_time | AdScheduleEndTime | 날짜/시간 | 예약된 종료 시간입니다. |
ad_schedule_start_time | AdScheduleStartTime | 날짜/시간 | 예약된 시작 시간입니다. |
bid_amount | BidAmount | 정수 | 입찰가입니다. |
last_updated_by_app_id | LastUpdatedByAppId | 문자열 | 광고를 마지막으로 업데이트한 앱 ID입니다. |
preview_shareable_link | PreviewShareableLink | 문자열 | 공유 가능한 미리보기 링크입니다. |
source_ad_id | SourceAdId | 문자열 | 소스 광고 ID입니다. |
AdCreatives 보고서
| Meta API 필드 이름 |
매핑된 BigQuery 필드 이름 |
유형 |
설명 |
id | ID | 문자열 | 광고 소재의 ID입니다. |
| 대상 | 문자열 | 대상 필드입니다. |
name | 이름 | 문자열 | 광고 소재의 이름입니다. |
applink_treatment | ApplinkTreatment | 문자열 | 광고 소재의 딥 링크 처리 |
body | 본문 | 문자열 | 광고 블록의 본문 텍스트입니다. |
call_to_action_type | CallToActionType | 문자열 | 클릭 유도 문구의 유형입니다. |
effective_instagram_media_id | EffectiveInstagramMediaId | 문자열 | Instagram 미디어의 유효 ID입니다. |
image_hash | ImageHash | 문자열 | 연결된 이미지의 해시입니다. |
image_url | ImageUrl | 문자열 | 광고 소재 이미지의 URL입니다. |
instagram_permalink_url | InstagramPermalinkUrl | 문자열 | Instagram의 퍼머링크 URL입니다. |
instagram_user_id | InstagramUserId | 문자열 | Instagram 사용자 ID입니다. |
link_og_id | LinkOgId | 문자열 | 링크의 Open Graph ID입니다. |
link_url | LinkUrl | 문자열 | 방문 페이지 URL입니다. |
object_id | ObjectId | 문자열 | 연결된 객체 ID입니다. |
object_story_id | ObjectStoryId | 문자열 | 객체 스토리 ID입니다. |
object_type | ObjectType | 문자열 | 객체의 유형입니다. |
object_url | ObjectUrl | 문자열 | 객체의 URL입니다. |
page_id | PageId | 문자열 | 연결된 Facebook 페이지 ID입니다. |
product_set_id | ProductSetId | 문자열 | 제품 세트 ID입니다. |
run_status | RunStatus | 문자열 | 광고 소재의 실행 상태입니다. |
source_instagram_media_id | SourceInstagramMediaId | 문자열 | 소스 Instagram 미디어 ID입니다. |
template_url | TemplateUrl | 문자열 | 템플릿 URL입니다. |
thumbnail_url | ThumbnailUrl | 문자열 | 썸네일 URL입니다. |
title | 제목 | 문자열 | 광고 소재의 제목 텍스트입니다. |
url_tags | UrlTags | 문자열 | URL 태그 매개변수입니다. |
adlabels | AdLabels | 문자열 | 광고 소재와 연결된 라벨입니다. |
object_story_spec.link_data | ObjectStorySpecLinkData | JSON | 링크 데이터 사양입니다. |
object_story_spec.photo_data | ObjectStorySpecPhotoData | JSON | 사진 데이터 사양입니다. |
object_story_spec.video_data | ObjectStorySpecVideoData | JSON | 동영상 데이터 사양입니다. |
object_story_spec.text_data | ObjectStorySpecTextData | JSON | 텍스트 데이터 사양입니다. |
object_story_spec.template_data | ObjectStorySpecTemplateData | JSON | 템플릿 데이터 사양입니다. |
AdSets 보고서
| Meta API 필드 이름 |
매핑된 BigQuery 필드 이름 |
유형 |
설명 |
id | ID | 문자열 | 광고 세트의 ID입니다. |
| 대상 | 문자열 | 대상 필드입니다. |
name | 이름 | 문자열 | 광고 세트의 이름입니다. |
budget_remaining | BudgetRemaining | 정수 | 남은 예산입니다. |
campaign_id | CampaignId | 문자열 | 연결된 캠페인 ID입니다. |
status | AdSetStatus | 문자열 | 광고 세트 상태입니다. |
billing_event | BillingEvent | 문자열 | 결제 이벤트 기준입니다. |
created_time | CreatedTime | 날짜/시간 | 광고 세트 생성 시간입니다. |
daily_budget | DailyBudget | 정수 | 일일 예산 한도입니다. |
lifetime_budget | LifetimeBudget | 정수 | 전체 기간 예산 한도입니다. |
end_time | EndTime | 날짜/시간 | 예약된 종료 시간입니다. |
start_time | StartTime | 날짜/시간 | 예약된 시작 시간입니다. |
updated_time | UpdatedTime | 날짜/시간 | 광고 세트가 마지막으로 업데이트된 시간입니다. |
recommendations | 권장사항 | 문자열 | 광고 세트에 대한 추천입니다. |
targeting.genders | TargetingGenders | 문자열 | 타겟팅된 성별입니다. |
targeting.age_max | TargetingAgeMax | 정수 | 타겟팅된 최대 연령입니다. |
targeting.age_min | TargetingAgeMin | 정수 | 타겟팅된 최소 연령입니다. |
targeting.countries | TargetingCountries | 문자열 | 타겟팅된 국가입니다. |
targeting.location_types | TargetingLocationTypes | 문자열 | 타겟팅된 위치 유형입니다. |
targeting.regions | TargetingRegions | 문자열 | 타겟팅된 지역 또는 주입니다. |
targeting.cities | TargetingCities | 문자열 | 타겟 도시 |
targeting.zips | TargetingZips | 문자열 | 타겟팅된 우편번호입니다. |
targeting.custom_locations | TargetingCustomLocations | 문자열 | 타겟팅된 맞춤 위치 |
targeting.geo_markets | TargetingGeoMarkets | 문자열 | 타겟팅된 지리적 시장입니다. |
targeting.interests | TargetingInterests | 문자열 | 타겟팅된 개인 관심분야 |
targeting.behaviors | TargetingBehaviors | 문자열 | 타겟팅된 사용자 행동 |
targeting.device_platforms | TargetingDevicePlatforms | 문자열 | 타겟팅된 플랫폼입니다. |
targeting.publisher_platforms | TargetingPublisherPlatforms | 문자열 | 타겟팅된 게시자 플랫폼 |
targeting.instagram_positions | TargetingInstagramPositions | 문자열 | 타겟팅된 Instagram 게재위치입니다. |
targeting.page_types | TargetingPageTypes | 문자열 | 타겟팅된 페이지 유형입니다. |
learning_stage_info.status | LearningStageInfoStatus | 문자열 | 학습 단계의 상태입니다. |
learning_stage_info.conversions | LearningStageInfoConversions | 정수 | 학습 단계의 전환수입니다. |
learning_stage_info.attribution_windows | LearningStageInfoAttributionWindows | 문자열 | 학습 단계의 기여 산정 기간입니다. |
learning_stage_info.last_sig_edit_time | LearningStageInfoLastSigEditTime | 날짜/시간 | 학습 단계의 마지막 주요 수정 시간입니다. |
Campaigns 보고서
| Meta API 필드 이름 |
매핑된 BigQuery 필드 이름 |
유형 |
설명 |
id | ID | 문자열 | 캠페인의 ID입니다. |
| 대상 | 문자열 | 대상 필드입니다. |
name | 이름 | 문자열 | 캠페인의 이름입니다. |
buying_type | BuyingType | 문자열 | 구매 유형입니다. |
configured_status | ConfiguredStatus | 문자열 | 구성된 상태입니다. |
effective_status | EffectiveStatus | 문자열 | 유효 상태입니다. |
status | 상태 | 문자열 | 캠페인의 현재 상태입니다. |
created_time | CreatedTime | 날짜/시간 | 생성 시간입니다. |
objective | 목표 | 문자열 | 선택한 캠페인 목표입니다. |
spend_cap | SpendCap | 정수 | 최대 전체 기간 지출 한도입니다. |
daily_budget | DailyBudget | 정수 | 일일 예산입니다. |
budget_remaining | BudgetRemaining | 정수 | 캠페인의 남은 예산입니다. |
lifetime_budget | LifetimeBudget | 정수 | 전체 기간 예산입니다. |
bid_strategy | BidStrategy | 문자열 | 입찰에 사용되는 전략입니다. |
start_time | StartTime | 날짜/시간 | 예약된 시작 시간입니다. |
stop_time | StopTime | 날짜/시간 | 예약된 중지/종료 시간입니다. |
updated_time | UpdatedTime | 날짜/시간 | 최종 업데이트 시간입니다. |
boosted_object_id | BoostedObjectId | 문자열 | 부스트된 객체의 ID입니다. |
AdImages 보고서
| Meta API 필드 이름 |
매핑된 BigQuery 필드 이름 |
유형 |
설명 |
id | ID | 문자열 | 이미지의 ID입니다. |
| 대상 | 문자열 | 대상 필드입니다. |
account_id | AccountId | 문자열 | 이미지를 소유한 광고 계정 ID입니다. |
created_time | CreatedTime | 날짜/시간 | 이미지 생성 시간입니다. |
hash | 해시 | 문자열 | 이미지 콘텐츠의 고유 해시입니다. |
height | 높이 | 정수 | 이미지 높이(픽셀)입니다. |
width | 너비 | 정수 | 이미지 너비(픽셀)입니다. |
creatives | AssociatedWithCreatives | 문자열 | 연결된 광고 소재 정보입니다. |
name | name | 문자열 | 이미지의 이름 식별자입니다. |
original_height | OriginalHeight | 정수 | 원래 업로드된 높이입니다. |
original_width | OriginalWidth | 정수 | 원래 업로드된 너비입니다. |
status | 상태 | 문자열 | 이미지의 유효성 검사 상태입니다. |
permalink_url | PermalinkUrl | 문자열 | 이미지 고유 링크를 가리키는 URL입니다. |
AdLabels 보고서
| Meta API 필드 이름 |
매핑된 BigQuery 필드 이름 |
유형 |
설명 |
id | ID | 문자열 | 광고 라벨의 ID입니다. |
| 대상 | 문자열 | 대상 필드입니다. |
name | 이름 | 문자열 | 라벨의 표시 이름입니다. |
created_time | CreatedTime | 날짜/시간 | 라벨이 생성된 시간입니다. |
updated_time | UpdatedTime | 날짜/시간 | 라벨이 마지막으로 업데이트된 시간입니다. |
Businesses 보고서
| Meta API 필드 이름 |
매핑된 BigQuery 필드 이름 |
유형 |
설명 |
id | ID | 문자열 | 비즈니스의 ID입니다. |
name | 이름 | 문자열 | 비즈니스 이름입니다. |
primary_page | PrimaryPage | 문자열 | 비즈니스와 연결된 기본 페이지입니다. |
timezone_id | TimezoneId | 문자열 | 비즈니스의 시간대 식별자입니다. |
link | 링크 | 문자열 | 비즈니스 프로필 링크 |
created_time | CreatedTime | 날짜/시간 | 비즈니스 생성 시간입니다. |
updated_time | UpdatedTime | 날짜/시간 | 최종 업데이트 시간입니다. |
CustomAudiences 보고서
| Meta API 필드 이름 |
매핑된 BigQuery 필드 이름 |
유형 |
설명 |
id | ID | 문자열 | 맞춤 잠재고객의 ID입니다. |
| 대상 | 문자열 | 대상 필드입니다. |
account_id | AccountID | 문자열 | Account_ID에서 매핑된 광고 계정 ID입니다. |
name | 이름 | 문자열 | 맞춤 잠재고객의 이름입니다. |
description | 설명 | 문자열 | 잠재고객에 대한 설명입니다. |
subtype | 하위 유형 | 문자열 | 잠재고객의 하위 유형 카테고리입니다. |
time_created | TimeCreated | 날짜/시간 | 잠재고객 생성 시간입니다. |
time_updated | TimeUpdated | 날짜/시간 | 잠재고객 최종 업데이트 시간입니다. |
time_content_updated | TimeContentUpdated | 날짜/시간 | 잠재고객 콘텐츠가 마지막으로 수정된 시간입니다. |
rule | 규칙 | 문자열 | 잠재고객 멤버십을 관리하는 데 사용되는 규칙입니다. |
rule_aggregation | RuleAggregation | 문자열 | 잠재고객 규칙의 집계 설정입니다. |
approximate_count_lower_bound | ApproximateCountLowerBound | 정수 | 잠재고객 규모의 하한 근사치입니다. |
approximate_count_upper_bound | ApproximateCountUpperBound | 정수 | 잠재고객 규모의 상한 근사치입니다. |
pixel_id | PixelID | 문자열 | 연결된 픽셀 ID입니다. |
retention_days | RetentionDays | 정수 | 회원이 유지되는 기간(일)입니다. |
customer_file_source | CustomerFileSource | 문자열 | 고객 파일의 원본 소스입니다. |
data_source | DataSource | JSON | 기본 데이터 소스입니다. |
delivery_status | DeliveryStatus | JSON | 현재 전송 상태입니다. |
operation_status | OperationStatus | JSON | 최근 작업의 상태입니다. |
permission_for_actions | PermissionForActions | JSON | 작업 권한입니다. |
is_value_based | IsValueBased | Boolean | 잠재고객이 값 기반인지 나타내는 플래그입니다. |
opt_out_link | OptOutLink | 문자열 | 선택 해제 링크입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-06-01(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-06-01(UTC)"],[],[]]