tiktok-creative-center/
ad-analysis

Анализируйте одно топовое объявление TikTok Creative Center по ID: данные объявления, процентиль показов, страны показа и посекундные кривые CTR и удержания.

TikTok Creative Center Ad Analysis API

Ввод по ID объявления
Кривая удержания
Кривая CTR
1 кредит за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

TikTok Creative Center Ad Analysis

Анализ объявлений в TikTok Creative Center посекундно отслеживает топовое объявление: он показывает, насколько активно зрители кликают в каждый момент и какая их доля еще смотрит, а рядом приводит подпись объявления, цель, страны показа, CTR и место его показов среди сопоставимых объявлений. Если читать кривые вместе с видео, видно, как долго вступление удерживает зрителей, когда они уходят и какой момент побуждает к клику.

Возможности TikTok Creative Center Ad Analysis API

  • Удержание по секундамretention_curve содержит долю зрителей, которые еще смотрят на каждой секунде, начиная с секунды 0.
  • Сила кликов по секундамclick_through_curve дает относительную силу CTR каждой секунды по шкале от 0 до 1 и отмечает моменты, которые побуждают к действию.
  • Место по числу показовimpressions_percentile определяет место показов объявления среди сопоставимых объявлений — от 0 до 1.
  • Запись объявления рядом с кривымиТот же результат содержит caption, industry, objective, ctr, likes, countries, landing_page_url и video, поэтому кривые можно сопоставлять с самим объявлением.

Параметры TikTok Creative Center Ad Analysis API

ПараметрыОбязательныйОписание
ad_idОбязательныйID объявления из результата TikTok Creative Center Top Ads.

Как использовать TikTok Creative Center Ad Analysis API

Возьмите ID объявления из Top Ads и получите его анализ.

  1. Соберите объявления через TikTok Creative Center Top Ads и скопируйте id.
  2. Отправьте {"ad_id": "7697084527089729557"} методом POST на /v1/tiktok-creative-center/ad-analysis.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, и читайте единственную запись в results.items.
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 за первые секунды, чтобы увидеть, сколько зрителей остается после хука, а затем сравнивайте этот показатель между объявлениями одной категории.
  • Выбор момента для призыва к действию: Найдите секунду, на которой 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, используйте эти API, когда нужен другой тип публичных данных TikTok Creative Center.

  • TikTok Creative Center Top Ads API — Просматривайте самую эффективную рекламу по ключевому слову и периоду: подписи, CTR, лайки и видео объявления.
  • TikTok Creative Center Trending Hashtags API — Получайте рейтинг трендовых хештегов страны с числом публикаций, просмотрами и кривыми популярности.
  • TikTok Creative Center Hashtag Insights API — Изучайте кривую популярности одного трендового хештега, ведущие страны и примеры видео.
  • TikTok Creative Center Top Videos API — Получайте чарт самых успешных видео страны с просмотрами и коэффициентом вовлеченности.
  • TikTok Creator Marketplace API — Получайте карточки Creator Marketplace с демографией подписчиков, медианными просмотрами и стартовыми ставками.

Другие платформы

Объединяйте данные TikTok Creative Center с публичными данными других поддерживаемых соцсетей.

TikTok Creative Center Ad Analysis API — FAQ

TikTok Creative Center Ad Analysis API — это программный интерфейс для анализа одного топового объявления TikTok Creative Center по его ID. Он возвращает данные объявления, процентиль показов, страны показа и посекундные кривые CTR и удержания.

Возьмите id результата из TikTok Creative Center Top Ads. У объявлений вне Top Ads и обычных видео TikTok нет ID, который подойдет для этого эндпоинта.

Каждая точка — это секунда, отсчитываемая от 0, со значением от 0 до 1: в retention_curve это доля зрителей, которые еще смотрят, а в click_through_curve — относительная сила CTR. В документированном примере удержание падает до 0,35 к секунде 1, а пик кликов приходится на секунду 3.

Да, для любого объявления из Top Ads, кто бы его ни запускал. Собственная рекламная отчетность TikTok охватывает только ваши кампании.

Единого числа нет: опубликованные эмпирические правила сильно расходятся, а этот эндпоинт никакого порога не задает. Оценивайте объявление в сравнении с другими топовыми объявлениями его категории на той же секунде.

Неизвестный ad_id приводит к ошибке задачи, и кредит возвращается; успешный анализ стоит 1 кредит.