페이스북 데이터 커넥터

세부사항

데이터 커넥터 기술 API (Facebook Graph API, Marketing API v13.0)
데이터 세분화

Facebook은 다음 사항에 따라 세분화된 데이터를 제공합니다. (하단의 Data Mapping 용어와 세부사항을 참고하세요):

  • Account
  • Campaign
  • Sub-Campaign
  • Creative

추가로, Facebook은 다음 중 하나의 세분화 데이터를 제공합니다. 

  • Country (기본 설정)
  • Sub Ad Network (퍼블리셔 플랫폼) + Placement (플랫폼 포지션): 퍼블리셔 플랫폼은 광고가 표기된 Facebook의 특징을 말합니다.
    예시, Facebook, Instagram, Messenger, 또는 Facebook Audience Network. 플랫폼 포지션은 광고가 표기된 곳에 대한 세부정보를 제공합니다.
    예시, Facebook 웹 사이트 뉴스 피드 또는 Instagram 모바일 뉴스 피드.  
  • Platform (노출 디바이스): 예시, iOS, Android, 또는 iPhone.
  • Region: 위치 레벨 정보 (국가 포함).
  • DMA: DMA 레벨 정보 (국가 포함). 미국에서만 제공 가능.

이 중 기본 설정 데이터는 국가입니다. 다른 세분화 데이터를 원한다면, 고객 성공 매니저 또는 Singular 서포트팀에 문의하여 해당 기능을 설정하세요. 각 어카운트 ID에 대한 세분화 정보는 따로 선택할 수 있습니다. 

취득 가능한 데이터 기간  
시간대 페이스북 어카운트 내 설정된 시간대
크리에이티브 레벨 (creative level) 데이터 제공 여부 가능
싱귤러에서 크리에이티브 소재 (assets) 제공 여부 제약사항:
  • 동적 크리에이티브(Dynamic Creatives)의 경우 크리에이티브에 포함 된 다른 소재(assets)을 표시하지 않습니다.
  • 페이지 관리자가 아닌 사용자의 페이스북 페이지에서 비디오를 가져올 수 없습니다.
제약 사항 / 이슈 페이스북 어카운트에서 2단계 인증을 활성화한 경우 싱귤러에서 페이스북 데이터 커넥터를 다시 인증해야 합니다.

데이터 매핑

  • 용어 참고:

    • 싱귤러의 “Campaign”은 페이스북의 “Ad Campaign”에 해당합니다.
    • 싱귤러의 “Sub-Campaign”은 페이스북의 “Ad Set”에 해당합니다.
    • 싱귤러의 “Creative”는 페이스북의 “Ad”에 해당합니다.
    • "Asset"은 크리에이티브의 새 레벨 데이터로 Facebook의 "Asset"에 해당합니다. 이는 동적 크리에이티브(Dynamic Creatives)에 사용됩니다. 예시, 자동화 앱 광고 [AAA] 캠페인).

모든 필드에 대한 설명은 Singular 메트릭과 용어사전을 참고하세요.

Singular UI 내 필드명 Singular API 내 필드명 Facebook 내 필드명
디멘션
Account ID adn_account_id me/adaccounts 내 'id'
Account Name adn_account_name me/adaccounts 내 'name' 
Asset ID asset_id asset_id
Campaign URL adn_campaign_url

크리에이티브 URL 하나에서 취득

