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

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

    • PDF

    記事の要約

    概要

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

    制約

    設定項目

    STEP1 基本設定

    項目名必須デフォルト値内容
    Yahoo! API接続情報Yes-Yahoo! APIの接続情報を選択してください。
    取得方法Yesレポート取得レポートで取得したい場合はレポート取得、スタッツで取得したい場合は統計情報取得を指定してください。
    ベースアカウントIDYes-接続情報のYahoo! JAPANビジネスIDが直接権限を持つアカウント(MCCアカウント・広告アカウント)を選択します。
    選択したアカウント、およびその配下全てのアカウントに対して操作が可能になります。
    アカウントIDYes-選択したベースアカウントIDで操作可能な、データ取得対象のアカウントIDを入力します。
    アカウント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によって指定できる値が異なります。

    • typeがCAMPAIGNの場合:CAMPAIGN_NAMECAMPAIGN_ID
    • typeがADGROUPの場合:CAMPAIGN_NAMECAMPAIGN_IDADGROUP_NAMEADGROUP_ID
    • typeがADの場合:CAMPAIGN_NAMECAMPAIGN_IDADGROUP_NAMEADGROUP_IDAD_NAMEAD_ID

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