Yahoo!広告

Yahoo!広告ヘルプ

インポートデータ入力仕様(キャンペーン・広告グループ・広告・ターゲティング)

ディスプレイ広告のキャンペーンエディター(以下、キャンペーンエディター)でインポート機能を利用する場合は、以下の入力仕様に従ってインポート対象のCSV(またはTSV)ファイルやテキストデータを作成してください。
本ページでは以下の項目をインポートする際の入力仕様について説明します。

  • キャンペーン
  • 広告グループ
  • 広告
  • ターゲティング
ご注意
  • 2019年8月1日に、広告タイプの名称を以下のとおり変更しました。
    - 旧「テキスト:タイトル15、説明文19-19」→ 「テキスト(説明文19-19)」
    - 旧「テキスト:タイトル15、説明文33」→ 「テキスト(説明文33)」
    - 旧「テキスト不要」→ 「バナー(画像)」
    - 旧「インバナー動画」→ 「バナー(動画)」
    - 旧「レスポンシブ」→ 「レスポンシブ(画像)」
    - 旧「動画」→ 「レスポンシブ(動画)」
  • 2020年6月22日以降、「掲載フォーマット」の指定は不要になりました。
    なお、過去にエクスポートしたファイルを利用し「掲載フォーマット」を指定した場合でも、エラーにはなりません。
項目(列)名 入力必須 説明
配信設定 各項目の配信設定を以下のいずれかの形式で入力します。
「オン」
「オフ」
「削除」
ヒント
  • 未入力の場合は「オン」が設定されます。
  • 「削除」を設定すると、対象行のデータを削除します。
キャンペーン名 キャンペーン名を入力します。
ヒント
  • 半角128文字、全角42文字まで入力可能です。
    ※半角を1文字、全角を3文字とカウントします。
  • 機種依存文字は使用できません。
  • スペースや制御文字(「Tab」キーなど)のみの名称は設定できません。
  • 同一アカウント内で重複する名称は設定できません。
広告グループ名 広告グループ名を入力します。
ヒント
  • 半角255文字、全角85文字まで入力可能です。
    ※半角を1文字、全角を3文字とカウントします。
  • 機種依存文字は使用できません。
  • スペースや制御文字(「Tab」キーなど) のみの名称は設定できません。
  • 同一キャンペーン内で重複する名称は設定できません。
広告名 広告名を入力します。
ヒント
  • 半角255文字、全角85文字まで入力可能です。
    ※半角を1文字、全角を3文字とカウントします。
  • 機種依存文字は使用できません。
  • スペースや制御文字(「Tab」キーなど)のみの名称は設定できません。
  • 同一アカウント内で重複する名称は設定できません。
コンポーネントの種類 必須 コンポーネントの種類を以下のいずれかの形式で入力します。
「キャンペーン」
「広告グループ」
「広告」
「ターゲティング」
ターゲティングの種類 コンポーネントの種類がターゲティングの場合:必須 ターゲティングの種類を以下のいずれかの形式で入力します。
「時間帯ターゲティング 」
「年齢ターゲティング」
「性別ターゲティング」
「地域ターゲティング」
「インタレストカテゴリー」
「サイトカテゴリー」
「オーディエンスカテゴリー」
「サイトリターゲティング(配信)」
「サイトリターゲティング(除外)」
「サーチキーワードターゲティング」
「プレイスメントターゲティング(配信対象)」
「プレイスメントターゲティング(配信対象外)」
キャンペーン目的 キャンペーン目的を以下のいずれかの形式で入力します。
「サイト誘導」
「動画再生」
「アプリ訴求」
「コンバージョン」
「商品リスト訴求」
キャンペーンタイプ キャンペーンタイプを以下のいずれかの形式で入力します。
「標準キャンペーン」
「アプリキャンペーン」
広告掲載方式 キャンペーンの広告掲載方式を以下のいずれかの形式で入力します。
「ターゲティング」
「インフィード広告」
「動画広告」
ヒント
「動画広告」は一部のお客様のみに提供している広告掲載方式です。
1日の予算 1日の予算を100円以上、1円単位で入力します。
例:
5000円の場合は「5000」
ヒント
・半角数字で、100~2,100,000,000の範囲内で入力してください。
・広告掲載方式が「動画広告」「PCブランドパネル(動画)」、もしくは入札戦略の課金方式が「CPV」の場合は1000円以上の金額を設定してください。
入札方法

