Set up data connector
세부사항
| 데이터 커넥터 기술 | API (Facebook Graph API, Marketing API v13.0) |
| 데이터 세분화 |
Facebook은 다음 사항에 따라 세분화된 데이터를 제공합니다. (하단의 Data Mapping 용어와 세부사항을 참고하세요):
추가로, Facebook은 다음 중 하나의 세분화 데이터를 제공합니다.
이 중 기본 설정 데이터는 국가입니다. 다른 세분화 데이터를 원한다면, 고객 성공 매니저 또는 Singular 서포트팀에 문의하여 해당 기능을 설정하세요. 각 어카운트 ID에 대한 세분화 정보는 따로 선택할 수 있습니다. |
| 취득 가능한 데이터 기간 | |
| 시간대 | 페이스북 어카운트 내 설정된 시간대 |
| 크리에이티브 레벨 (creative level) 데이터 제공 여부 | 가능 |
| 싱귤러에서 크리에이티브 소재 (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 |
|
| Public Id | site_public_id |
|
| 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) 데이터 취득
|
| 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와 트러블슈팅
Facebook에서 제공하는 다양한 메트릭 중에서 Singular 연동은 다음과 같은 모바일 마케팅 관련 메트릭을 수집합니다.
- 노출 Impressions
- 클릭 Clicks
- 설치 Installs
- 지출 Cost
또한 Singular내에서는 커스텀 이벤트(Custom Events)로 알려진 Facebook의 유저 행동 데이터를 취득할 수 있습니다. Facebook에서 해당 데이터를 취득할 수 있도록 Singular를 설정하는 방법에 대하여 아래의 커스텀 이벤트 설정을 참조하세요. (*Singular SDK를 통해 이벤트를 취득하는 경우에는 SDK를 통한 이벤트 생성을 권장합니다.)
동적 크리에이티브(Dynamic Creatives)는 복수의 크리에이티브 에셋을 포함하는 Facebook 내 특별한 형태의 크리에이티브 입니다. Singular는 에셋 레벨 데이터와 리포트 내 크리에이티브 에셋 데이터를 표시할 수 있습니다.
Facebook은 에셋을 상이한 세분화 데이터로 간주하며 에셋 레벨 데이터를 다른 세분화 데이터 (예시, 국가 또는 하위 광고 매체)와 함께 제공하지 않습니다. 에셋 데이터를 국가별(또는 Facebook 리포트 내 다른 세분화 데이터별)로 표기하기 위해, Singular는 크리에이티브별 데이터를 가져와 보간법(interpolation)을 통해 각 에셋 데이터를 메트릭의 일정한 비율로 다음과 같이 분배합니다.
예를 들어, Facebook 세분화 데이터를 국가로 결정했다면, 다음과 같이 분배됩니다.
Facebook API는 국가(Country), 하위 광고 매체(Sub Ad Network) 또는 플랫폼(Platform)만을 제공하므로, Singular는 이 중 나머지 두 디멘션을 알아내기 위해 캠페인, 하위 캠페인, 또는 크리에이티브의 타깃 설정들을 확인합니다.
예를 들어, 데이터를 캠페인과 국가에 따라 세분화하면, Facebook으로부터 가져온 데이터는 플랫폼을 포함하지 않습니다. Singular는 각 캠페인에 대한 타깃 설정을 찾고 캠페인이 아이폰과 같이 특정 플랫폼을 타깃팅한다면, 타깃 정보를 사용하여 "iPhone"이라는 값과 함께 그 캠페인의 플랫폼 필드를 채우게 됩니다.
반면에, 캠페인이 iOS와 Android와 같이 복수 플랫폼을 타깃한다면 Singular는 이를 사용하여 플랫폼 필드를 채울 수 없습니다.
이는 캠페인 또는 하위 캠페인(Facebook의 경우 ad campaign 또는 ad sets)을 리포트에 정의하여 각각 한 국가 또는 한 디바이스를 타깃하게 함으로 더 풍부한 데이터를 얻을 수 있다는 의미가 됩니다.
참고: 만약 플랫폼 데이터가 타깃팅 설정으로부터 기인한다면, 리포트는 가끔 플랫폼에 "iPhone" 또는 "iPad" 아니면 "iOS"만 나타내거나 아무것도 나타내지 않을 수 있습니다. 이는 각 경우의 타깃팅 레벨에 기반합니다.
기본 설정으로, Facebook은 클릭에 대하여 7일, 뷰에 대하여 1일의 어트리뷰션 윈도우(Attribution window)를 갖습니다.
Singular 애널리틱스 리포트 내 다른 값들을 사용하고 싶다면, Singular 서포트팀에게 변경을 요청하세요.
Facebook으로부터 Singular로 데이터를 가져오려면 다음 절차를 따르세요.
- Singular 플랫폼에서 Settings > Data Connectors로 가세요.
- Add New Connector에서 "Facebook"을 입력하여 선택하세요.
-
Connect with Facebook을 클릭하고 필요한 광고 계정에 대한 엑세스 권한이 있는 Facebook 사용자로 로그인하세요.
참고: 버튼을 클릭하기 전, 관계없는 계정으로 Facebook에 로그인되어있지는 않은지 (예를 들어, 개인 계정) 확인하세요.
Facebook Ads 에이전시 계정을 통해 캠페인을 운영하려면, Settings > Data Connectors에 가서 Facebook 에이전시 계정을 추가하세요. 따로 SDK 연동이나 파트너 컨피규레이션(Partner Configuration) 업데이트는 필요하지 않습니다.
그 후 Singular 리포팅 툴을 사용하여 노출(impression), 클릭(Clicks), 그리고 지출 (Cost)과 같은 캠페인 데이터를 얻을 수 있습니다. 리포트를 작동시킬 때 Account ID와 Account Name 디멘션을 사용하세요.
만약 캠페인 지출(campaign cost)이 에이전시 비용과 같은 추가 비용을 포함한다면, 리포트의 Settings > Partner Fees에서 지출(Cost)의 추가 비용을 추가할 수 있습니다. Partner Fees FAQ 참고.
에이전시로써 데이터를 확인할 수도 있습니다. Settings > Data Connectors의 Facebook 설정에 가서 View This Source As 드롭 다운을 사용하세요.
Singular는 로그인했었던 접근이 가능한 모든 계정들을 표시합니다. Singular를 통해 연결하고 싶은 계정들을 선택하세요. 예를 들어, 더미 데이터가 있는 테스트 계정이 있다면 해당 계정들은 선택하지 않은 채로 두어도 됩니다.
참고: 선택한 계정중 하나가 유효하지 않은 상태라면, 저장할 수 없습니다. 이런 경우는 Facebook에서 계정이 더 이상 활성화 상태가 아니거나 로그인한 유저가 더 이상 해당 계정에 접근 권한을 갖고 있지 않을 때 일어날 수 있습니다.
소스(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을 선택하여 커스텀 이벤트에 매핑하세요.