Country country_field Insights URL 내 Country 값 
Date date_field Facebook에 쿼리시 매개 변수로 제공
DMA ID dma_id_field targeting[geo_locations][data][key]
DMA Name dma_name_field dma
Network Campaign ID adn_campaign_id campaign_id
Network Campaign Name adn_campaign_name 캠페인 레벨 엔드포인트의 'Name' 
Network Creative ID adn_creative_id ad_id
Network Creative Name adn_creative_name 광고 레벨의 'Name'  
Network Sub Campaign ID adn_sub_campaign_id adset_id
Network Sub Campaign Name adn_sub_campaign_name Sub-Campaign (ad set) 레벨 엔드포인트의 'Name' 
Placement
placement
다음 필드 중 하나에 매핑: device_platforms/ publisher_platforms/ facebook_positions/ instagram_positions/ audience_network_positions/ messenger_positions
가능한 값들: mobile, desktop, facebook, instagram, messenger, audience_network, feed, right_hand_column, instant_article, marketplace, video_feeds, search stream, story, explore, classic, instream_video, rewarded_video, messenger_home, sponsored_messages
Platform platform
  1. 모든 광고가 동일한 플랫폼 (Creative Platform 참조) 경우 Singular 해당 플랫폼을 하위 캠페인에 제공합니다.
  2. 그렇지 않으면 ad-set 타겟팅을 기반으로 추정합니다: targeting[‘user_os’], targeting[‘user_device’], targeting[‘device_platforms’]
  3. 가능하지 않은 경우 캠페인 목표에 따라 추정합니다
  • LINK_CLICKS, CONVERSIONS → Platform WEB
  • CANVAS_APP_INSTALL, CANVAS_APP_ENGAGEMENT → Platform CANVAS
Public Id site_public_id
  1. 가능한 경우 캠페인 URL 플랫폼 디멘션에서 취득합니다.
  2. 그렇지 않으면 크리에이티브 URL 플랫폼에서 취득합니다.
Region
region_field
region
Source source

Sub Ad Network (“Publisher Platform”) 분석의 경우 Facebook Advertising Network, Instagram, Whatsapp 등과 같은 sub ad network 포함됩니다.

Sub Ad Network adn_subadnetwork publisher_platform
Sub Campaign ID sub_campaign_id adset_id
Sub Campaign Name sub_campaign_name Sub-campaign level insights의 ‘Name’ 
Target Countries target_countries_str targeting[‘geo_locations’]
Text creative_text

ID creative(ad) 데이터 취득

  • ad[‘body’]
  • ad[‘message’] story 혹은 video 경우
  • ad[‘description’] event 혹은 page 경우
  • asset_feed_spec[‘title’] & asset_feed_spec[bodies] & asset_feed_spec[‘descriptions’] ad asset_feed_spec 경우
Timezone adn_timezone Account.timezone_utc_offset에서 취득
UTC Offset adn_utc_offset Account.timezone_utc_offset에서 취득
메트릭
Network Clicks adn_clicks 클릭 (기본사항) 혹은 inline_link_clicks (Singular 고객에 의해 특별히 요청된 경우)
Network Impressions adn_impressions impressions
Network Installs adn_installs Mobile_installs / canvas_installs
Original Cost adn_original_cost spend
Original Currency adn_original_currency me/adaccounts 엔드포인트의 'currency' 
Video Views 25% video_views_25pct video_p25_watched_actions
Video Views 50% video_views_50pct video_p50_watched_actions
Video Views 75% video_views_75pct video_p75_watched_actions
Completed Video Views completed_video_views video_p100_watched_actions

FAQ와 트러블슈팅

Singular는 Facebook에서 어떤 메트릭을 가져올까요?

Facebook에서 제공하는 다양한 메트릭 중에서 Singular 연동은 다음과 같은 모바일 마케팅 관련 메트릭을 수집합니다. 

  • 노출 Impressions
  • 클릭 Clicks
  • 설치 Installs
  • 지출 Cost

또한 Singular내에서는 커스텀 이벤트(Custom Events)로 알려진 Facebook의 유저 행동 데이터를 취득할 수 있습니다.  Facebook에서 해당 데이터를 취득할 수 있도록 Singular를 설정하는 방법에 대하여 아래의 커스텀 이벤트 설정을 참조하세요. (*Singular SDK를 통해 이벤트를 취득하는 경우에는 SDK를 통한 이벤트 생성을 권장합니다.)   

Singular는 동적 크리에이티브(Dynamic Creatives) 내 에셋마다 어떤 데이터를 표기할까요? 