キャンペーンまたは広告グループの入札方法を、以下のいずれかの形式で入力します。
「手動」
「自動」
「キャンペーンの入札方法を適用」(広告グループのみ)

コンバージョン単価の目標値

入札方法で「自動」を入力した場合のみ、コンバージョン単価の目標値を半角数字で1~99,999,999の範囲内で入力します。
※YDNのみ:コンバージョン単価の目標値を設定するには、キャンペーン(または広告グループ上位のキャンペーン)単位で直近30日間(または計測期間内)に15コンバージョンの実績が必要です。

入札価格調整率

コンポーネントの種類がターゲティングで、ターゲティング項目に入札価格調整率を設定するときに、半角数字で入力します。

  • 1~100:
    1%~100%の範囲で入札価格の引き上げ率を設定します。
  • -1~-90:
    -1%~-90%の範囲で入札価格の引き下げ率を設定します。

入札価格調整率を設定しない場合は、0を入力するか、空白にします。

入札価格

<広告掲載方式が「動画広告」「PCブランドパネル(動画)」以外、もしくは入札戦略の課金方式が「CPC」の場合>

広告1クリックに対する入札価格を1円~50,000円の範囲内で入力してください。キャンペーンの1日の予算を超えない金額を入力してください。

<広告掲載方式が「動画広告」「PCブランドパネル(動画)」、もしくは入札戦略の課金方式が「CPV」の場合>

動画の再生1,000回に対する入札価格を1,000円~100,000円の範囲内で入力してください。
キャンペーンの1日の予算を超えない金額を入力してください。


ヒント
広告の場合「一括入札」と入力すると、入札価格が未設定になります。
開始日 開始日を入力します。
例:
2016年12月1日の場合は「2016/12/01」
終了日 開始日を入力します。
例:
2017年1月31日の場合は「2017/01/31」
ヒント
「2037/12/30」を入力した場合、終了日は未設定になります。
フリークエンシーキャップ(階層) フリークエンシーキャップ(階層)を以下のいずれかの形式で入力します。
「キャンペーン」
「広告グループ」
「広告」
フリークエンシーキャップ(期間) フリークエンシーキャップ(期間)を以下のいずれかの形式で入力します。
「日」
「週」
「月」
フリークエンシーキャップ(回数) フリークエンシーキャップ(回数)を入力します。
ヒント
半角数字で、1~99999の範囲内で入力してください。
アプリ名 プロモーション対象のアプリの名称を入力します。
ヒント
入力したアプリ名は広告の「主体者表記」の項目に自動で設定されます。
アプリOS プロモーション対象のアプリのOSを以下のいずれかの形式で入力します。
「Android」
「iOS」
アプリID/パッケージ名 プロモーション対象のアプリのOSにあわせて、以下のいずれかを入力します。
  • iOSの場合:アプリID
  • Androidの場合:パッケージ名
画像自動付与 画像自動付与の設定を以下のいずれかの形式で入力します。
「設定する」
「設定しない」
掲載フォーマット コンポーネントの種類が広告の場合:必須 広告の掲載フォーマットを以下のいずれかの形式で入力します。
「テキスト」
「ディスプレイ」
「テンプレート」
「動画」
広告タイプ

広告タイプを以下のいずれかの形式で入力します。
「テキスト(説明文19-19)」
「テキスト(説明文33)」
「バナー(画像)」
「バナー(動画)」
「レスポンシブ(画像)」
「レスポンシブ(動画)」

