CData Python Connector for Yahoo! Ads

Build 24.0.9062

ReportSearchAdsKeywords

To view the Keywords report. Simple Select statement will create and retrieve last 7 days report

Table Specific Information

Select

The 本製品 will use the Yahoo! Ads API to process WHERE clause conditions built with the following column and operator. The AccountId is required to make a request and the rest of the filter is executed client-side within the 本製品.

  • AccountId supports the '='.
  • ReportJobId supports the '='.
  • ReportDateRangeType supports the '='.
  • DateRangeStartDate supports the '='.
  • DateRangeEndDate supports the '='.
For example:
SELECT * FROM ReportSearchAdsKeywords WHERE AccountId = '125466'
SELECT * FROM ReportSearchAdsKeywords WHERE AccountId = '125466' AND ReportJobId = '123456'
SELECT * FROM ReportSearchAdsKeywords WHERE AccountId = '125466' AND ReportDateRangeType = 'LAST_7_DAYS'
SELECT * FROM ReportSearchAdsKeywords WHERE AccountId = '125466' AND ReportDateRangeType = 'CUSTOM_DATE' and DateRangeStartDate = '2022-02-12' AND DateRangeEndDate = '2022-04-29'

Note: Since the Report is Dynamic, so the columns may vary depending upon the API.

Columns

Name Type References Description
ReportJobId String ReportJobId
AccountId String アカウントID
AccountName String アカウント名
CampaignID Long キャンペーンID
AdGroupID Long 広告グループID
KeywordID Long キーワードID
CampaignName String キャンペーン名
AdGroupName String 広告グループ名
CustomURL String カスタムURL
Keyword String キーワード
DistributionSettings String 配信設定
EditorialStatus String 審査状況
AdGroupBid Long 広告グループの入札価格
Bid_JPY_ Long 入札価格
NegativeKeywords String 対象外キーワード
QualityIndex Long 品質インデックス
FirstPageBidEstimate Long 1ページ目掲載に必要な入札価格
MatchType String マッチタイプ
Cost Long コスト
Impressions Long インプレッション数
Clicks Long クリック数
CTR Double クリック率
Avg_CPC Double 平均CPC
ImpressionShare Double インプレッションシェア
ExactMatchImpressionShare Double 完全一致のインプレッションシェア
QualityLostImpressionShare Double インプレッション損失率(掲載順位)
TopOfPageBidEstimate Long 1ページ目上部掲載に必要な入札価格
TrackingURL String トラッキングURL
CustomParameters String カスタムパラメータ
FinalURL String 最終リンク先URL
SmartphonefinalURL String スマートフォン向けURL
Conversions Double コンバージョン数
Conv_Rate Double コンバージョン率
Conv_Value Double コンバージョンの価値
CostPerConv_ Double コスト / コンバージョン数
ValuePerConv_ Double 価値 / コンバージョン数
AllConv_ Double すべてのコンバージョン数
AllConv_Rate Double すべてのコンバージョン率
AllConv_Value Double すべてのコンバージョンの価値
CostPerAllConv_ Double コスト / すべてのコンバージョン数
ValuePerAllConv_ Double 価値 / すべてのコンバージョン数
Conversionsacrossdevices Double デバイスをまたいだコンバージョン数
CampaignTrackingID Long キャンペーントラッキングID
AdGroupTrackingID Long 広告グループトラッキングID
KeywordTrackingID Long キーワードトラッキングID
Showadson String 広告を表示する検索画面
ClickType String クリック種別
Device String デバイス
Day String
Dayofweek String 曜日
Quarter String 四半期
Year String 年間
Month String 毎月
MonthofYear String
Week String 毎週
ObjectiveofConversionTracking String コンバージョン測定の目的
ConversionName String コンバージョン名
Labels String ラベル
Labels_JSON_ String ラベル(JSON)
Searchabsolutetopimpressionrate Double インプレッションにおけるページ最上部の割合
Searchtopimpressionrate Double インプレッションにおけるページ上部の割合
Searchabsolutetopimpressionshare Double ページ最上部のインプレッションシェア
Searchtopimpressionshare Double ページ上部のインプレッションシェア
Searchlostabsolutetopimpressionshare_budget_ Double ページ最上部のインプレッション損失率(予算)
Searchlostabsolutetopimpressionshare_rank_ Double ページ最上部のインプレッション損失率(掲載順位)
Searchlosttopimpressionshare_budget_ Double ページ上部のインプレッション損失率(予算)
Searchlosttopimpressionshare_rank_ Double ページ上部のインプレッション損失率(掲載順位)
Keywordstatus String キーワードの状況
Conv_ValuePerCost Double コンバージョンの価値 / コスト
AllConv_ValuePerCost Double すべてのコンバージョンの価値 / コスト
ExpectedCTR String 推定クリック値
Qualityindex_hist_ Long 品質インデックス(履歴)
ExpectedCTR_hist_ String 推定クリック値(履歴)
Adrelevance String 広告の関連性
Adrelevance_hist_ String 広告の関連性(履歴)
Landingpageexperience String ランディングページの利便性
Landingpageexperience_hist_ String ランディングページの利便性(履歴)

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Name Type Description
ReportDateRangeType String レポートの集計対象期間

使用できる値は次のとおりです。TODAY, YESTERDAY, LAST_7_DAYS, LAST_WEEK, LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, THIS_MONTH_EXCEPT_TODAY, LAST_MONTH, ALL_TIME, CUSTOM_DATE, NO_RANGE

DateRangeStartDate String 集計開始日(yyyy-MM-dd) ReportDateRangeType='CUSTOM_DATE' のとき必須
DateRangeEndDate String 集計終了日(yyyy-MM-dd) ReportDateRangeType='CUSTOM_DATE' のとき必須

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9062