TikTok For Business 데이터 커넥터

팔로우
Avatar
Vaibhav Gupta
Updated
TikTok For Business 설정
비용 집계
데이터 커넥터 설정

 

Singular가 TikTok For Business에서 광고 비용 데이터를 가져와 리포트에 표시하는 방법을 알아보세요. Singular 대시보드에서는 TikTok For Business의 소스가 TikTok Ads로 표시됩니다.

빠른 세부 정보

데이터 커넥터 기술 API (TikTok marketing API v. 1.3)
데이터 분석(세분화) 데이터는 다음 기준으로 분류됩니다:
  • 플랫폼 
  • 국가(기본값)
  • 게재위치
  • DMA
중요: 국가 이외의 분류 기준을 사용하려면 Singular 지원팀에 문의하세요. TikTok API의 제한으로 인해 캠페인 수준에서 여러 분류 기준의 데이터를 가져올 수 없습니다.

국가 분류 기준을 사용하지 않는 경우, 단일 타겟팅 캠페인에는 국가 값이 표시되지만 다중 타겟팅 캠페인은 어트리뷰션 데이터를 기반으로 추정할 수 없는 한 "N/A"로 표시됩니다. 추정 데이터는 TikTok의 데이터와 일치하지 않을 수 있습니다. 다음을 참조하세요: "국가별 비용은 어떻게 계산되나요?"
데이터를 얼마나 오래 거슬러 올라가는지 7일
시간대 TikTok에서 계정에 설정된 시간대
크리에이티브(광고) 수준에서 데이터를 사용할 수 있나요? 예
Singular는 내 크리에이티브 에셋을 표시하나요? 예

데이터 매핑

팁: Singular 리포팅의 필드에 대한 자세한 내용은 다음을 참조하세요: 메트릭 및 기준 용어집. 또한 TikTok의 캠페인 기능이 리포팅 API 필드에 어떻게 매핑되는지는 여기에서 확인할 수 있습니다.

Field in Singular UI Field in Singular API Field in TikTok API
Dimensions
Account ID adn_account_id (Taken from [advertiser/info])
Account Name adn_account_name advertiser_name
App app app_name
App Site ID app_site_id (Taken from the [app_download_url])
Bid Type bid_type bid_type
Campaign Objective campaign_objective objective_type
Campaign Status campaign_status opt_status
Campaign URL adn_campaign_url landing_page_url
Country country_field location
Date date_field stat_time_day
DMA ID dma_id_field dma.id
DMA Name dma_name_field dma.name
Network Campaign ID adn_campaign_id campaign_id
Network Campaign Name adn_campaign_name campaign_name
Network Creative ID adn_creative_id ad_id
Network Creative Name adn_creative_name ad_name
Network Sub Campaign ID adn_sub_campaign_id adgroup_id
Network Sub Campaign Name adn_sub_campaign_name adgroup_name
Original Bid Amount original_bid_amount bid
Original Bid Currency original_metadata_currency currency
Platform platform
  • platform
  • app_type (If platform is empty)
  • operating_system (If both are empty)
Public Id site_public_id mobile_app_id
Region
 		region_field
 		region.name (State or Province; displayed if sub-campaign targets a single region)
Standardized Bid Type standardized_bid_strategy optimize_goal
Timezone adn_timezone timezone
Text creative_text ad_text
TikTok - Campaign Automation Type tiktok_campaign_automation_type campaign_automation_type
TikTok - SmartPlus Ad ID tiktok_smartplus_ad_id ad_id_v2 / smart_plus_ad_id
TikTok - SmartPlus Ad Name tiktok_smartplus_ad_name ad_id_v2 / smart_plus_ad_id
TikTok - Post ID tiktok_post_id post_id
Age age age
Gender gender gender
Metrics
Comments comments comments
Likes likes likes
Network Clicks adn_clicks clicks
Network Impressions adn_impressions impressions
Network Installs adn_installs

real_time_conversion

(backup option: app_installs)

Note: If app_installs is configured as the default Network Installs metric, the Country dimension may not be available in the Audience Report.

Original Cost adn_original_cost stat_cost
Original Currency adn_original_currency currency
Page Follows
 		page_follows follows
Shares
 		shares shares
Video Views video_views total_play
Video Views - 25% video_views_25pct play_first_quartile
Video Views - 50% video_views_50pct play_midpoint
Video Views - 75% video_views_75pct play_third_quartile
Completed Video Views completed_video_views play_over

Singular는 이 파트너의 캠페인 속성 가져오기도 지원합니다. 자세한 내용은 여기를 참조하세요.

