tiktok-ads

TikTok Ads

TikTok 広告キャンペーンを管理するための戦略ガイドです。十分に調査し、パラメーターを慎重に検証して、目的ごとに厳格な要件があるこのプラットフォームの利用をユーザーに案内してください。

このスキルは有料の TikTok 広告（TikTok Marketing API の機能）を対象とします。

要件

• Hyper MCP がインストールされ、接続されていること。 https://app.hyperfx.ai/mcp
• TikTok Marketing の連携が接続されていること（TikTok Ads Manager / Business Center）。https://app.hyperfx.ai/apps。

search("tiktok_ads_advertiser_accounts_list") で tiktok_ads_advertiser_accounts_list が見つからない場合は、作業を中止し、Hyper MCP を有効にして TikTok Marketing を接続するようユーザーに伝えてください。

このスキルのツールの実行方法

このスキルの各ツールには、正式なツール名が付いています。お使いの環境に用意されている呼び出し方法で実行してください。

環境	ツールの検索	実行
MCP クライアント（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")、次に describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"、次に hyperai describe <name>	hyperai call <name> --json '{...}'

ツールが見つからない場合、その連携は接続されていないか、ワークスペースで有効になっていません。作業を中止し、接続する連携をユーザーに伝えてください。

対象外 — 他のスキルに委ねてください

• オーガニックな TikTok 投稿（動画、写真、カルーセル — 広告費なし）→ tiktok。
• クリエイティブの生成（広告コピー、画像）→ ad-creative-generation。動画クリエイティブ → video-generation。
• 複数プラットフォームにまたがるキャンペーンの開始 → このスキルを TikTok に使用し、その後 meta-ads / google-ads を別途呼び出してください。

ツール一覧

ツール	用途
tiktok_ads_advertiser_accounts_list	アカウントの確認：接続ユーザーが利用できる広告主 ID を一覧表示します。
tiktok_ads_campaigns_get、tiktok_ads_campaigns_create、tiktok_ads_campaigns_update、tiktok_ads_campaigns_status_update	キャンペーンのライフサイクル。
tiktok_ads_ad_groups_list、tiktok_ads_ad_groups_create、tiktok_ads_ad_groups_update、tiktok_ads_ad_groups_status_update	広告グループのライフサイクル。
tiktok_ads_list、tiktok_ads_create、tiktok_ads_ad_status_update、tiktok_ads_update	広告のライフサイクルと、サポート対象のコンテンツの段階的な変更。編集前に選択したツールを確認してください。Smart+ 広告には専用ツールを使用します。
tiktok_ads_videos_upload、tiktok_ads_videos_get、tiktok_ads_videos_search	動画クリエイティブのアップロードと検索。
tiktok_ads_integrated_reports_get	パフォーマンスレポート。
tiktok_ads_custom_audiences_create、tiktok_ads_custom_audiences_list、tiktok_ads_lookalike_audiences_create	オーディエンスの管理（任意）。

フェーズ 1：アカウントの確認

初期設定

• tiktok_ads_advertiser_accounts_list() を使用して広告主 ID を取得します。
• アカウントが複数ある場合：ユーザーに選択してもらいます。
• アカウントが 1 つの場合：ユーザーに伝えて続行します。

入札ベンチマーク（任意ですが推奨）

入札価格を設定する前に、tiktok_ads_benchmarks_get を呼び出して、業界別の CPM/CPC ベンチマークを取得します。これにより、オークションで勝つには低すぎる値や、ユーザーの予算に対して高すぎる値を仮置きすることを防げます。

tiktok_ads_benchmarks_get(
    advertiser_id="123456789",
    dimensions=["industry"],
    filtering={"industry": "292801"}  # industry code from tiktok_ads_advertiser_accounts_list
)

利用可能なキャンペーン目的