ヒント
広告管理ツールのインポート用テンプレートの形式でも入力できます。
タイトル タイトルを入力します。
ヒント
  • 機種依存文字は使用できません。
  • スペースや制御文字(「Tab」キーなど)のみの名称は使用できません。
説明文1 説明文1を入力します。
ヒント
  • 機種依存文字は使用できません。
  • スペースや制御文字(「Tab」キーなど)のみの名称は使用できません。
説明文2 説明文2を入力します。
ヒント
  • 機種依存文字は使用できません。
  • スペースや制御文字(「Tab」キーなど)のみの名称は使用できません。
表示URL 表示URLを入力します。
ヒント
  • 4~29文字の範囲内で入力してください。
  • URLの先頭に「http://」「https://」は入力できません。
  • URLにディレクトリが含まれない場合、URLの末尾には「/」を入力できません。
「yahoo.co.jp/」は設定できません。
  • URLにディレクトリが含まれる場合、末尾に「/」を入力してください。
「yahoo.co.jp/developer」は設定できません。
  • 3階層以上のURLは入力できません。
「yahoo.co.jp/developer/a/」は設定できません。
リンク先URL リンク先URLを入力します。
ヒント
  • 11~1024文字の範囲内で入力してください。
  • URLの先頭に「http://」「https://」を入力してください。
  • URL内で♯(シャープ)は2つ以上使用できません。
  • ドメインに{}(中括弧)は使用できません。
  • ドメインを入力する必要があります。
  • ドメインに‐(ハイフン)と_(アンダーバー)を連続して使用できません。
主体者表記 会社名、ブランド名、商品名、サービス名のいずれかを入力します。
ヒント
  • 20文字以内で入力してください。
  • ブランド名、商品名、サービス名は商標登録されているもののみ設定できます。
ボタン ボタン名を以下のいずれかの形式で入力します。
「もっとみる」
「詳しくはこちら」
「お申込みはこちら」
「ご購入はこちら」
「ご予約はこちら」
「ご登録はこちら」
「今すぐチェック」
「今すぐ申込む」
「今すぐ購入」
「今すぐ予約」
「今すぐ登録」
「資料請求」
「お問い合わせ」
「体験する」
「物件を見る」
「ダウンロード」
「インストール」
メディア名(画像) 追加済みの画像のメディア名を入力します。
メディア名(ロゴ) 追加済みのロゴのメディア名を入力します。
メディア名(動画サムネイル) 追加済みの動画サムネイルのメディア名を入力します。
メディア名(動画) 追加済みの動画のメディア名を入力します。
年齢 年代を以下のいずれかの形式で入力します。選択した年代と推定されるユーザーにも配信する場合は、設定した年代と合わせて、「年代(推定)」の行を追加してください。

「13歳~14歳」
「13歳~14歳(推定)」
「15歳~17歳」
「15歳~17歳(推定)」
「18歳~19歳」
「18歳~19歳(推定)」
「20歳~21歳」
「20歳~21歳(推定)」
「22歳~29歳」
「22歳~29歳(推定)」
「30歳~39歳」
「30歳~39歳(推定)」
「40歳~49歳」
「40歳~49歳(推定)」
「50歳~59歳」
「50歳~59歳(推定)」
「60歳~69歳」
「60歳~69歳(推定)」
「70歳以上」
「70歳以上(推定)」
「不明」

ヒント
ターゲティングの種類が「年齢ターゲティング」、かつターゲティングの設定値に値の入力がある場合、項目ごと不要です。
性別 性別を以下のいずれかの形式で入力します。選択した性別と推定されるユーザーにも配信する場合は、設定した性別と合わせて、「性別(推定)」の行を追加してください。
「男性」
「男性(推定)」
「女性」
「女性(推定)」
「不明」
ヒント
ターゲティングの種類が「性別ターゲティング」、かつターゲティングの設定値に値の入力がある場合、項目ごと不要です。
地域 地域を入力します。
北海道網走郡
ヒント
  • 地域は都道府県、および市区群の単位で入力します。
  • 複数の地域を設定する場合は、設定する地域の数に合わせて行を追加してください。
  • ターゲティングの種類が「地域ターゲティング」、かつターゲティングの設定値に値の入力がある場合、項目ごと不要です。
