セットアップガイド › Yahoo!広告 CAPI

Yahoo!広告コンバージョンAPIを接続する

Yahoo!広告（検索広告・ディスプレイ広告）からの友だち追加をコンバージョンとして計測し、広告の最適化精度を高めます。

仕組みの概要：
Yahoo!広告のクリック時にURLに付与される yclid をLinetraceが自動キャプチャし、友だち追加・LINE内CV発生時にYahoo!広告のCAPIへ直接コンバージョンデータを送信します。

Step 1｜Yahoo! Developer NetworkでAppIDを取得する

Yahoo!デベロッパーネットワークにアクセスし、Yahoo! JAPAN IDでログイン
「アプリケーションの管理」→「新しいアプリケーションを開発」をクリック
アプリケーション種別は 「ID連携を利用しない」 を選択
アプリケーション名に「Linetrace」と入力して登録
発行された Client ID（AppID） をコピー

注意：AppIDは第三者に開示しないでください。Linetraceでは暗号化して保存されます。

Step 2｜Yahoo!広告管理画面でコンバージョン設定値を取得する

検索広告の場合

Yahoo!検索広告の管理画面にログイン
「ツール」→「コンバージョン測定」→「コンバージョン測定の新規設定」をクリック
コンバージョン名に 「LINE友だち追加」 と入力し、コンバージョン種別は「ウェブページ」を選択
「保存してタグを取得」をクリック
表示されたタグから Conversion ID と Conversion Label をコピー

ディスプレイ広告の場合

Yahoo!ディスプレイ広告の管理画面にログイン
「ツール」→「コンバージョン測定」→「コンバージョン測定の新規設定」をクリック
コンバージョン名に 「LINE友だち追加」 と入力
「保存してタグを取得」をクリック
表示されたタグから Conv IO（yahoo_ydn_conv_ioの値）と Conv Label（yahoo_ydn_conv_labelの値）をコピー

検索広告とディスプレイ広告は 片方だけの設定でもOK です。運用している広告のみ設定してください。

Step 3｜Linetraceに設定を入力する

Linetraceダッシュボード → Yahoo!広告 CAPI 設定を開く
Step 1で取得した AppID を入力
検索広告を運用している場合：Conversion ID と Conversion Label を入力
ディスプレイ広告を運用している場合：Conv IO と Conv Label を入力
「Yahoo CAPI を有効にする」トグルをONにして「設定を保存」をクリック

Step 4｜動作を確認する

Yahoo!広告のCAPIにはMeta のようなテストイベント機能がありません。実際の広告クリックで動作確認を行います。

Yahoo!広告で配信中の広告をクリックしてLPに遷移（URLに ?yclid=... が付くことを確認）
LP上でLINE友だち追加を実行
Linetraceダッシュボードの友だち追加一覧で、該当イベントの「Yahoo CAPI」が success と表示されていることを確認
Yahoo!広告管理画面の「コンバージョン」レポートで、コンバージョンが記録されていることを確認（反映まで数時間かかる場合があります）

よくあるご質問

Q. yclid がURLに付かない場合は？

Yahoo!広告のトラッキング設定で自動タグ付与（yclid）が有効になっているか確認してください。検索広告・ディスプレイ広告それぞれの管理画面で設定できます。

Q. 検索広告とディスプレイ広告で同じyclid？

はい、同じ yclid パラメータが使用されます。Linetraceは設定された広告タイプ（検索/ディスプレイ）に応じて適切なエンドポイントに送信します。

Q. コンバージョンが管理画面に反映されない場合は？

① Linetraceダッシュボードで yahoo_capi_status が「success」になっているか確認
② AppIDが正しいか確認（エラーの場合は 401/403 が記録されます）
③ Conversion ID / Label / IO が正しいか確認
④ Yahoo!広告管理画面での反映には最大24時間かかる場合があります

設定完了

これでYahoo!広告のコンバージョン計測が有効になりました。友だち追加・LINE内CVが発生するとYahoo!広告にコンバージョンデータが自動送信されます。