目的	最適な用途	主な要件
TRAFFIC	ウェブサイトへのアクセス促進	promotion_type="WEBSITE"、CPC 課金
CONVERSIONS	購入・リードの獲得	Pixel ID、コンバージョンイベントのトラッキング
REACH	ブランド認知度の向上	手動配置のみ、CPM 課金、フリークエンシーキャップ
APP_PROMOTION	アプリのインストール促進	アプリ ID、アプリストア URL
VIDEO_VIEW	動画エンゲージメント	動画クリエイティブアセット

フェーズ 2：キャンペーンの作成

ステップ 1：キャンペーンを作成

予算要件：

• キャンペーン単位の予算は最低 $50（TikTok の要件）。
• budget_mode：BUDGET_MODE_INFINITE（CBO）、BUDGET_MODE_DAY、または BUDGET_MODE_TOTAL。

tiktok_ads_campaigns_create(
    advertiser_id="123456789",
    campaign_name="Summer Sale 2026",
    objective_type="TRAFFIC",
    budget_mode="BUDGET_MODE_DAY",
    budget=50.0,  # MINIMUM $50/day
    operation_status="ENABLE"
)

ステップ 2：広告グループを作成する

常に必須のパラメーター：

• advertiser_id、campaign_id、adgroup_name。
• location_ids（例：米国の場合は ["6252001"]）。
• schedule_type と schedule_start_time（未来の日付である必要があります）。
• billing_event（CPC、CPM、OCPM）。
• budget_mode（広告グループで必須）。

TRAFFIC キャンペーンの場合：

tiktok_ads_ad_groups_create(
    advertiser_id="123456789",
    campaign_id="1234567890123456",
    adgroup_name="Website Traffic - Summer Sale",
    location_ids=["6252001"],  # US
    schedule_type="SCHEDULE_FROM_NOW",
    schedule_start_time="2026-06-01 00:00:00",  # FUTURE DATE
    billing_event="CPC",
    budget_mode="BUDGET_MODE_DAY",
    budget=30.0,
    promotion_type="WEBSITE",        # REQUIRED for TRAFFIC
    optimization_goal="CLICK",       # REQUIRED (correct spelling)
    bid_price=0.50,
    placement_type="PLACEMENT_TYPE_AUTOMATIC",
    operation_status="ENABLE"
)

REACH キャンペーンの場合：

tiktok_ads_ad_groups_create(
    advertiser_id="123456789",
    campaign_id="1234567890123456",
    adgroup_name="Brand Awareness US",
    location_ids=["6252001"],
    schedule_type="SCHEDULE_FROM_NOW",
    schedule_start_time="2026-06-01 00:00:00",
    billing_event="CPM",                       # REQUIRED for REACH
    budget_mode="BUDGET_MODE_DAY",
    budget=30.0,
    optimization_goal="REACH",
    placement_type="PLACEMENT_TYPE_NORMAL",    # REQUIRED — automatic NOT supported
    placements=["PLACEMENT_TIKTOK"],           # REQUIRED
    bid_price=2.0,                             # REQUIRED
    frequency=3,                               # REQUIRED
    frequency_schedule=7,                      # REQUIRED
    operation_status="ENABLE"
)

ステップ 3：クリエイティブアセットをアップロードする

クリエイティブのバリエーションごとに動画を 1 本アップロードします。返された video_id を控えておいてください。ステップ 4 で必要になります。

video_response = tiktok_ads_videos_upload(
    advertiser_id="123456789",
    video_file=video_data,
    upload_type="UPLOAD_BY_FILE"
)
video_id = video_response["data"]["video_id"]

アップロード済みの動画は再利用できます。tiktok_ads_videos_search を使用して名前で既存の動画を検索するか、tiktok_ads_videos_get を使用して既知の動画 ID のメタデータを取得してください。

ステップ 4：広告を作成する