曜日 曜日は以下のいずれかの形式で入力します。
「月曜日」
「火曜日」
「水曜日」
「木曜日」
「金曜日」
「土曜日」
「日曜日」
ヒント
ターゲティングの種類が「時間帯ターゲティング」、かつターゲティングの設定値に値の入力がある場合、項目ごと不要です。
開始時間 開始時間を入力します。
「0:00」「24:00」
ヒント
ターゲティングの種類が「時間帯ターゲティング」、かつターゲティングの設定値に値の入力がある場合、項目ごと不要です。
終了時間 終了時間を入力します。
「0:00」「24:00」
ヒント
ターゲティングの種類が「時間帯ターゲティング」、かつターゲティングの設定値に値の入力がある場合、項目ごと不要です。
オーディエンスカテゴリータイプ オーディエンスカテゴリータイプを以下のいずれかの形式で入力します。
「興味関心」
「購買意向」
「属性・ライフイベント」
カテゴリー サイトカテゴリー名、インタレストカテゴリー名、オーディエンスカテゴリー名のいずれかを入力します。
エンターテインメント
ヒント
ターゲティングの種類が 「インタレストカテゴリー」「サイトカテゴリー」「オーディエンスカテゴリー」のいずれか、かつターゲティングの設定値に値の入力がある場合、項目ごと不要です。
プレイスメントリスト名 リスト管理で追加済みのプレイスメントリスト名を入力します。
ヒント
ターゲティングの種類が「プレイスメントターゲティング(配信対象)」または「プレイスメントターゲティング(配信対象外)」、かつターゲティングの設定値に入力がある場合、入力不要です。
配信対象/配信対象外 コンポーネントが「ターゲティング」で、ターゲティングの種類が「プレイスメントターゲティング」の場合、配信対象/配信対象外を以下のいずれかの形式で入力します。
「配信対象」
「配信対象外」
ヒント
ターゲティングの種類に以下を入力していても、配信先の設定はターゲティングの種類より本項目が優先されます。
「プレイスメントターゲティング(配信対象)」
「プレイスメントターゲティング(配信対象外)」
ターゲットリスト名 追加済みのターゲットリスト名を入力します。
ヒント
ターゲティングの種類が「サイトリターゲティング(配信)」または「サイトリターゲティング(除外)」、かつターゲティングの設定値に入力がある場合、入力不要です。
配信/除外 コンポーネントが「ターゲティング」で、ターゲティングの種類が「サイトリターゲティング」の場合、配信/除外を以下のいずれかの形式で入力します。
「配信」
「除外」
ヒント
ターゲティングの種類に以下を入力した場合、配信先の設定はターゲティングの種類より本項目が優先されます。
「サイトリターゲティング(配信)」
「サイトリターゲティング(除外)」
サーチキーワードリスト名 追加済みのサーチキーワードリスト名を入力します。
ヒント
ターゲティングの種類が「サーチキーワードターゲティング」、かつターゲティングの設定値に入力がある場合、入力不要です。
デバイス 配信先に設定するデバイスを、以下のいずれかの形式で入力します。
「PC」
「スマートフォン」
「タブレット」
複数のデバイスを設定する場合は、設定するデバイス分の行を追加してください。
OS 配信先OSを、以下のいずれかで入力します。
「iOS」
「Android」
両方設定する場合は、行を追加してください。
※広告グループの上位キャンペーンがアプリキャンペーンの場合は設定不要です。
ウェブ/アプリ 配信先ウェブ/アプリの設定を、以下のいずれかで入力します。
「ウェブ」
「アプリ」
両方設定する場合は、行を追加してください。
キャリア 配信先キャリアの設定を、以下のいずれかの形式で入力します。
「docomo」
「KDDI」

