CData Python Connector for Yahoo! Ads

Build 25.0.9440

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 AccountId
AccountName String Account Name
CampaignID Long CampaignID
AdGroupID Long Ad Group ID
KeywordID Long Keyword ID
CampaignName String Campaign Name
AdGroupName String Ad Group Name
CustomURL String Custom URL
Keyword String Keyword
DistributionSettings String Distribution Settings
EditorialStatus String Editorial Status
AdGroupBid Long Ad Group Bid
Bid_JPY_ Long Bid (JPY)
NegativeKeywords String Negative Keywords
QualityIndex Long Quality Index
FirstPageBidEstimate Long First Page Bid Estimate
MatchType String Match Type
Cost Long Cost
Impressions Long Impressions
Clicks Long Clicks
CTR Double CTR
Avg_CPC Double Avg. CPC
ImpressionShare Double Impression Share
ExactMatchImpressionShare Double Exact Match Impression Share
QualityLostImpressionShare Double Quality Lost Impression Share
TopOfPageBidEstimate Long Top Of Page Bid Estimate
TrackingURL String Tracking URL
CustomParameters String Custom Parameters
FinalURL String Final URL
SmartphonefinalURL String Smartphone final URL
Conversions Double Conversions
Conv_Rate Double Conv. Rate
Conv_Value Double Conv. Value
CostPerConv_ Double Cost Per Conv.
ValuePerConv_ Double Value Per Conv.
AllConv_ Double All Conv.
AllConv_Rate Double All Conv. Rate
AllConv_Value Double All Conv. Value
CostPerAllConv_ Double Cost Per All Conv.
ValuePerAllConv_ Double Value Per All Conv.
Conversionsacrossdevices Double Conversions across devices
CampaignTrackingID Long Campaign Tracking ID
AdGroupTrackingID Long Ad Group Tracking ID
KeywordTrackingID Long Keyword Tracking ID
Showadson String Show ads on
ClickType String Dimension: ClickType
Device String Dimension: Device
Day String Dimension: Day
Dayofweek String Day of week
Quarter String Dimension: Quarter
Year String Dimension: Year
Month String Dimension: Month
MonthofYear String Month of Year
Week String Dimension: Week
ObjectiveofConversionTracking String Objective of Conversion Tracking
ConversionName String Conversion Name
Labels String Labels
Labels_JSON_ String Labels(JSON)
Searchabsolutetopimpressionrate Double Search absolute top impression rate
Searchtopimpressionrate Double Search top impression rate
Searchabsolutetopimpressionshare Double Search absolute top impression share
Searchtopimpressionshare Double Search top impression share
Searchlostabsolutetopimpressionshare_budget_ Double Search lost absolute top impression share (budget)
Searchlostabsolutetopimpressionshare_rank_ Double Search lost absolute top impression share (rank)
Searchlosttopimpressionshare_budget_ Double Search lost top impression share (budget)
Searchlosttopimpressionshare_rank_ Double Search lost top impression share (rank)
Keywordstatus String Keyword status
Conv_ValuePerCost Double Conv. Value Per Cost
AllConv_ValuePerCost Double All Conv. Value Per Cost
ExpectedCTR String Expected CTR
Qualityindex_hist_ Long Quality index (hist.)
ExpectedCTR_hist_ String Expected CTR (hist.)
Adrelevance String Ad relevance
Adrelevance_hist_ String Ad relevance (hist.)
Landingpageexperience String Landing page experience
Landingpageexperience_hist_ String Landing page experience (hist.)

Pseudo-Columns

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

Name Type Description
ReportDateRangeType String ReportDefinitionService ReportDateRangeType displays a date range of the report
DateRangeStartDate String The compilation start date
DateRangeEndDate String The compilation end date.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9440