동적 크리에이티브(Dynamic Creatives)는 복수의 크리에이티브 에셋을 포함하는 Facebook 내 특별한 형태의 크리에이티브 입니다. Singular는 에셋 레벨 데이터와 리포트 내 크리에이티브 에셋 데이터를 표시할 수 있습니다. 

Facebook은 에셋을 상이한 세분화 데이터로 간주하며 에셋 레벨 데이터를 다른 세분화 데이터 (예시, 국가 또는 하위 광고 매체)와 함께 제공하지 않습니다. 에셋 데이터를 국가별(또는 Facebook 리포트 내 다른 세분화 데이터별)로 표기하기 위해, Singular는 크리에이티브별 데이터를 가져와 보간법(interpolation)을 통해 각 에셋 데이터를 메트릭의 일정한 비율로 다음과 같이 분배합니다.   

예를 들어, Facebook 세분화 데이터를 국가로 결정했다면, 다음과 같이 분배됩니다. 

Screen_Shot_2021-02-23_at_16.04.21.png

다른 세분화 데이터를 사용하는데 왜 가끔씩 국가(Country)나 플랫폼(Platform) 데이터가 보일까요? 

Facebook API는 국가(Country), 하위 광고 매체(Sub Ad Network) 또는 플랫폼(Platform)만을 제공하므로, Singular는 이 중 나머지 두 디멘션을 알아내기 위해 캠페인, 하위 캠페인, 또는 크리에이티브의 타깃 설정들을 확인합니다. 

예를 들어, 데이터를 캠페인과 국가에 따라 세분화하면, Facebook으로부터 가져온 데이터는 플랫폼을 포함하지 않습니다. Singular는 각 캠페인에 대한 타깃 설정을 찾고 캠페인이 아이폰과 같이 특정 플랫폼을 타깃팅한다면, 타깃 정보를 사용하여 "iPhone"이라는 값과 함께 그 캠페인의 플랫폼 필드를 채우게 됩니다

반면에, 캠페인이 iOS와 Android와 같이 복수 플랫폼을 타깃한다면 Singular는 이를 사용하여 플랫폼 필드를 채울 수 없습니다.  

이는 캠페인 또는 하위 캠페인(Facebook의 경우 ad campaign 또는 ad sets)을 리포트에 정의하여 각각 한 국가 또는 한 디바이스를 타깃하게 함으로 더 풍부한 데이터를 얻을 수 있다는 의미가 됩니다.  

참고: 만약 플랫폼 데이터가 타깃팅 설정으로부터 기인한다면, 리포트는 가끔 플랫폼에 "iPhone" 또는 "iPad" 아니면 "iOS"만 나타내거나 아무것도 나타내지 않을 수 있습니다. 이는 각 경우의 타깃팅 레벨에 기반합니다.  

인스톨을 측정하는데 사용되는 어트리뷰션 윈도우(Attribution window)란 무엇이고 변경할 수 있나요?  

기본 설정으로, Facebook은 클릭에 대하여 7일, 뷰에 대하여 1일의 어트리뷰션 윈도우(Attribution window)를 갖습니다. 

Singular 애널리틱스 리포트 내 다른 값들을 사용하고 싶다면, Singular 서포트팀에게 변경을 요청하세요.

Facebook 데이터 커넥터는 어떻게 설정할까요?

Facebook으로부터 Singular로 데이터를 가져오려면 다음 절차를 따르세요.

  1. Singular 플랫폼에서 Settings > Data Connectors로 가세요.
  2. Add New Connector에서 "Facebook"을 입력하여 선택하세요.
  3. Connect with Facebook을 클릭하고 필요한 광고 계정에 대한 엑세스 권한이 있는 Facebook 사용자로 로그인하세요.

    image3.png

    참고: 버튼을 클릭하기 전, 관계없는 계정으로 Facebook에 로그인되어있지는 않은지 (예를 들어, 개인 계정) 확인하세요.

Facebook Ads 에이전시 계정을 사용하려면 어떻게 할까요?

