---
title: "転送元 - Yahoo!検索広告 | TROCCO Docs"
slug: "data-source-yahoo-search-ads"
updated: 2026-06-04T09:52:14Z
published: 2026-06-04T09:52:14Z
canonical: "documents.trocco.io/data-source-yahoo-search-ads"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documents.trocco.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 転送元 - Yahoo!検索広告

## 概要

Yahoo!検索広告からデータを転送する設定のDocsです。 Yahoo!広告 APIを利用し、データを取得します。

## 設定項目

### STEP1 基本設定

| 項目名 | 必須 | デフォルト値 | 内容 |
| --- | --- | --- | --- |
| Yahoo!広告 API接続情報 | Yes | - | あらかじめ登録してある[Yahoo!広告 API接続情報](/docs/the-authentification-of-yahoo-ads-api)から、今回の転送設定に必要な権限を持つものを選択します。 |
| ベースアカウントID | Yes | - | 接続情報のYahoo! JAPANビジネスIDが直接権限を持つアカウント（MCCアカウント・広告アカウント）を選択します。 選択したアカウント、およびその配下全てのアカウントに対して操作が可能になります。 |
| アカウントID | Yes | - | 選択したベースアカウントIDで操作可能な、データ取得対象のアカウントIDを入力します。 アカウントIDは、検索広告の管理画面から確認できます。 |
| サービス | Yes | `ReportDefinitionService` | データ取得対象のサービスを、以下から選択します。 - `ReportDefinitionService` - `CampaignExportService` |

#### `ReportDefinitionService`を選択した場合

