Yahooリスティング広告(検索広告)と成果連携(コンバージョンAPI連携)したいです – 株式会社サブスクライン

前提・準備

項目	内容
Yahoo APP ID	Yahoo デベロッパーネットワークの「アプリケーション ID (Client ID)」。未取得の場合は Developer Console → 新規アプリで発行してください。Yahoo! Ads Developer
CLIENT_ID	サブスクラインのクライアント ID。 1) LINEログインのみ利用中 → LINEログインチャネル編集画面で一時的に「ミニアプリ」を選択し表示された値をメモ 2) ミニアプリ利用中 → LIFF アプリ編集画面のエンドポイント URL 内に記載されています。
コンバージョン ID／ラベル	「ツール > コンバージョン測定」で新規作成し、タグを表示をクリックするとスクリプト内に `yahoo_conversion_id` と `yahoo_conversion_label` が並んでいます。プランB

検索広告では yahoo_conversion_id / yahoo_conversion_label、ディスプレイ広告では yahoo_ydn_conv_io / yahoo_ydn_conv_label が使われる点に注意してください。

手順

1 | Yahoo 検索広告でコンバージョン設定を作成

Yahoo 広告管理ツールにログイン
ツール → コンバージョン測定 → 新規設定
種別「ウェブ」、目的を選択して保存
タグを表示 をクリックし、スクリプト内から
- yahoo_conversion_id（10 桁）
- yahoo_conversion_label（20 文字）
  を控えます。プランB

2 | サブスクラインで自動応答（ポストバック）を設定

自動応答 › 成果条件 で対象イベント（例：購入完了）を指定

通知方法 > 外部 URL へ通知 を選択し、以下を貼り付け

https://api.subscline.jp/api/v1/client/##CLIENT_ID##/postback/post
?header={"User-Agent":"Yahoo+AppID+##YAHOO_APP_ID##","Content-Type":"application/json"}
&body={"yclid":"{referer.yclid}","event_time":"{{now}}","yahoo_conversion_id":"##YAHOO_CONVERSION_ID##","yahoo_conversion_label":"##YAHOO_CONVERSION_LABEL##"}
&url=https://ads-cv.yahooapis.jp/v1/

## で囲まれた４か所を自社値に置換し保存

3 | パラメータ仕様

プレースホルダー	意味	必須	補足
`{referer.yclid}`	クリック時に自動付与される YCLID	◯
`##YAHOO_APP_ID##`	Yahoo APP ID	◯	例：dj0zaiZpPXN1YnNjbGluZQ--
`##CLIENT_ID##`	サブスクラインクライアント ID	◯	24 文字英数字
`##YAHOO_CONVERSION_ID##`	コンバージョン ID	◯	10 桁数値（検索広告）
`##YAHOO_CONVERSION_LABEL##`	コンバージョンラベル	◯	20 文字英数（検索広告）

動作確認

広告経由でテストCV → 30 分～1 時間後に Yahoo 広告管理画面で CV が 1 件増えているか確認
反映されない場合は下記をチェック

チェック項目	主な原因
YCLID が送信されているか	自動タグがオフ／URL で消失
`event_time` が 90 日以内か	サーバー時刻のずれ
APP ID 誤り	「Yahoo+AppID+」プレフィックスを含め忘れ
HTTP 400	`header` または `body` が JSON になっていない

Yahoo 側 API はヘッダー/ボディとも JSON 文字列 で受け取り、壊れた JSON は HTTP 400 で返します。stape.io

FAQ

質問	回答
ディスプレイ広告と兼用できますか？	できます。ディスプレイ用は `yahoo_ydn_conv_io / yahoo_ydn_conv_label` を送るだけでエンドポイントは同じです。docs.tealium.com
`event_time` を送らないとどうなりますか？	送信しなければサーバー受信時刻が自動で入ります。
YCLID が空でも登録できますか？	いいえ。少なくとも `yclid` かハッシュ化メール/電話のいずれかが必須です。

これで Yahoo 検索広告 ↔ サブスクライン のサーバー間コンバージョン連携は完了です。