데이터 커넥터 추가
- Settings > Data Connectors에서 Add Data Connector를 클릭한 다음 “Facebook”을 입력하여 선택합니다.
- Facebook 자격 증명으로 로그인합니다. Singular로 다시 이동하여 데이터 커넥터를 다시 열어야 할 수도 있습니다.
- 추가한 데이터 커넥터를 열고 데이터를 가져올 계정을 활성화한 다음 다음을 클릭합니다: Submit.
빠른 세부 정보
| 데이터 커넥터 기술 | API (Facebook Graph API 및 Marketing API v19.0) |
| 데이터 분석(세분화) |
Facebook은 데이터를 다음 모든 기준 으로 분류하여 제공합니다(용어와 자세한 내용은 아래 데이터 매핑 참조):
또한 Facebook은 다음 중 하나의 분류 기준을 제공합니다:
이 중 기본값은 국가입니다. 다른 분류 기준을 사용하려면 Customer Success Manager 또는 Singular 지원팀에 문의하여 연동을 구성하세요. Account ID별로 분류 기준을 개별적으로 선택할 수 있습니다. |
| 데이터를 얼마나 오래 거슬러 올라가는지 | Singular는 매일 7일 전까지의 데이터를 가져옵니다. 매주 월요일에는 30일 전까지의 데이터를 가져옵니다. |
| 시간대 | Facebook에서 계정에 설정된 시간대입니다. |
| 크리에이티브(광고) 수준에서 데이터를 사용할 수 있나요? | 예. |
| Singular는 내 크리에이티브 에셋을 표시하나요? | 예, Dynamic Creative에 포함된 여러 에셋도 표시합니다. 단, 페이지 관리자가 아닌 사용자의 경우 Singular는 Facebook 페이지에서 동영상을 가져올 수 없습니다. |
| 알려진 제한 사항/문제 | Facebook 계정에서 2단계 인증을 활성화한 경우, Singular에서 Facebook 데이터 커넥터를 다시 인증해야 합니다. |
데이터 매핑
용어 참고 사항:
- "Campaign"는 Singular에서 Facebook의 "Ad Campaign"에 해당합니다
- "Sub-Campaign"는 Facebook의 다음에 해당합니다: "Ad Set"
- "Creative"는 Facebook의 다음에 해당합니다: "Ad"
- "Asset"은 계층 구조에서 Creative 보다 아래에 있는 새로운 수준으로, Facebook의 "Asset"에 해당합니다. Dynamic Creative에서 사용되며, 예를 들어 Automated App Ads [AAA] 캠페인에서 사용됩니다).
모든 필드에 대한 설명은 Singular 메트릭 및 기준 용어집을 참조하세요.
Meta에서 크리에이티브 리포트를 실행하는 방법에 대한 추가 팁은 Meta 및 Google Ads에서 크리에이티브 리포트를 실행하는 방법
| Field in Singular UI | Field in Singular API | Field in Facebook |
|---|---|---|
| Dimensions | ||
| Account ID | adn_account_id | 'id' from me/adaccounts |
| Account Name | adn_account_name | 'name' from me/adaccounts |
| Asset ID | asset_id | asset_id |
| Campaign URL | adn_campaign_url | Taken from one of the Creative URLs. |
| Country | country_field | Country from Insights URL |
| Date | date_field | Given as a parameter when querying 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' from the campaign-level endpoint |
| Network Creative ID | adn_creative_id | ad_id |
| Network Creative Name | adn_creative_name | 'Name' from ad level |
| Network Sub Campaign ID | adn_sub_campaign_id | adset_id |
| Network Sub Campaign Name | adn_sub_campaign_name | 'Name' from the sub-campaign (ad set) level endpoint |
|
Placement |
placement |
Mapped from one of the following fields: device_platforms/ publisher_platforms/ facebook_positions/ instagram_positions/ audience_network_positions/ messenger_positions Possible values: 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 | For Sub Ad Network ("Publisher Platform") breakdown - this field contains the sub ad network, i.e. Facebook Advertising Network, Instagram, Whatsapp, etc. |
| Sub Ad Network | adn_subadnetwork | publisher_platform |
| Sub Campaign ID | sub_campaign_id | adset_id |
| Sub Campaign Name | sub_campaign_name | ‘Name’ from sub campaign level insights |
| Target Countries | target_countries_str | targeting[‘geo_locations’] |
| Text | creative_text |
Get creative(ad) data by id
|
| Timezone | adn_timezone | From Account.timezone_utc_offset |
| UTC Offset | adn_utc_offset | From Account.timezone_utc_offset |
| Age | age | age |
| Gender | gender | gender |
Facebook Attribution Type |
campaign_attribution_type | A field for FB app ads campaign, which directly indicates the chosen attribution type for an app install campaign (e.g., SKAN or AEM) while creating it on FB |
Call to Action Button |
call_to_action_button | A creative field with the call to action message if there is any |
| Metrics | ||
|
Comments |
adn_comments | Post comments |
|
Likes |
adn_likes | Post reactions |
| Network Clicks | adn_clicks | Clicks (default) or inline_link_clicks (if specifically requested by Singular customer) |
| Network Impressions | adn_impressions | impressions |
| Network Installs | adn_installs | Mobile_installs / canvas_installs. Note that if you set up your campaign with Facebook to optimize on AEM installs, this metric will reflect AEM installs. |
| Original Cost | adn_original_cost | spend |
| Original Currency | adn_original_currency | 'currency' from me/adaccounts endpoint |
|
Posts saved |
posts_saved | Post saves |
|
Shares |
adn_shares | Post shares |
| 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 |
Singular는 이 파트너의 캠페인 속성 가져오기도 지원합니다. 자세한 내용은 여기를 참조하세요.
FAQ 및 문제 해결
Facebook이 제공하는 다양한 메트릭 중에서 Singular 연동은 모바일 마케팅과 관련된 메트릭을 수집합니다:
- 노출수
- 클릭수
- 설치수 - Facebook 캠페인을 AEM 설치에 최적화하도록 설정한 경우, 이 메트릭에는 AEM 설치가 반영됩니다.
- 비용
또한 Singular는 사용자 액션에 대한 통계를 가져올 수 있으며, 이는 Singular에서 전환 이벤트라고 합니다. Facebook에서 해당 데이터를 가져오도록 Singular를 구성하는 방법은 아래 사용자 지정 이벤트 구성을 참조하세요.
캠페인을 AEM에 최적화하도록 설정한 경우, AEM 설치를 네트워크 설치 기준으로 가져옵니다
최종 사용자의 개인정보를 보호하기 위해 Facebook은 노출수가 1,000회 미만인 사용자 세그먼트의 측정값 표시를 허용하지 않습니다. 리포트의 어떤 행에 이 메시지가 표시된다면, 해당 행의 노출수가 적다는 의미입니다. 원하는 데이터를 확인하려면 기준을 줄이거나 기간을 넓혀 덜 세분화된 리포트를 실행해 보세요.
Dynamic Creative는 여러 크리에이티브 에셋을 포함하는 Facebook의 특수한 크리에이티브 유형입니다. 이제 Singular는 이러한 크리에이티브 에셋을 리포트에 표시하고 에셋 수준의 통계도 제공합니다.
Facebook은 에셋을 별도의 분류 기준으로 간주하며, 다른 허용된 분류 기준(예: 국가 또는 하위 광고 네트워크)과 함께 에셋 수준 데이터를 제공하지 않습니다. 국가별(또는 다른 Facebook 리포트에서 사용하는 분류 기준별) 에셋 데이터를 제공하기 위해 Singular는 크리에이티브별로 데이터를 가져온 다음, 각 에셋에 메트릭을 비례 배분하는 방식으로 보간하는 추가 단계를 거칩니다.
예를 들어 선택한 Facebook 분류 기준이 국가인 경우:
Facebook API는 국가, 하위 광고 네트워크, 플랫폼 중 하나만 제공하므로 Singular는 나머지 두 기준을 다른 방법으로 파악합니다. 즉, 캠페인, 하위 캠페인 또는 크리에이티브의 타겟팅 설정을 확인합니다.
예를 들어 데이터를 캠페인과 국가로 분류하는 경우, Facebook에서 가져온 데이터에는 플랫폼이 포함되지 않습니다. Singular는 각 캠페인의 타겟팅 설정을 조회하고, 캠페인이 iPhone처럼 특정 플랫폼 하나만 타겟팅하는 경우, Singular는 타겟팅 정보를 사용하여 해당 캠페인의 플랫폼 필드를 채웁니다 (값은 "iPhone").
반면 캠페인이 iOS와 Android처럼 여러 플랫폼을 타겟팅하는 경우, Singular는 이를 사용하여 플랫폼 필드를 채울 수 없습니다.
따라서 캠페인 또는 하위 캠페인(Facebook에서는 ad campaign 또는 ad set)을 각각 하나의 국가 및/또는 하나의 기기를 타겟팅하도록 정의하면 리포트에서 더 풍부한 데이터를 얻을 수 있습니다.
참고: 플랫폼 데이터가 타겟팅 설정에서 파생된 경우, 리포트에 플랫폼이 "iPhone" 또는 "iPad"로 표시될 때도 있고 "iOS"로만 표시되거나 전혀 표시되지 않을 때도 있습니다. 이는 각 경우의 타겟팅 수준에 따라 달라집니다.
기본적으로 Facebook은 클릭에 7일, 조회에 1일의 어트리뷰션 윈도우를 사용합니다.
Singular 애널리틱스 리포트에서 다른 값을 사용하려면 Singular 지원팀에 문의 하여 윈도우를 변경하세요.
Facebook에서 Singular로 데이터를 가져오기 시작하려면 다음과 같이 하세요:
- Singular 플랫폼에서 다음으로 이동합니다: Settings > Data Connectors.
- Add New Connector 버튼 위에 마우스를 올린 다음 "Facebook"을 입력하기 시작합니다. 표시되는 목록에서 Facebook을 선택합니다.
-
Connect with Facebook를 클릭하고 필요한 광고 계정에 접근할 수 있는 Facebook 사용자로 로그인합니다.
참고: 버튼을 클릭하기 전에 관련 없는 계정(예: 개인 계정)으로 Facebook에 로그인되어 있지 않은지 확인하세요.
에이전시 Facebook Ads 계정으로 캠페인을 운영하려면 다음으로 이동하여 Settings > Data Connectors에이전시 Facebook 계정을 추가하세요. SDK 연동이나 파트너 구성을 변경할 필요는 없습니다.
그러면 리포팅 도구를 사용하여 노출수, 클릭수, 비용 같은 캠페인 데이터를 확인할 수 있습니다. 리포트를 실행할 때는 Account ID 및 Account Name 기준을 사용하세요.
캠페인 비용에 에이전시 수수료 같은 추가 요금이 포함된 경우, 다음에서 Singular가 이러한 요금을 리포트에 표시되는 비용에 추가하도록 설정할 수 있습니다: Settings > Partner Fees. 자세한 내용은 파트너 요금 FAQ를 참조하세요.
에이전시 관점에서 데이터를 볼 수도 있습니다. 다음으로 이동하여 Settings > Data ConnectorsFacebook 구성을 열고 View This Source As 드롭다운을 사용하세요.
Singular는 로그인한 사용자가 접근할 수 있는 모든 계정을 표시합니다. Singular에 연결할 계정을 선택하세요. 예를 들어 더미 데이터가 있는 테스트 계정은 제외하는 것이 좋습니다.
참고: 선택한 계정 중 하나가 유효하지 않으면 저장할 수 없습니다. Facebook의 계정이 더 이상 활성 상태가 아니거나 로그인한 사용자가 해당 계정에 더 이상 접근할 수 없는 경우 이런 일이 발생할 수 있습니다.
Source 열에서 각 계정에 이름을 지정할 수 있습니다. 이 이름으로 데이터가 리포트에 표시됩니다. 여러 계정에 동일한 소스 이름을 사용할 수 있습니다.
예를 들어 Nanigans 같은 Preferred Marketing Developer(PMD) 또는 Facebook Marketing Partner(FMP)가 관리하는 광고 캠페인용 Facebook 계정이 하나 이상 있는 경우, 해당 계정에 "Nanigans"를 지정하세요. Singular 리포트는 이러한 계정의 데이터를 합산하여 "Nanigans"라는 소스 이름으로 표시합니다.
기본적으로 모든 계정에는 소스 이름 "Facebook"이 지정됩니다.
Singular의 사용자 지정 이벤트에 대한 일반적인 정보는 사용자 지정 이벤트 구성을 참조하세요
Singular는 가입이나 첫 구매 같은 사용자의 설치 후 이벤트 데이터를 분석할 수 있습니다. 이러한 이벤트 데이터는 어트리뷰션 제공업체에서 가져오는 것이 일반적으로 더 좋지만, Facebook 활동을 어트리뷰션 제공업체로 트래킹하지 않거나 비모바일 트래픽을 트래킹하려는 경우에는 Facebook에서 직접 오는 데이터를 수집할 수 있습니다. Facebook에서 사용자 이벤트는 actions라고 합니다.
Facebook의 사용자 지정 이벤트 트래킹을 시작하려면 사용자 지정 이벤트 구성의 안내에 따라 새 사용자 지정 이벤트를 추가하세요. Facebook 캠페인이 구성되어 있으면 New Custom Event 상자에 Facebook 드롭다운 목록이 표시됩니다. 목록을 클릭하여 사용 가능한 모든 Facebook actions를 표시하고, 사용자 지정 이벤트에 매핑할 액션을 선택하세요.
iOS 리포트에 설치 수가 표시되지 않는 경우, 올바른 리포트를 보고 있는지 확인하세요. SKAN 리포트에는 SKAN 설치 값이 표시되고, Reports에는 네트워크 설치와 MMP 설치가 모두 표시됩니다.
다음 사항을 유념하세요:
- SKAN 리포트: SKAN 리포트는 네트워크 데이터와 SKAN 설치를 결합합니다. 네트워크 데이터는 상세하지만, SKAN 데이터는 SKAdNetwork의 제약으로 인해 일반적으로 캠페인 수준입니다.
- 리포트 분류: 하위 캠페인으로 분류할 때, 파트너가 캠페인 수준에서만 데이터를 전달하는 경우 SKAN 설치가 'N/A'로 표시될 수 있습니다. 그 외 데이터는 각각의 하위 캠페인에 표시됩니다.
Facebook 크리에이티브 권한 오류는 일반적으로 페이지 또는 광고 계정에 대한 접근 권한이 없거나, 에셋(이미지/동영상)을 사용할 수 없거나, 역할 권한이 충분하지 않다는 의미입니다. Business Settings의 Accounts > Pages/Ad Accounts를 확인하고, 페이지 관리자 권한이 있는지 확인하며, 관리자에게 해당 광고 계정의 역할(Admin/Advertiser)을 할당해 달라고 요청하거나, 연결 시 도메인 접근 권한을 요청하면 대부분 해결됩니다. 일반적인 해결 방법으로는 Ads Manager에서 권한을 확인하거나, 페이지 상태(삭제/비활성화되지 않았는지)를 확인하거나, 광고/크리에이티브를 복제하여 신속히 다시 게시하는 방법이 있습니다. 자세한 내용은 Facebook 문서 여기에서 확인할 수 있습니다