目次 x
    転送元 - Yahoo!検索広告
    • 01 Aug 2023
    • 2 分で読み終わります
    • 印刷
    • ダーク
      ライト
    目次

    転送元 - Yahoo!検索広告

    • 更新日 01 Aug 2023
    • 2 分で読み終わります
    • 印刷
    • ダーク
      ライト
    Article Summary

    概要

    Yahoo!検索広告からデータを転送する設定のヘルプページです。
    Yahoo!広告 APIを利用し、データの取得を行います。

    対応プロトコル

    • データ転送（Embulk）
    • Yahoo!広告 API
      • ReportDefinitionServiceの取得：バージョンv9を使用
      • CampaignExportServiceの取得：バージョンv10を使用

    制約

    設定項目

    STEP1 基本設定

    項目名必須デフォルト値内容
    Yahoo!広告 API接続情報Yes-あらかじめ登録してあるYahoo!広告 API接続情報から、今回の転送設定に必要な権限を持つものを選択します。
    アカウントIDYes-データ取得対象のアカウントIDを入力します。
    アカウントIDは、スポンサードサーチのアカウント管理画面から確認できます。
    サービスYesReportDefinitionServiceデータ取得対象のサービスを、以下から選択します。
  • ReportDefinitionService
  • CampaignExportService

    • ReportDefinitionServiceを選択した場合

    項目名必須デフォルト値内容
    レポート種別Yes-レポート種別を選択します。各レポートごとに取得できる項目が異なります。
    データ取得期間Yes-絞り込み範囲の開始日、終了日を入力します。
    YYYYYMMDD形式で入力してください。（例: 20201119）
    カラムNo-取得対象のカラム（フィールド）を入力します。
    詳しくは、後述のReportDefinitionServiceにて取得できるフィールドを参照ください。
    フィルター設定No-インプレッションが1以上のレコードのみを転送するかどうかを選択できます。
    レポートテンプレート読み込み

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

    取得できるフィールド

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

    Yahoo!マーケティングソリューション 公式資料の記載のとおりです。
    取得したいレポート種別のcsvファイルを開き、フィールド名/Field Name列を参照ください。

    動作区分/Behavior Type

    公式資料のcsvファイルにおける動作区分/Behavior Type列は、Yahoo!広告 APIにおける絞り込みの動作の種類を表しています。

    • ATTRIBUTE：レポートにおける属性を表します。
    • SEGMENT：検索の軸を表します。
    • METRIC：絞り込みによって得られた数値を表します。
    インプレッションのない、動作区分列がSEGMENTのフィールド

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

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

    APIの仕様上、同時に取得できないフィールドの組み合わせが存在します。
    公式資料の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タイトル1Title1
    HEADLINE_2タイトル2Title2
    HEADLINE_3タイトル3Title3
    DESCRIPTION1説明文1Description1
    DESCRIPTION2説明文2Description2
    DISPLAY_URL表示URLDisplay URL
    PATH_1ディレクトリ1Directory1
    PATH_2ディレクトリ2Directory2
    ADVANCED_URL最終リンク先URLFinal URL
    ADVANCED_MOBILE_URLスマートフォン向けURLSmartphone final URL
    TRACKING_URLトラッキングURLTracking 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キャンペーンIDCampaign ID
    AD_GROUP_ID広告グループIDAd Group ID
    CRITERION_IDキーワードIDKeyword ID
    AD_ID広告IDAd ID
    AD_TRACK_IDトラッキング用広告IDAd 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広告表示オプションIDAd display option ID
    ASSET_TYPE広告表示オプションの種類Ad display option type
    ASSET_ADVANCED_URLクイックリンク最終リンク先URLQuickLink final URL
    ASSET_ADVANCED_MOBILE_URLクイックリンクスマートフォン向けURLQuickLink smartphone final URL
    ASSET_TRACKING_URLクイックリンクトラッキングURLQuickLink tracking URL
    ASSET_CUSTOM_PARAMETERクイックリンクカスタムパラメータQuickLink custom parameter
    ASSET_LINK_TEXTクイックリンクテキストQuickLink text
    ASSET_DESCRIPTION1クイックリンク説明文1QuickLink description 1
    ASSET_DESCRIPTION2クイックリンク説明文2QuickLink description 2
    ASSET_CALLOUT_TEXT補足用テキストCallout text
    ASSET_HEADER補足カテゴリーCategory
    ASSET_VALUE_1補足内容1Text 1
    ASSET_VALUE_2補足内容2Text 2
    ASSET_VALUE_3補足内容3Text 3
    ASSET_VALUE_4補足内容4Text 4
    ASSET_VALUE_5補足内容5Text 5
    ASSET_VALUE_6補足内容6Text 6
    ASSET_VALUE_7補足内容7Text 7
    ASSET_VALUE_8補足内容8Text 8
    ASSET_VALUE_9補足内容9Text 9
    ASSET_VALUE_10補足内容10Text 10
    ASSET_PHONE_NUMBER電話番号Phone Number
    CAMPAIGN_TRACK_IDトラッキング用キャンペーンIDCampaign Track ID
    AD_GROUP_TRACK_IDトラッキング用広告グループIDAd Group Track ID
    CRITERION_TRACK_IDトラッキング用キーワードIDKeyword Track ID
    この記事は役に立ちましたか?
    What's Next