転送元 - Yahoo!検索広告
  • 16 Apr 2024
  • PDF

転送元 - Yahoo!検索広告

  • PDF

Article Summary

概要

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

制約

設定項目

STEP1 基本設定

項目名必須デフォルト値内容
Yahoo!広告 API接続情報Yes-あらかじめ登録してあるYahoo!広告 API接続情報から、今回の転送設定に必要な権限を持つものを選択します。
ベースアカウントIDYes-接続情報のYahoo! JAPANビジネスIDが直接権限を持つアカウント(MCCアカウント・広告アカウント)を選択します。
選択したアカウント、およびその配下全てのアカウントに対して操作が可能になります。
アカウントIDYes-選択したベースアカウントIDで操作可能な、データ取得対象のアカウント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

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