Facebook Ads 에이전시 계정을 통해 캠페인을 운영하려면, Settings > Data Connectors에 가서 Facebook 에이전시 계정을 추가하세요. 따로 SDK 연동이나 파트너 컨피규레이션(Partner Configuration) 업데이트는 필요하지 않습니다.

그 후 Singular 리포팅 툴을 사용하여 노출(impression), 클릭(Clicks), 그리고 지출 (Cost)과 같은 캠페인 데이터를 얻을 수 있습니다. 리포트를 작동시킬 때 Account IDAccount Name 디멘션을 사용하세요. 

만약 캠페인 지출(campaign cost)이 에이전시 비용과 같은 추가 비용을 포함한다면, 리포트의 Settings > Partner Fees에서 지출(Cost)의 추가 비용을 추가할 수 있습니다. Partner Fees FAQ 참고.

에이전시로써 데이터를 확인할 수도 있습니다. Settings > Data Connectors의 Facebook 설정에 가서 View This Source As 드롭 다운을 사용하세요.

facebook_agency.png

새 데이터 커넥터를 생성할 때 보이는 계정 리스트는 무엇이고 어떤 계정을 선택해야 할까요?

image1.png

Singular는 로그인했었던 접근이 가능한 모든 계정들을 표시합니다. Singular를 통해 연결하고 싶은 계정들을 선택하세요. 예를 들어, 더미 데이터가 있는 테스트 계정이 있다면 해당 계정들은 선택하지 않은 채로 두어도 됩니다. 

참고: 선택한 계정중 하나가 유효하지 않은 상태라면, 저장할 수 없습니다. 이런 경우는 Facebook에서 계정이 더 이상 활성화 상태가 아니거나 로그인한 유저가 더 이상 해당 계정에 접근 권한을 갖고 있지 않을 때 일어날 수 있습니다. 

각 계정의 "Source" 컬럼에 무엇을 기재해야 할까요?  

소스(Source) 컬럼으로 각 계정에 이름을 지정할 수 있습니다. 이 이름은 리포트 내 표시되는 데이터 아래에 나타나는 이름입니다. 동일한 이 소스 명을 복수의 계정에서 사용할 수 있습니다. 

예를 들어, Preferred Marketing Developer (PMD) 또는 Nanigans와 같은 Facebook Marketing Partner (FMP) 가 처리하는 광고 캠페인의 Facebook 계정이 하나 이상 있는 경우, 해당 계정들에 "Nanigans"라고 지명하세요. Singular 리포트는 이 계정들로부터 데이터들을 취합하여 소스 명 "Nanigans" 하단에 표기합니다.  

기본 설정으로, 모든 계정에는 "Facebook"이 소스 이름으로 제공됩니다. 

유저 이벤트 (컨버전 이후 이벤트) 추적을 어떻게 시작해야 할까요? 

Singular 커스텀 이벤트에 대한 일반 정보는 Custom Events 설정을 참고하세요.

Singular는 회원 가입이나 첫 구매와 같은 유저의 인스톨 이후 이벤트에 대해 분석할 수 있습니다. 일반적으로 Singular와 같은 어트리뷰션 공급자로부터 이러한 이벤트 데이터를 가져오는 것이 바람직하지만, 어트리뷰션 공급자를 통해 Facebook 활동을 추적하지 않거나 모바일이 이외의 트래픽을 추적하려는 경우 Facebook 자체에서 오는 데이터를 수집할 수 있습니다. Facebook에서는 이 유저 이벤트들을 actions이라 지칭합니다.  

Facebook에서 커스텀 이벤트 추적을 시작하려면, Custom 이벤트 설정 지침에 따라 새 커스텀 이벤트를 등록하세요. Facebook 캠페인이 설정되면 새 커스텀 이벤트 상자(New Custom Event)가Facebook 드롭 다운에서 목록을 포함합니다. 사용 가능한 모든 페이스북 actions들을 표시하려면 리스트를 클릭하고, action을 선택하여 커스텀 이벤트에 매핑하세요. 

image2.png

왜 Singular에서 보이는 데이터와 Facebook 대시보드에서 보이는 데이터가 상이할까요?