페이스북 데이터 커넥터

싱귤러가 페이스북에서 데이터를 취득하는 방법과 연동 설정 및 사용자 지정 방법을 알아보세요.

문제 해결 팁은  페이스북 데이터 불일치 문제 해결 가이드를 참조하세요.

 

세부사항

데이터 커넥터 기술 API (2020 년 3월 기준 Facebook API v. 6.0 사용 중 - 참조 가이드 Marketing API documentationGraph API documentation)
데이터 세분화 페이스북은 계정, 캠페인, 하위 캠페인 및 크리에이티브별로 분류 된 데이터를 제공합니다 (용어 및 자세한 내용은 아래 데이터 매핑 참조).  또한 다음 중 하나의 기준으로 세분화 기준을 설정 할 수 있습니다: 
  • 국가 (기본 설정) 
  • Sub Ad Network (페이스북에서의 Publisher Platform) - 광고가 표시되는 곳입니다 - 예 : Facebook, Instagram, Messenger 또는 Facebook Audience Network
  • 플랫폼 (페이스북에서의 Impression Device) - 예 : iOS, Android 또는 iPhone. 
Facebook API 제한으로 인해 국가 및 플랫폼별로 보고서를 분류 할 수 없습니다.  기본적으로 데이터는 국가별로 분류됩니다. 다른 분류가 필요한 경우 당사에 문의하십시오. 각 계정 ID에 대한 분류를 개별적으로 선택할 수 있습니다.
취득 가능한 데이터 기간  
시간대 페이스북 계정 내 설정된 시간대
크리에이티브 레벨 (creative level) 데이터 제공 여부 가능
싱귤러에서 크리에이티브 소재 (assets) 제공 여부 가능. 제약사항:
  • 동적 크리에이티브(Dynamic Creatives)의 경우 크리에이티브에 포함 된 다른 소재(assets)을 표시하지 않습니다.
  • 페이지 관리자가 아닌 사용자의 페이스북 페이지에서 비디오를 가져올 수 없습니다.
제약 사항 / 이슈 페이스북 계정에서 2단계 인증을 활성화 한 경우 싱귤러에서 페이스북 데이터 커넥터를 다시 인증해야 합니다.

데이터 매핑

  • 싱귤러의 “Campaign”은 페이스북의 “Ad Campaign”에 해당합니다.
  • 싱귤러의 “Sub-Campaign”은 페이스북의 “Ad Set”에 해당합니다.
  • 싱귤러의 “Creative”은 페이스북의 “Ad”에 해당합니다.

  싱귤러 UI 필드명 싱귤러 API 필드명 페이스북 필드명
캠페인 디멘션 Account ID adn_account_id me/adaccounts 내 ‘id’ 
캠페인 디멘션 Account Name adn_account_name me/adaccounts 내 ‘name’ 
캠페인 디멘션 App Site ID app_site_id
  1. 가능한 경우 캠페인 URL 및 플랫폼 디멘션에서 취득합니다.
  2. 그렇지 않은 경우엔 크리에티브 URL 및 Platform에서 취득합니다.
캠페인 디멘션 Campaign URL adn_campaign_url 크리에이티브 URL 중 하나에서 취득합니다.
캠페인 디멘션 Country country_field Insights URL 내 Country 값
캠페인 디멘션 Date date_field 페이스북에 쿼리시 매개 변수로 제공
캠페인 디멘션 DMA ID dma_id_field type=’adgeolocation’ 및 location_types=’geo_market’  및 DMA 이름을 사용하는 엔드포인트 ‘search’의 ‘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’
캠페인 디멘션 Platform platform
  1. 모든 광고가 동일한 플랫폼 (Creative Platform 참조) 인 경우 싱귤러는 해당 플랫폼을 하위 캠페인에 제공합니다.
  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 및 플랫폼에서 취득합니다.
캠페인 디멘션 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 From Account.timezone_utc_offset
캠페인 디멘션 UTC Offset adn_utc_offset From Account.timezone_utc_offset
Creative Dimensions Creative ID creative_id ad_id
Creative Dimensions Creative Name creative_name ad level 내 ‘Name’
Metrics Network Clicks adn_clicks Clicks or inline_link_clicks ( uan 옵션이 accounts_with_inline_link_clicks 인 경우)
Metrics Network Impressions adn_impressions impressions
Metrics Network Installs adn_installs Mobile_installs / canvas_installs
Metrics Original Cost adn_original_cost spend
Metrics Original Currency adn_original_currency me/adaccounts 엔드포인트 내 ‘currency’ 

FAQ 및 문제 해결

싱귤러는 페이스북에서 어떤 메트릭스을 가져 오나요?

페이스북에서 제공하는 다양한 메트릭스 중에서 싱귤러는 모바일 마케팅과 관련된 메트릭스를 수집합니다.

  • 노출 Impressions
  • 클릭 Clicks
  • 설치 Installs
  • 지출 Cost
또한 싱귤러 내 에서는 커스텀 이벤트(custom event)로 알려진 페이스북의 유저 행동 데이터를 취득할 수 있습니다. 페이스북에서 해당 데이터를 취득할 수 있도록 싱귤러를 구성하는 방법에 대한 정보는 아래의 사용자 지정 이벤트 구성을 참조하시기 바랍니다. (*싱귤러 SDK를 통해 이벤트를 취득하는 경우에는 SDK를 통한 커스텀 이벤트 생성을 권장 드립니다.)
다른 분류 기준을 사용하는 경우에도 보고서에 국가 또는 플랫폼 기준의 데이터가 표시되는 이유는 무엇입니까?