tiktok_ads_create(
    advertiser_id="123456789",
    adgroup_id="1234567890123456",
    ad_name="Summer Sale - Hero Video",
    identity_type="CUSTOMIZED_USER",   # or "AUTH_CODE" for TikTok Account spark ads
    identity_id="<advertiser_identity_id>",
    ad_format="SINGLE_VIDEO",
    video_id=video_id,
    ad_text="Limited-time summer drop. Shop now.",
    landing_page_url="https://example.com/summer",
    call_to_action="SHOP_NOW",
    operation_status="DISABLE"        # create paused, enable after review
)

広告は常に一時停止状態（operation_status="DISABLE"）で作成し、ユーザーが確認した後にのみ ENABLE に切り替えてください。

重要なパラメーターのルール

よくあるエラーと解決策

エラー	解決策
予算は最低 50 ドル必要です	TikTok ではキャンペーン予算に最低 50 ドルが設定されています。
開始時刻が過去です	schedule_start_time には未来の日付と現在の年を指定してください。
TikTok API が一部の状況で optimize_goal を拒否します	スキーマには optimize_goal と optimization_goal の両方がありますが、TikTok がほとんどの目的タイプで検証するフィールドである optimization_goal を優先してください。
手動配置のみをサポートしています	REACH では placement_type="PLACEMENT_TYPE_NORMAL" が必要です。
入札額は 0 ドルより大きい必要があります	bid_price を 0 より大きい値に設定してください。
フリークエンシーキャップを設定してください	REACH では frequency と frequency_schedule の両方が必要です。

パラメーターの依存関係

TRAFFIC 目的で必要：

• promotion_type="WEBSITE"。
• optimization_goal="CLICK"。
• billing_event="CPC"。
• bid_price は 0 より大きい値。

REACH 目的で必要：

• optimization_goal="REACH"。
• billing_event="CPM"。
• placement_type="PLACEMENT_TYPE_NORMAL"。
• placements 配列（例：["PLACEMENT_TIKTOK"]）。
• bid_price は 0 より大きい値。
• frequency と frequency_schedule。

CONVERSIONS 目的で必要：

• 接続済みの TikTok Pixel と設定済みのコンバージョンイベント。
• optimization_goal="CONVERT"（値ベースの場合は VALUE）。
• billing_event="OCPM"。
• 広告グループで pixel_id と external_action が設定されていること。

レポート

tiktok_ads_integrated_reports_get(
    advertiser_id="123456789",
    report_type="BASIC",
    data_level="AUCTION_AD",
    dimensions=["ad_id"],   # ID-based only — NOT names
    start_date="2026-04-01",
    end_date="2026-04-30",
    metrics=["impressions", "clicks", "ctr", "spend", "cpc", "cpm"],
    page_size=20
)

レポートのルール：

• stat_time_day ディメンションを使用する場合：1 回の呼び出しで指定できる期間は最大 30 日です。
• ID ベースのディメンションのみ使用してください（ad_id、campaign_id、adgroup_id。名前は使用しないでください）。
• コンバージョン指標（conversion、cost_per_conversion、conversion_rate など）には、接続済みのピクセルと設定済みのコンバージョンイベントが必要です。
• data_level はディメンションの粒度に一致している必要があります。ad_id には AUCTION_AD、adgroup_id には AUCTION_ADGROUP、campaign_id には AUCTION_CAMPAIGN を指定してください。

安全ルール

禁止事項：

• ユーザーに警告せずに、広告グループの予算を 1 日あたり 20 ドル未満に設定すること。
• 過去の schedule_start_time でキャンペーンをスケジュールすること（TikTok は分かりにくいエラーを返して拒否します）。
• REACH 広告グループと PLACEMENT_TYPE_AUTOMATIC を組み合わせること（検証に失敗してもエラーが表示されません）。
• ユーザーがクリエイティブとターゲティングを確認する前に、operation_status="ENABLE" で広告を作成すること。
• 名前ベースのディメンションでレポートを実行すること（TikTok が受け付けるのは ID ディメンションのみです）。