설정 안내

설정 단계

TikTok For Business 데이터 커넥터를 설정하려면 다음과 같이 하세요:

  1. Singular 계정에서 다음으로 이동합니다: Settings > Data Connectors.

    screenshot--2019.08.11-12-54-10.png

  2. Add New Connector를 클릭하고 "TikTok"을 입력하기 시작합니다. 표시되는 목록에서 "TikTok Ads"를 선택합니다.

    Screen_Shot_2021-03-02_at_17.09.53.png

  3. 열리는 구성 창에서 Sign In with TikTok을 클릭하고 TikTok For Business 계정에 로그인합니다.

    Screen_Shot_2021-03-02_at_17.11.10.png

  4. TikTok 플랫폼에서 Singular에 TikTok 데이터 접근 권한을 부여할지 묻습니다. Agree to the Platform Service Agreement 체크박스를 선택한 다음 Confirm을 클릭합니다.

    Screen_Shot_2021-03-02_at_17.20.30.png

  5. 권한을 부여하면 Singular의 구성 창에 연결되었음이 표시됩니다. 창을 닫아도 됩니다.

  6. 이제 TikTok이 데이터 커넥터 목록에 표시됩니다. Singular가 첫 번째 데이터 가져오기를 수행하는 동안 데이터 커넥터 상태는 "Pending"입니다. 첫 번째 데이터 가져오기가 완료되면 상태가 "Active"로 변경됩니다.

    Screen_Shot_2021-03-02_at_17.31.58.png

  7. 데이터 커넥터가 Singular로 데이터를 성공적으로 가져오면 TikTok 데이터가 포함된 리포트를 실행할 수 있습니다. 자세한 내용은 리포트 FAQ, Singular API 레퍼런스, Singular 데이터 목적지 FAQ를 참조하세요.

    샘플 리포트:

    Screen_Shot_2021-03-02_at_17.49.17.png

추가 메트릭(전환 이벤트)

Singular는 다음에서 메트릭을 가져옵니다: TikTok For Business 메트릭 목록. 기본적으로 일반 이벤트는 "in-app events metrics" 섹션에서 가져오고, SKAdNetwork 이벤트는 목록의 "Supported SKAN Metrics" 섹션에서 가져옵니다. 이 외에도 Singular에서 전환 이벤트를 생성하여 원하는 메트릭을 가져올 수 있습니다.

전환 이벤트를 생성하려면 다음과 같이 하세요:

  1. Singular에서 다음으로 이동합니다: Settings > Events. Custom Events와 Conversion Events 탭이 모두 있는 경우 Conversion Events를 선택합니다.
  2. New Event를 클릭합니다.

  3. TikTok Ads 드롭다운에서 원하는 메트릭을 선택합니다.

    다음 날 Singular가 계정의 일일 데이터를 가져올 때 전환 완료 수도 함께 가져옵니다.

  4. 새 이벤트에 데이터가 채워지면 Reports 페이지에서 리포트를 실행하고, Events 드롭다운에서 생성한 전환 이벤트를 선택합니다.

screenshot-docs.google.com-2021.11.24-16_28_51.png

TikTok Upgraded Smart+ 캠페인

TikTok이 자동화 제품군을 발전시킴에 따라, Singular는 Upgraded Smart+ 캠페인 구조를 완전히 파악할 수 있도록 리포팅을 업데이트하고 있습니다. TikTok은 Smart Campaigns (곧 지원 중단 예정)에서 Upgraded Smart+ 모델로 전환하고 있습니다.

이번 업데이트의 주요 목표는 이러한 새로운 자동화 유형 전반에서 세분화된 데이터와 결합된 데이터의 균형을 제공하는 것입니다.

무엇이 변경되나요?

이 전환을 지원하기 위해 2026년 3월부터 다음 리포팅 필드를 추가합니다:

  • TikTok - Campaign Automation:이 필드는 사용된 자동화 로직을 식별하여 캠페인을 Manual, Smart, 또는 Upgraded Smart+중 하나로 분류합니다.
  • TikTok - Upgraded Smart+ Ad ID & Name:이 필드들은 크리에이티브 바로 위에 위치하는 새로운 리포팅 계층을 나타냅니다. 이 계층은 여러 크리에이티브를 담는 컨테이너 역할을 합니다.

참고: Upgraded Smart+ Ad ID와 Name은 네트워크 측 필드입니다. 이로 인해 새로운 구조 계층이 추가되지만, 크리에이티브 데이터는 전체적인 성과 트래킹을 보장하기 위해 계속 결합됩니다.