Yahoo!広告 オフラインコンバージョン連携
対象プラン：スタンダード、ビジネス、エキスパート、プロ
Yahoo!広告オフラインコンバージョン連携の設定について解説します。
本マニュアルの内容は、作成・更新時点の連携先仕様に基づいているため、広告プラットフォーム側の仕様変更により、一部の手順や設定が異なる場合があります。 最新情報は、ご利用サービスの公式ドキュメントやサポートサイトをご確認ください。
概要
アフィリコード・システムで計測されたYahoo!広告の成果情報をYahoo側に通知し、コンバージョンデータを共有することができます。
成果通知はメディア単位。ASP運用において、アフィリエイターにYahoo!広告に関する成果を共有したい場合などに活用できます。コンバージョンデータはHTTP通信で自動アップロードされます。
コンバージョンデータの通知タイミング
- 成果情報を翌々日にYahoo!広告側に通知します（CSV形式で出力。1日に1回、送信時刻：0時ごろ）
- 成果情報の出力対象はアフィリコード・システムの連携設定画面で選択が可能です。
広告がクリックされてから24時間経過後、インポートが可能になるYahoo側の仕様により、翌々日の成果通知としています。
- 発生成果（全て）：発生した成果が翌々日の出力対象になります
- 確定成果（承認のみ）：確定した成果が翌々日の出力対象
1. 事前確認
1. 自動タグ設定を有効にする
Yahoo!広告連携ではYCLIDパラメータを利用します。
YCLIDパラメータを付与するため、 「自動タグ設定：設定する」 にしてください。
コンバージョンのインポート機能を利用する際の設定の流れ
https://ads-help.yahoo-net.jp/s/article/H000047361?language=ja
2. Yahoo!広告APIを申し込む
スタートアップガイドに沿って申し込みを完了してください。
Yahoo!広告 APIについて
https://ads-developers.yahoo.co.jp/developercenter/ja/yahoo-ads-api/
オフラインコンバージョンの連携は 「検索広告」のみ対象です。ディスプレイ広告は対応していません。
2. API情報の入手
1. Yahoo!ビジネスセンターにログイン > API管理ツール
2. 登録アプリケーションから、クライアントIDとクライアントシークレットを控える
3. リフレッシュトークンを取得する
3. コンバージョン測定の設定
1. 検索広告 > ツール > コンバージョン測定
2. コンバージョン測定の新規設定
| 項目 | 備考 |
|---|---|
| コンバージョン名 | - 任意のコンバージョン名 - ACSのメディア連携設定 「コンバージョン名」 と一致させる必要があります |
| コンバージョン種別 | - 「インポート」 を選択 |
「インポート」以外の種別で設定するとインポートが失敗します。
その他の設定詳細は公式マニュアルを参照してください。
コンバージョン測定の新規設定（インポート）【検索広告】
https://ads-help.yahoo-net.jp/s/article/H000046005?language=ja
4. アフィリコード・システムの設定
アフィリエイター管理 > メディア一覧 > 連携設定 > Yahoo!広告
コンバージョン名は、双方の設定を完全一致させてください。
- アフィリコード・システムで設定するコンバージョン名
- Yahoo!広告で設定するコンバージョン名
| 項目 | 備考 |
|---|---|
| Yahoo!広告 CV連携設定 | 設定する |
| クライアントID | Yahoo!広告 API管理ツールから取得したID |
| クライアントシークレット | Yahoo!広告 API管理ツールから取得したID |
| リフレッシュトークン | APIコールで取得したリフレッシュトークン |
| ルートMCCアカウントID | ルートMCCアカウントID |
| アカウントID |  - 広告のアカウントID |
| コンバージョン名 | Yahoo!広告のコンバージョン測定に設定したコンバージョン名を入力 - 未入力の場合は、成果内容を出力 |
| 出力データの対象条件 | Yahoo!広告に通知する成果内容を指定 - 発生成果（全て）： 承認状態に関わらず成果発生時のデータが対象 未承認から承認に変更した場合など、ステータス変更時は対象になりません - 確定成果（承認のみ）： 成果が承認になった時点（成果確定時）のデータが対象 |
| 連携パラメータ | Yahoo!広告のクリックID yclidは、plidパラメータで受け取り、適切に処理されます ※パラメータ変換は必要ありません |
参考）Yahoo!広告のアカウント構成：https://ads-developers.yahoo.co.jp/ja/ads-api/announcement/230608.html
成果情報ついて
通知内容
Yahoo!広告に以下の成果情報を通知します。
- YCLID値
- コンバージョン名
- コンバージョン発生日時：成果発生日時
- 1コンバージョンあたりの価値：発生成果額（ネット単価）
- 通貨コード：JPY
通知の確認
ログ管理 > ポストバック通知ログ
「データ種別：Yahoo!」 で絞り込み検索できます。
ログ詳細の「CSVダウンロード」より、通知した情報がダウンロードできます。
Yahoo!広告管理画面において、インポートされた成果情報を確認してください。
インポートエラーの場合は、エラーメッセージをダウンロードし、原因を確認してください。
| エラーメッセージ | 備考 |
|---|---|
| クリックが発生してから24時間経過後、インポートが可能になります。 | - yclid発行後、24時間経過が必要 |
| 存在しないコンバージョン名が指定されています。 | - ACSで設定したコンバージョン名とYahoo!広告のコンバージョン名が一致しているか確認してください - 新規設定したコンバージョン測定は数時間後、インポート可能になります |
| 新規設定したコンバージョン測定は数時間後、インポート可能になります。 | - 1日ほどおいて、取り込みに失敗した成果を手動でアップロードしてください |