tiktok-creative-center/
ad-analysis

광고 ID로 TikTok Creative Center 인기 광고 하나를 분석해 광고 상세, 노출 백분위, 노출 국가, 초 단위 클릭률 곡선과 시청 유지율 곡선을 받습니다.

TikTok Creative Center Ad Analysis API

광고 ID 입력
시청 유지율 곡선
클릭률 곡선
요청당 1 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

TikTok Creative Center Ad Analysis

TikTok Creative Center의 광고 분석은 인기 광고를 1초 단위로 따라가며, 순간마다 클릭이 얼마나 강하게 일어나는지와 아직 시청 중인 비율을 곡선으로 보여 주고, 광고의 캡션, 목표, 노출 국가, 클릭률, 비슷한 광고 중 노출 순위를 함께 담습니다. 영상과 나란히 놓고 곡선을 읽으면 오프닝이 시청자를 얼마나 붙잡는지, 언제 떠나는지, 어느 장면에서 클릭이 일어나는지 알 수 있습니다.

TikTok Creative Center Ad Analysis API 주요 기능

  • 초 단위 시청 유지율retention_curve에 0초부터 센 각 초에 아직 시청 중인 시청자 비율이 나열됩니다.
  • 초 단위 클릭 강도click_through_curve는 초마다의 상대적 클릭률 강도를 0~1 척도로 알려 주어, 행동을 이끄는 순간을 짚어 줍니다.
  • 노출 규모의 순위impressions_percentile은 비슷한 광고 가운데 이 광고의 노출이 어디쯤인지 0에서 1 사이로 나타냅니다.
  • 곡선 뒤에 있는 광고 레코드같은 결과에 캡션, industry, objective, ctr, likes, countries, landing_page_url, 영상이 들어 있어 곡선을 광고 자체와 함께 읽을 수 있습니다.

TikTok Creative Center Ad Analysis API 매개변수

매개변수필수설명
ad_id필수TikTok Creative Center Top Ads 결과에서 가져온 광고 ID입니다.

TikTok Creative Center Ad Analysis API 사용 방법

Top Ads에서 광고 ID를 가져와 분석 결과를 읽습니다.

  1. TikTok Creative Center Top Ads로 광고를 수집한 뒤 id를 복사합니다.
  2. {"ad_id": "7697084527089729557"}을 /v1/tiktok-creative-center/ad-analysis로 POST합니다.
  3. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 results.items의 레코드 1건을 읽습니다.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ad_id":"7697084527089729557"}'

# retention_curve and click_through_curve list {second, value} points.

TikTok Creative Center Ad Analysis API 추천 활용 사례

  • 인기 광고에서 시청자가 얼마나 빨리 이탈하는지 측정: 오프닝 몇 초 동안의 retention_curve를 읽어 후킹 이후 몇 명이 남는지 확인하고, 같은 카테고리의 광고끼리 비교합니다.
  • CTA 타이밍 잡기: click_through_curve가 최고점을 찍는 초를 찾아, 그 순간 화면에 어떤 대사, 제품 컷, 혜택이 나오는지 확인합니다.
  • 소재를 가져오기 전에 광고 도달 범위 점검: countries와 impressions_percentile로 광고가 어디서 얼마나 넓게 집행됐는지 확인한 뒤, 다른 시장에 같은 접근을 적용합니다.

TikTok Creative Center Ad Analysis API 활용 팁

  • click_through_curve는 0~1의 상대 점수이므로, 최고점의 높이가 아니라 클릭이 언제 정점을 찍는지를 광고끼리 비교하세요.
  • 길이가 다른 곡선 전체를 평균 내지 말고, duration_seconds가 비슷한 광고끼리 같은 초의 시청 유지율을 비교하세요.
  • 모든 광고가 아니라 추려 둔 후보만 분석하세요. landing_page_url과 advertiser는 문서의 샘플에서 null이므로 이 값에 의존하지 마세요.

TikTok Creative Center Ad Analysis API 외에 TikTok Creative Center의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

다른 플랫폼 둘러보기

TikTok Creative Center 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Creative Center Ad Analysis API — 자주 묻는 질문

TikTok Creative Center Ad Analysis API는 광고 ID로 TikTok Creative Center의 인기 광고 하나를 분석하는 프로그래밍 인터페이스입니다. 광고 상세, 노출 백분위, 노출 국가, 초 단위 클릭률 곡선과 시청 유지율 곡선을 반환합니다.

TikTok Creative Center Top Ads 결과의 id를 사용하세요. Top Ads에 없는 광고나 일반 TikTok 동영상에는 여기서 통하는 ID가 없습니다.

각 점은 0초부터 센 초와 0~1 값으로 이루어집니다. retention_curve는 아직 시청 중인 시청자 비율이고, click_through_curve는 상대적 클릭률 강도입니다. 문서의 샘플에서는 시청 유지율이 1초에 0.35까지 떨어지고 클릭은 3초에 정점을 찍습니다.

Top Ads에 올라온 광고라면 누가 집행하든 볼 수 있습니다. TikTok 자체 광고 리포트는 내가 집행하는 캠페인만 다룹니다.

정해진 기준 숫자는 없습니다. 알려진 경험칙은 제각각이고 이 엔드포인트도 기준을 정하지 않습니다. 같은 카테고리의 다른 인기 광고와 같은 초에서 비교해 판단하세요.

알 수 없는 ad_id는 작업이 실패하며 크레딧이 환불됩니다. 분석에 성공하면 1 크레딧이 차감됩니다.