転送元 - Yahoo!ディスプレイ広告(運用型)
  • 31 Jan 2024
  • ダーク
    ライト
  • PDF

転送元 - Yahoo!ディスプレイ広告(運用型)

  • ダーク
    ライト
  • PDF

Article Summary

概要

Yahoo!ディスプレイ広告(運用型)からデータを転送する設定のヘルプページです。
Yahoo!広告 APIを利用し、データの取得を行います。

制約

設定項目

STEP1 基本設定

項目名必須デフォルト値内容
Yahoo! API接続情報Yes-Yahoo! APIの接続情報を選択してください。
取得方法Yesレポート取得レポートで取得したい場合はレポート取得、スタッツで取得したい場合は統計情報取得を指定してください。
アカウントIDYes-スポンサードサーチのアカウント管理画面から取得対象のアカウントIDを登録してください。
タイプNo-ターゲットで統計情報取得を選択した場合、ここでタイプを指定してください。なお、現在
・CAMPAIGN
・ADGROUP
・AD
のタイプに対応しております。
データ取得期間Yes-データを取得したい期間を指定します。開始日、終了日両方を入力してください。
YYMMDD の形式で入力してください。
また、カスタム変数を設定することで実際の転送時に対応した日付を選択することも可能です。
カラムNo-転送したいカラム情報を入力してください。
設定できるカラムは取得方法によって異なります。
詳細は後述をご参照ください。
カラムについて

APIアップデートにより、旧指標は廃止されました。
上記に伴い、今後はカラム名に「(旧)」を含むカラムが指定されている場合、自動的に新カラムが取得されます

  • 例. 「CLICK_RATE_PREV (クリック率(旧))」が指定されている場合、自動的に「CLICK_RATE (クリック率)」が取得される

レポート取得の場合

広告レポート(アカウントレポート、キャンペーンレポート、広告グループレポート、リンク先URLレポート)
※STEP1にて指定した項目によっては、組み合わせ不可が原因でエラーが発生する場合があります。具体的な組み合わせ不可能なカラムについてはこちらを参照してください。
カラム項目には以下の値を設定できます。