「SoftBank」
「Y!mobile」
「その他」

複数のキャリアを設定する場合は、設定するキャリア分の行を追加してください。
OSバージョン 配信先OSバージョンの下限値を入力します。
バージョン6.0の場合は「6.0」
ターゲティングの設定値 各ターゲティング設定の項目を設定できます。
  • 「時間帯ターゲティング」の場合
    入力仕様については「曜日」「開始時間」「終了時間」の項目を参照してください。
    また、曜日・開始時間・終了時間を「|」で区切って入力すると一括指定ができます。
    土曜日の0:00~24:00の場合「土曜日|0|24」
  • 「年齢ターゲティング」の場合
    入力仕様については「年齢」の項目を参照してください。
  • 「性別ターゲティング」の場合
    入力仕様については「性別」の項目を参照してください。
  • 上記以外の、ターゲティングの種類の場合
    追加済みの地域名やリスト名、カテゴリー名を入力します。
ヒント
各ターゲティングの設定で、設定する項目(時間帯の場合、曜日、開始時間、終了時間など)が入力されている場合は入力不要です。
ラベル キャンペーン、広告グループ、広告に設定するラベルを入力します。複数指定する場合はカンマ区切りで指定してください。
ラベルA
ラベルB,ラベルC,ラベルD
ヒント
ラベルは、既存の設定を入力した内容ですべて置き換える(既存のデータを破棄し、新しいデータで上書き)ことでデータを更新します。
インプレッションビーコンURL1 - インプレッションデータの連携が可能なツールを利用される場合のみ、該当のURLを入力します。利用しない場合は空欄にしてください。
インプレッションビーコンURL2
視聴ビーコンURL(再生開始)1 - 動画視聴データを連携可能なツールへデータ連携する場合のみ該当のURLを入力します。利用しない場合は空欄にしてください。
視聴ビーコンURL(再生開始)2
視聴ビーコンURL(3秒視聴)1
視聴ビーコンURL(3秒視聴)2
視聴ビーコンURL(10秒視聴)1
視聴ビーコンURL(10秒視聴)2
視聴ビーコンURL(25%再生)1
視聴ビーコンURL(25%再生)2
視聴ビーコンURL(50%再生)1
視聴ビーコンURL(50%再生)2
視聴ビーコンURL(75%再生)1
視聴ビーコンURL(75%再生)2
視聴ビーコンURL(再生完了)1
視聴ビーコンURL(再生完了)2
第三者測定スクリプトタグsrc属性URL 効果測定 推奨パートナーが提供する測定用スクリプトタグのsrc属性に記載のURLを入力します。利用しない場合は空欄にしてください。
キャンペーンID キャンペーンIDを入力します。
半角数字の場合は「99999999」
括弧で囲う場合は「(1)」
ヒント
半角数字、または半角括弧「()」で囲った半角数字で入力してください。
※半角括弧「()」で囲ったIDはキャンペーンエディター上で作成された、アップロード前の仮のIDです。キャンペーンをインポートで修正する場合に入力してください。
広告グループID 広告グループIDを入力します。
半角数字の場合は「999999999」
括弧で囲う場合は「(1)」
ヒント
半角数字、または半角括弧「()」で囲った半角数字で入力してください。
※半角括弧「()」で囲ったIDはキャンペーンエディター上で作成された、アップロード前の仮のIDです。アップロード前の広告グループをインポートで修正する場合に入力してください。
広告ID 広告IDを入力します。
半角数字の場合は「99999999」
括弧で囲う場合は「(1)」
ヒント
半角数字、または半角括弧「()」で囲った半角数字で入力してください。
※半角括弧「()」で囲ったIDはキャンペーンエディター上で作成された、アップロード前の仮のIDです。アップロード前の広告をインポートで修正する場合に入力してください。