페이스북 API는 국가 또는 하위 광고 네트워크 또는 플랫폼 정보만 제공하므로 싱귤러는 캠페인, 하위 캠페인 또는 크리에이티브의 타겟팅 설정을 확인하여 다른 두 가지 디멘션을 다른 방식으로 파악하려고합니다.

예를 들어 캠페인 및 국가별 데이터를 분류하는 경우 페이스북에서 가져온 데이터에는 플랫폼이 포함되지 않습니다. 싱귤러는 각 캠페인에 대한 타겟팅 설정을 조회하고 캠페인이 iPhone과 같이 단일 플랫폼을 타겟팅하는 경우, 싱귤러는 이 타겟팅 정보를 사용하여 해당 캠페인의 플랫폼 필드에  “iPhone”을 입력합니다.

반면에 캠페인이 여러 플랫폼을 타겟팅하는 경우 (예. iOS 및 Android) 싱귤러는 이를 사용하여 플랫폼 필드를 채울 수 없습니다.

즉, 캠페인 또는 하위 캠페인 (페이스북 내: ad campaigns or ad sets)을 정의하여 각각의 국가 및  기기를 타겟팅하면 보다 풍부한 데이터를 얻을 수 있습니다.

참고 : 플랫폼 데이터가 타겟팅 설정에서 파생 된 경우 보고서에 플랫폼이 "iPhone"또는 "iPad"로 표시되고 다른 경우에는 "iOS"로만 표시되거나 전혀 표시되지 않을 수 있습니다. 이는 각 경우의 타겟팅 레벨을 기반으로합니다.

설치 수를 계산하는 데 사용되는 어트리뷰션 윈도우는 무엇입니까? 변경할 수 있습니까?

기본적으로 클릭(click) 28일, 노출(impression) 1일의 어트리뷰션 윈도우를 사용합니다.

싱귤러 분석 보고서에서 다른 값을 사용하려면 싱귤러 지원에 문의하여 설정을 변경하십시오.
  기본 어트리뷰션 윈도우 Options
클릭 Clicks 28 일 1 일 / 7 일 / 28 일
뷰 Views 1 일 1 일 / 7 일 / 28 일
페이스북 데이터 커넥터는 어떻게 설정합니까?

페이스북에서 싱귤러로 데이터를 가져오려면:

  • 싱귤러 플랫폼에서 설정(Settings) > 데이터 커넥터(Data Connectors)로 이동합니다.
  • 새 커넥터 추가 버튼(Add New Connector)에서 “Facebook”을 입력하여 선택 합니다.
  • Connect with Facebook을 클릭하고 필요한 광고 계정에 대한 액세스 권한이있는 페이스북 사용자로 로그인 합니다.

image3.png

참고: 버튼을 클릭하기 전에 관련없는 계정 (예: 개인 계정)으로 페이스북에 로그인하지 않았는지 확인하십시오.

새 커넥터를 만들 때 나타나는 계정 목록은 무엇입니까? 어떤 계정을 선택해야합니까?

image1.png

로그인 한 사용자가 접근 할 수있는 모든 계정이 표시 됩니다. 싱귤러에 연결하려는 계정을 선택하세요. 예를 들어 더미 데이터가 있는 테스트 계정의 경우 제외 할 수 있습니다.

참고: 유효하지 않은 계정이 포함 된 경우 저장 되지 않습니다. 페이스북의 계정이 더 이상 활성화되지 않거나 로그인 한 사용자가 더 이상 해당 계정에 액세스 할 수 없는 경우 발생할 수 있습니다.

각 계정의 “소스(source)" 항목에 무엇을 입력해야합니까?

소스 항목을 사용하여 각 계정에 이름을 지정할 수 있습니다.

예를 들어, PMD (Preferred Marketing Developer) 또는 “Nanigans”와 같은 FMP (Facebook Marketing Partner)가 처리하는 광고 캠페인의 페이스북 계정이있는 경우 해당 계정의 소스 항목에  “Nanigans”를 지정할 수 있습니다. 이러한 계정의 데이터는 리포트에서 “Nanigans”라는 소스 이름으로 표시 됩니다. 

기본적으로 모든 계정에는 “Facebook”이 소스 이름으로 제공됩니다.

사용자 이벤트 (전환 후 이벤트)를 추적하려면 어떻게 해야합니까?

싱귤러의 사용자 지정 이벤트(커스텀 이벤트)에 대한 일반적인 정보는 사용자 지정 이벤트 구성을 참조하십시오. 

싱귤러를 통해서 로그인 또는 첫 구매와 같은 사용자의 설치 후 이벤트에 대한 데이터를 분석 할 수 있습니다. 일반적으로 싱귤러와 같은 어트리뷰션 공급자로부터 이러한 이벤트 데이터를 가져 오는 것이 바람직하지만 어트리뷰션 공급자를 통해 페이스북 활동을 추적하지 않거나 모바일 이외의 트래픽을 추적하려는 경우 페이스북 자체에서 오는 데이터를 수집 할 수 있습니다. 

페이스북에서 커스텀 이벤트 추적을 시작하려면 커스텀 이벤트 구성의 지침에 따라 새로운 커스텀 이벤트를 추가합니다. 페이스북 캠페인을 구성한 경우 새 커스텀 이벤트 상자내에 페이스북 이벤트 목록이 표시됩니다. 목록을 클릭하여 설정할 커스텀 이벤트를 선택합니다.

image2.png

싱귤러가 페이스북 대시보드와 다른 데이터를 보이는 이유는 무엇입니까?
도움이 되었습니까?