カラム名内容推奨型動作区分(*1)
ACCOUNT_IDアカウントIDLONGATTRIBUTE
ACCOUNT_NAMEアカウント名STRINGATTRIBUTE
CAMPAIGN_IDキャンペーンIDLONGATTRIBUTE
CAMPAIGN_NAMEキャンペーン名STRINGATTRIBUTE
ADGROUP_ID広告グループIDLONGATTRIBUTE
ADGROUP_NAME広告グループ名STRINGATTRIBUTE
AD_ID広告IDLONGATTRIBUTE
AD_NAME広告名STRINGATTRIBUTE
AD_TYPE広告タイプSTRINGATTRIBUTE
PREF_ID都道府県IDSTRINGSEGMENT
PREF_NAME都道府県STRINGSEGMENT
CITY_ID市区郡IDSTRINGSEGMENT
CITY_NAME市区郡STRINGSEGMENT
WARD_ID行政区IDSTRINGSEGMENT
WARD_NAME行政区STRINGSEGMENT
GENDER性別STRINGSEGMENT
AGE年齢STRINGSEGMENT
MONTHSTRINGSEGMENT
DAYSTRINGSEGMENT
HOUR時間LONGSEGMENT
DELIVER広告掲載方式STRINGATTRIBUTE
DEVICEデバイスSTRINGSEGMENT
AD_STYLE掲載フォーマット(画像タイプ)STRINGSEGMENT
MEDIA_IDメディアIDSTRINGSEGMENT
MEDIA_NAMEメディア名STRINGSEGMENT
MEDIA_FILE_NAMEファイル名STRINGSEGMENT
MEDIA_AD_FORMATピクセルサイズSTRINGSEGMENT
AD_TITLEタイトルSTRINGATTRIBUTE
DESCRIPTION1説明文1STRINGATTRIBUTE
DESCRIPTION2説明文2STRINGATTRIBUTE
DISPLAY_URL表示URLSTRINGATTRIBUTE
SEARCHKEYWORD_IDサーチキーワードIDLONGSEGMENT
SEARCHKEYWORDサーチキーワードSTRINGSEGMENT
CONVERSION_CATEGORYコンバージョン測定の目的STRINGSEGMENT
CARRIERキャリアSTRINGSEGMENT
AD_LAYOUTレイアウトSTRINGATTRIBUTE
IMAGE_OPTION画像自動付与STRINGSEGMENT
CONVERSION_NAMEコンバージョン名STRINGATTRIBUTE
OSOSSTRINGSEGMENT
APPLIウェブ/アプリSTRINGSEGMENT
CAMPAIGN_TYPEキャンペーンタイプSTRINGATTRIBUTE
APP_IDアプリID/パッケージ名STRINGATTRIBUTE
APP_NAMEアプリ名STRINGATTRIBUTE
APP_OSアプリOSSTRINGATTRIBUTE
CAMPAIGN_GOALSキャンペーン目的STRINGSEGMENT
CAMPAIGN_BUYING_TYPEキャンペーン購入タイプSTRINGATTRIBUTE
DESTINATION_URL_CAMPAIGN_BANNERリンク先URL(キャンペーンバナー)STRINGATTRIBUTE
IMPSインプレッション数LONGMETRIC
CLICK_RATEクリック率DOUBLEMETRIC
COSTコストDOUBLEMETRIC
CLICKクリック数LONGMETRIC
AVG_CPC平均CPCDOUBLEMETRIC
AVG_DELIVER_RANK平均掲載順位DOUBLEMETRIC
TOTAL_VIEWABLE_IMPSメジャードインプレッション数(旧)LONGMETRIC
VIEWABLE_IMPSビューアブルインプレッション数LONGMETRIC
INVIEW_RATEビューアブルインプレッション率(旧)DOUBLEMETRIC
INVIEW_CLICKビューアブルクリック数(旧)LONGMETRIC
INVIEW_CLICK_RATEビューアブルクリック率(旧)DOUBLEMETRIC
AVG_CPV平均CPVDOUBLEMETRIC
VIDEO_VIEWS_TO_25動画の25%再生数LONGMETRIC
VIDEO_VIEWS_TO_50動画の50%再生数LONGMETRIC
VIDEO_VIEWS_TO_75動画の75%再生数LONGMETRIC
VIDEO_VIEWS_TO_95動画の95%再生数LONGMETRIC
VIDEO_VIEWS_TO_100動画の100%再生数LONGMETRIC
AVG_PERCENT_VIDEO_VIEWED動画の平均再生開始率DOUBLEMETRIC
AVG_DURATION_VIDEO_VIEWED動画の平均再生時間(秒)DOUBLEMETRIC
VIDEO_VIEWS動画の再生開始数LONGMETRIC
PAID_VIDEO_VIEWS課金が発生した動画再生数(CPV課金キャンペーンのみ)LONGMETRIC
PAID_VIDEO_VIEW_RATE課金が発生した動画再生率(CPV課金キャンペーンのみ)DOUBLEMETRIC
VIDEO_VIEWS_TO_3_SEC動画の3秒再生数LONGMETRIC
CONVERSIONSコンバージョン数LONGMETRIC
CONV_RATEコンバージョン率DOUBLEMETRIC
COST_PER_CONVコスト/コンバージョン数DOUBLEMETRIC
CONV_VALUEコンバージョンの価値LONGMETRIC
VALUE_PER_CONVコンバージョンの価値/コンバージョン数DOUBLEMETRIC
ALL_CONVコンバージョン数(全て)LONGMETRIC
ALL_CONV_RATEコンバージョン率(全て)DOUBLEMETRIC
COST_PER_ALL_CONVコスト/コンバージョン数(全て)DOUBLEMETRIC
ALL_CONV_VALUEコンバージョンの価値(全て)LONGMETRIC
VALUE_PER_ALL_CONVコンバージョンの価値(全て)/コンバージョン数(全て)DOUBLEMETRIC
CONVERSIONS_VIA_AD_CLICKコンバージョン数(クリック経由)LONGMETRIC
CONVERSION_RATE_VIA_AD_CLICKコンバージョン率(クリック経由)DOUBLEMETRIC
COST_PER_CONV_VIA_AD_CLICKコスト/コンバージョン数(クリック経由)DOUBLEMETRIC
CONV_VALUE_VIA_AD_CLICKコンバージョンの価値(クリック経由)LONGMETRIC
VALUE_PER_CONV_VIA_AD_CLICKコンバージョンの価値(クリック経由)/コンバージョン数(クリック経由)DOUBLEMETRIC
CROSS_DEVICE_CONVERSIONSクロスデバイスコンバージョン数LONGMETRIC
CONV_VALUE_PER_COSTコンバージョンの価値/コストDOUBLEMETRIC
ALL_CONV_VALUE_PER_COSTコンバージョンの価値(全て)/コストDOUBLEMETRIC
CONV_VALUE_VIA_AD_CLICK_PER_COSTコンバージョンの価値(クリック経由)/コストDOUBLEMETRIC
IMPS_PREVインプレッション数(旧)LONGMETRIC
CLICK_RATE_PREVクリック率(旧)DOUBLEMETRIC
AVG_CPM平均CPMDOUBLEMETRIC
AVG_VCPM平均vCPMDOUBLEMETRIC
MEASURED_IMPSメジャードインプレッション数LONGMETRIC
VIEWABLE_CLICKビューアブルクリック数LONGMETRIC
MEASURED_IMPS_RATEメジャードインプレッション測定率DOUBLEMETRIC
VIEWABLE_IMPS_RATEビューアブルインプレッション率DOUBLEMETRIC
VIEWABLE_CLICK_RATEビューアブルクリック率DOUBLEMETRIC
VIDEO_VIEWS_TO_10_SEC動画の10秒再生数LONGMETRIC
IMPRESSION_SHAREインプレッションシェアDOUBLEMETRIC
IMPRESSION_SHARE_BUDGET_LOSSインプレッションシェア損失率(予算)DOUBLEMETRIC
IMPRESSION_SHARE_RANK_LOSSインプレッションシェア損失率(ランク)DOUBLEMETRIC