| 項目名 | 必須 | デフォルト値 | 内容 |
| --- | --- | --- | --- |
| レポート種別 | Yes | - | レポート種別を選択します。各レポートごとに取得できる項目が異なります。 一部、取得に対応していないレポート種別があります。必要なレポート種別が見つからない場合は、弊社カスタマーサクセスまでご相談ください。 |
| データ取得期間 | Yes | - | 絞り込み範囲の開始日、終了日を入力します。 `YYYYMMDD`形式で入力してください。（例: 20201119） |
| カラム | Yes | - | 取得対象のカラム（フィールド）を入力します。 詳しくは、後述の[ReportDefinitionServiceにて取得できるフィールド](/docs/data-source-yahoo-search-ads#reportdefinitionservice%E3%81%AB%E3%81%A6%E5%8F%96%E5%BE%97%E3%81%A7%E3%81%8D%E3%82%8B%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)を参照ください。 |
| フィルター設定 | No | - | インプレッションが1以上のレコードのみを転送するかどうかを選択できます。 |

              レポートテンプレート読み込み

              

**レポート種別**にてレポートテンプレートがあるレポートを選択した場合、**レポートテンプレート読み込み**をクリックすることで、該当レポート種別の主要なフィールドを一括で設定できます。

## 取得できるフィールド

### `ReportDefinitionService`にて取得できるフィールド

[Yahoo!マーケティングソリューション 公式資料](https://github.com/yahoojp-marketing/ads-search-api-documents/tree/master/reports/v19)の記載のとおりです。 取得したいレポート種別のcsvファイルを開き、**フィールド名/Field Name**列を参照ください。

              動作区分/Behavior Type

              

[公式資料](https://github.com/yahoojp-marketing/ads-search-api-documents/tree/master/reports/v19)のcsvファイルにおける**動作区分/Behavior Type**列は、Yahoo!広告 APIにおける絞り込みの動作の種類を表しています。

- `ATTRIBUTE`：レポートにおける属性を表します。
- `SEGMENT`：検索の軸を表します。
- `METRIC`：絞り込みによって得られた数値を表します。

              インプレッションのない、動作区分列が`SEGMENT`のフィールド

              

動作区分列が`SEGMENT`のフィールドは、インプレッション数が0の場合、フィルター設定が無効であっても取得されません。

              同時取得できないフィールド

              

APIの仕様上、同時に取得できないフィールドの組み合わせが存在します。 [公式資料](https://github.com/yahoojp-marketing/ads-search-api-documents/tree/master/reports/v19)のcsvファイルにおける**組合せ不可フィールド/Not compatible fields**列を参照ください。

### `CampaignExportService`にて取得されるフィールド

**サービス**にて`CampaignExportService`を選択した場合、以下のフィールドが自動で読み込まれます。 転送時にカラム名を変更したい場合や、不要なフィールドがある場合は、転送設定STEP2のカラム定義にて編集してください。

| フィールド名 | フィールド名の概要（日本語） | フィールド名の概要（英語） |
| --- | --- | --- |
| `CAMPAIGN_NAME` | キャンペーン名 | Campaign Name |
| `AD_GROUP_NAME` | 広告グループ名 | Ad Group Name |
| `ENTITY_NAME` | コンポーネントの種類 | Component Type |
| `ENTITY_STATUS` | 配信設定 | Display Settings |
| `DISPLAY_STATUS` | 配信状況 | Display Status |
| `BULK_MATCH_TYPE` | マッチタイプ | Match Type |
| `TERM` | キーワード | Keyword |
| `MANU_OPT_BID` | 入札価格 | Bid |
| `AD_NAME` | 広告名 | Ad Name |
| `BULK_AD_TYPE` | 広告タイプ | Ad Type |
| `HEADLINE_1` | タイトル1 | Title1 |
| `HEADLINE_2` | タイトル2 | Title2 |
| `HEADLINE_3` | タイトル3 | Title3 |
| `DESCRIPTION1` | 説明文1 | Description1 |
| `DESCRIPTION2` | 説明文2 | Description2 |
| `DISPLAY_URL` | 表示URL | Display URL |
| `PATH_1` | ディレクトリ1 | Directory1 |
| `PATH_2` | ディレクトリ2 | Directory2 |
| `ADVANCED_URL` | 最終リンク先URL | Final URL |
| `ADVANCED_MOBILE_URL` | スマートフォン向けURL | Smartphone final URL |
| `TRACKING_URL` | トラッキングURL | Tracking URL |
| `CUSTOM_PARAMETER` | カスタム パラメータ | Custom Parameters |
| `BUDGET_AMOUNT` | キャンペーン予算（日額） | Campaign Daily Budget |
| `START_YMD` | キャンペーン開始日 | Campaign Start Date |
| `END_YMD` | キャンペーン終了日 | Campaign End Date |
| `PLATFORM_BID_MULTIPLIER` | スマートフォン入札価格調整率（%） | Smartphone Bid Adjustment (%) |
| `BULK_DEVICE_PREFERENCE` | 優先デバイス | Focus Device |
| `CAMPAIGN_TYPE` | キャンペーンタイプ | Campaign Type |
| `AD_ROTATION_MODE` | 効果の高い広告の優先表示 | Frequently run better-performing ads |
| `LABELS` | ラベル | Labels |
| `CAMPAIGN_ID` | キャンペーンID | Campaign ID |
| `AD_GROUP_ID` | 広告グループID | Ad Group ID |
| `CRITERION_ID` | キーワードID | Keyword ID |
| `AD_ID` | 広告ID | Ad ID |
| `AD_TRACK_ID` | トラッキング用広告ID | Ad Track ID |
| `RAS_HEADLINE_1` | タイトル1（アセット） | Title 1 (asset) |
| `RAS_HEADLINE_POSITION1` | タイトル1の表示位置 | Title 1 Position |
| `RAS_HEADLINE_2` | タイトル2（アセット） | Title 2 (asset) |
| `RAS_HEADLINE_POSITION2` | タイトル2の表示位置 | Title 2 Position |
| `RAS_HEADLINE_3` | タイトル3（アセット） | Title 3 (asset) |
| `RAS_HEADLINE_POSITION3` | タイトル3の表示位置 | Title 3 Position |
| `RAS_HEADLINE_4` | タイトル4（アセット） | Title 4 (asset) |
| `RAS_HEADLINE_POSITION4` | タイトル4の表示位置 | Title 4 Position |
| `RAS_HEADLINE_5` | タイトル5（アセット） | Title 5 (asset) |
| `RAS_HEADLINE_POSITION5` | タイトル5の表示位置 | Title 5 Position |
| `RAS_HEADLINE_6` | タイトル6（アセット） | Title 6 (asset) |
| `RAS_HEADLINE_POSITION6` | タイトル6の表示位置 | Title 6 Position |
| `RAS_HEADLINE_7` | タイトル7（アセット） | Title 7 (asset) |
| `RAS_HEADLINE_POSITION7` | タイトル7の表示位置 | Title 7 Position |
| `RAS_HEADLINE_8` | タイトル8（アセット） | Title 8 (asset) |
| `RAS_HEADLINE_POSITION8` | タイトル8の表示位置 | Title 8 Position |
| `RAS_HEADLINE_9` | タイトル9（アセット） | Title 9 (asset) |
| `RAS_HEADLINE_POSITION9` | タイトル9の表示位置 | Title 9 Position |
| `RAS_HEADLINE_10` | タイトル10（アセット） | Title 10 (asset) |
| `RAS_HEADLINE_POSITION10` | タイトル10の表示位置 | Title 10 Position |
| `RAS_HEADLINE_11` | タイトル11（アセット） | Title 11 (asset) |
| `RAS_HEADLINE_POSITION11` | タイトル11の表示位置 | Title 11 Position |
| `RAS_HEADLINE_12` | タイトル12（アセット） | Title 12 (asset) |
| `RAS_HEADLINE_POSITION12` | タイトル12の表示位置 | Title 12 Position |
| `RAS_HEADLINE_13` | タイトル13（アセット） | Title 13 (asset) |
| `RAS_HEADLINE_POSITION13` | タイトル13の表示位置 | Title 13 Position |
| `RAS_HEADLINE_14` | タイトル14（アセット） | Title 14 (asset) |
| `RAS_HEADLINE_POSITION14` | タイトル14の表示位置 | Title 14 Position |
| `RAS_HEADLINE_15` | タイトル15（アセット） | Title 15 (asset) |
| `RAS_HEADLINE_POSITION15` | タイトル15の表示位置 | Title 15 Position |
| `RAS_DESCRIPTION1` | 説明文1（アセット） | Description 1 (asset) |
| `RAS_DESCRIPTION_POSITION1` | 説明文1の表示位置 | Description 1 Position |
| `RAS_DESCRIPTION2` | 説明文2（アセット） | Description 2 (asset) |
| `RAS_DESCRIPTION_POSITION2` | 説明文2の表示位置 | Description 2 Position |
| `RAS_DESCRIPTION3` | 説明文3（アセット） | Description 3 (asset) |
| `RAS_DESCRIPTION_POSITION3` | 説明文3の表示位置 | Description 3 Position |
| `RAS_DESCRIPTION4` | 説明文4（アセット） | Description 4 (asset) |
| `RAS_DESCRIPTION_POSITION4` | 説明文4の表示位置 | Description 4 Position |
| `ASSET_ID` | 広告表示オプションID | Ad display option ID |
| `ASSET_TYPE` | 広告表示オプションの種類 | Ad display option type |
| `ASSET_ADVANCED_URL` | クイックリンク最終リンク先URL | QuickLink final URL |
| `ASSET_ADVANCED_MOBILE_URL` | クイックリンクスマートフォン向けURL | QuickLink smartphone final URL |
| `ASSET_TRACKING_URL` | クイックリンクトラッキングURL | QuickLink tracking URL |
| `ASSET_CUSTOM_PARAMETER` | クイックリンクカスタムパラメータ | QuickLink custom parameter |
| `ASSET_LINK_TEXT` | クイックリンクテキスト | QuickLink text |
| `ASSET_DESCRIPTION1` | クイックリンク説明文1 | QuickLink description 1 |
| `ASSET_DESCRIPTION2` | クイックリンク説明文2 | QuickLink description 2 |
| `ASSET_CALLOUT_TEXT` | 補足用テキスト | Callout text |
| `ASSET_HEADER` | 補足カテゴリー | Category |
| `ASSET_VALUE_1` | 補足内容1 | Text 1 |
| `ASSET_VALUE_2` | 補足内容2 | Text 2 |
| `ASSET_VALUE_3` | 補足内容3 | Text 3 |
| `ASSET_VALUE_4` | 補足内容4 | Text 4 |
| `ASSET_VALUE_5` | 補足内容5 | Text 5 |
| `ASSET_VALUE_6` | 補足内容6 | Text 6 |
| `ASSET_VALUE_7` | 補足内容7 | Text 7 |
| `ASSET_VALUE_8` | 補足内容8 | Text 8 |
| `ASSET_VALUE_9` | 補足内容9 | Text 9 |
| `ASSET_VALUE_10` | 補足内容10 | Text 10 |
| `ASSET_PHONE_NUMBER` | 電話番号 | Phone Number |
| `CAMPAIGN_TRACK_ID` | トラッキング用キャンペーンID | Campaign Track ID |
| `AD_GROUP_TRACK_ID` | トラッキング用広告グループID | Ad Group Track ID |
| `CRITERION_TRACK_ID` | トラッキング用キーワードID | Keyword Track ID |
| `ASSET_IMAGE_NAME` |  |  |
| `ASSET_ASPECT_RATIO` |  |  |
| `EXPERIMENT_TYPE` |  |  |