(*1)動作区分はYahoo APIにおける絞り込みの動作の種類を表しています。
  ATTRIBUTEはレポートにおける属性を表します。
  SEGMENTは検索の軸を表します。
  METRICSは絞り込みによって得られた数値を表します。

統計情報取得の場合

カラム名内容推奨型
CAMPAIGN_IDキャンペーンID(*2)LONG
CAMPAIGN_NAMEキャンペーン名(*2)STRING
ADGROUP_ID広告グループID(*2)LONG
ADGROUP_NAME広告グループ名(*2)STRING
AD_ID広告ID(*2)LONG
AD_NAME広告名(*2)STRING
IMPSインプレッション数LONG
IMPS_PREVインプレッション数(旧)LONG
CLICKクリック数LONG
CLICK_RATEクリック率DOUBLE
CLICK_RATE_PREVクリック率(旧)DOUBLE
COSTコストDOUBLE
AVG_CPC平均CPCDOUBLE
CONVERSIONSコンバージョン数LONG
CONV_RATEコンバージョン率DOUBLE
CONVERSIONS_VIA_AD_CLICKコンバージョン数(クリック経由)LONG
CONVERSION_RATE_VIA_AD_CLICKコンバージョン率(クリック経由)DOUBLE
ALL_CONVコンバージョン数(全て)LONG
ALL_CONV_RATEコンバージョン率(全て)DOUBLE
COST_PER_CONVコスト/コンバージョン数DOUBLE
CONV_VALUEコンバージョンの価値LONG
VALUE_PER_CONVコンバージョンの価値/コンバージョン数DOUBLE
CONV_VALUE_PER_COSTコンバージョンの価値/コストDOUBLE
ALL_CONV_VALUE_PER_COSTコンバージョンの価値(全て)/コストDOUBLE
CONV_VALUE_VIA_AD_CLICK_PER_COSTコンバージョンの価値(クリック経由)/コストDOUBLE
ALL_CONV_VALUEコンバージョンの価値(全て)LONG
VALUE_PER_ALL_CONVコンバージョンの価値(全て)/コンバージョン数(全て)DOUBLE
CONV_VALUE_VIA_AD_CLICKコンバージョンの価値(クリック経由)LONG
VALUE_PER_CONV_VIA_AD_CLICKコンバージョンの価値(クリック経由)/コンバージョン数(クリック経由)DOUBLE
COST_PER_CONV_VIA_AD_CLICKコスト/コンバージョン数(クリック経由)DOUBLE
COST_PER_ALL_CONVコスト/コンバージョン数(全て)DOUBLE
CROSS_DEVICE_CONVERSIONSクロスデバイスコンバージョン数LONG
AVG_DELIVER_RANK平均掲載順位DOUBLE
MEASURED_IMPSメジャードインプレッション数LONG
TOTAL_VIEWABLE_IMPSメジャードインプレッション数(旧)LONG
MEASURED_IMPS_RATEメジャードインプレッション測定率DOUBLE
VIEWABLE_IMPSビューアブルインプレッション数LONG
VIEWABLE_IMPS_RATEビューアブルインプレッション率DOUBLE
INVIEW_RATEビューアブルインプレッション率(旧)DOUBLE
VIEWABLE_CLICKビューアブルクリック数LONG
INVIEW_CLICKビューアブルクリック数(旧)LONG
VIEWABLE_CLICK_RATEビューアブルクリック率DOUBLE
INVIEW_CLICK_RATEビューアブルクリック率(旧)DOUBLE
PAID_VIDEO_VIEWS課金が発生した動画再生数(CPV課金キャンペーンのみ)LONG
PAID_VIDEO_VIEW_RATE課金が発生した動画再生率(CPV課金キャンペーンのみ)DOUBLE
AVG_CPV平均CPVDOUBLE
VIDEO_VIEWS動画の再生開始数LONG
VIDEO_VIEWS_TO_25動画の25%再生数LONG
VIDEO_VIEWS_TO_50動画の50%再生数LONG
VIDEO_VIEWS_TO_75動画の75%再生数LONG
VIDEO_VIEWS_TO_95動画の95%再生数LONG
VIDEO_VIEWS_TO_100動画の100%再生数LONG
VIDEO_VIEWS_TO_3_SEC動画の3秒再生数LONG
VIDEO_VIEWS_TO_10_SEC動画の10秒再生数LONG
AVG_PERCENT_VIDEO_VIEWED動画の平均再生開始率DOUBLE
AVG_DURATION_VIDEO_VIEWED動画の平均再生時間(秒)DOUBLE
IMPRESSION_SHAREインプレッションシェアDOUBLE
IMPRESSION_SHARE_BUDGET_LOSSインプレッションシェア損失率(予算)DOUBLE
IMPRESSION_SHARE_RANK_LOSSインプレッションシェア損失率(ランク)DOUBLE

(*2)typeがCAMPAIGNの時はCAMPAIGN_NAMECAMPAIGN_ID
  typeがADGROUPの時はCAMPAIGN_NAMECAMPAIGN_IDADGROUP_NAMEADGROUP_ID
  typeがADの時はCAMPAIGN_NAMECAMPAIGN_IDADGROUP_NAMEADGROUP_IDAD_NAMEAD_IDを指定できます。


この記事は役に立ちましたか?