A Placement / Keyword performance report lets you view statistics on how your keywords are performing across selected campaigns.
Set
DefinedReportJob.selectedReportType
to Keyword to generate a Placement / Keyword Performance report. The valid aggregation types for this type of report are listed below.
The tables on this page display the following information about each column:
|
selectedColumns to include this column in your report.
The XML Response for certain columns will vary based on targeting settings. These columns have three XML Response values for keyword, site, and combined targeting, respectively.
Choose an aggregationTypes value--a set of one or more aggregation types--to see the corresponding
list of required and optional columns.
Setting DefinedReportJob.aggregationTypes to
Daily causes the report job to have the following required and optional columns:
You must include these values in DefinedReportJob.selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| Keyword | Keyword (attribute) | keyword / site / kwSite |
| KeywordId | Keyword Id (attribute) | keywordid |
You can also include these columns in selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| AdDistributionWithSearchPartners | Ad Distribution: with search partners (attribute) | adDistributionWithSearchPartners |
| AdGroup | Ad Group (attribute) | adgroup |
| AdGroupId | Ad Group Id (attribute) | adgroupid |
| AdGroupMaxCpa1 | Max CPA (attribute) | agMaxCpa |
| AdGroupStatus | Ad Group Status (attribute) | agStatus |
| AdWordsType | Ad Distribution (attribute) | adwordsType |
| AverageConversionValue2 | Value/Conv. (1-per-click) (measure) | avgConvValue |
| AverageInteractions1 | Average Interactions (measure) | averageInteractions |
| AveragePosition | Avg Position (measure) | pos |
| AvgPercentOfVideoPlayed1 | Avg Percent Played (measure) | avgPercentPlayed |
| BottomPosition | Lowest Position Preference (attribute) | bottomPosition |
| CPC | Avg CPC (measure) | cpc |
| CPM | Avg CPM (measure) | cpm |
| CTR | CTR (measure) | ctr |
| Campaign | Campaign (attribute) | campaign |
| CampaignId | Campaign Id (attribute) | campaignid |
| CampaignStatus | Campaign Status (attribute) | campStatus |
| Clicks | Clicks (measure) | clicks |
| ConversionCategory1 | Action Category (attribute) | conversioncategory |
| ConversionDescription1 | Action Description (attribute) | conversiondescription |
| ConversionName1 | Action Name (attribute) | conversionname |
| ConversionRate2 | Conv. Rate (1-per-click) (measure) | convRate |
| Conversions2 | Conversions (1-per-click) (measure) | conv |
| Cost | Cost (measure) | cost |
| CostPerConverstion2 | Cost/Conv. (1-per-click) (measure) | costPerConv |
| CostPerTransaction2 | Cost/Conv. (many-per-click) (measure) | cpt |
| CostPerVideoPlayback1 | Avg CPV (measure) | costPerVideoPlayback |
| CustomerName1 | Account (attribute) | acctname |
| CustomerTimeZone1 | Time Zone (attribute) | timezone |
| DailyBudget | Daily Budget (attribute) | budget |
| DefaultCount2 | Other Conv. (many-per-click) (measure) | defaultConv |
| DefaultValue2 | Other Conv. Value (many-per-click) (measure) | defaultConvValue |
| ExternalCustomerId1 | Customer Id (attribute) | customerid |
| FirstPageCpc3 | Est. First Page Bid (attribute) | firstPageCpc |
| Impressions | Impressions (measure) | imps |
| InteractedImpressionRate1 | Interacted Impression Rate (measure) | interactedImpressionRate |
| InteractedImpressions1 | Interacted Impressions (measure) | interactedImpressions |
| InteractionEnabledImpressions1 | Interaction-Enabled Impressions (measure) | interactionEnabledImpressions |
| InteractionRate1 | Interaction Rate (measure) | interactionRate |
| InteractionValue1 | Interaction Value (measure) | interactionValue |
| KeywordDestUrlDisplay | Keyword Destination URL (attribute) | kwDestUrl |
| KeywordMinCPCdep | Keyword Min CPC (attribute) | keywordMinCpc |
| KeywordStatus | Keyword Status (attribute) | kwStatus / siteStatus / siteKwStatus |
| KeywordTypeDisplay | Keyword Type (attribute) | kwType / siteType / kwSiteType |
| LeadCount2 | Leads Conv. (many-per-click) (measure) | leads |
| LeadValue2 | Leads Conv. Value (many-per-click) (measure) | leadValue |
| MaxContentCPC | Content Bid (attribute) | maxContentCpc |
| MaximumCPC | Current Maximum CPC (attribute) | maxCpc |
| MaximumCPM | Current Maximum CPM (attribute) | maxCpm |
| PageViewCount2 | Page View Conv. (many-per-click) (measure) | pageviews |
| PageViewValue2 | Page View Conv. Value (many-per-click) (measure) | pageviewValue |
| PreferredCPC1 | Current Preferred CPC (attribute) | preferredCpc |
| PreferredCPM1 | Current Preferred CPM (attribute) | preferredCpm |
| QualityScore | Quality Score (attribute) | qualityScore |
| SalesCount2 | Sales Conv. (many-per-click) (measure) | purchases |
| SalesValue2 | Sales Conv. Value (many-per-click) (measure) | purchaseValue |
| SignupCount2 | Sign-up Conv. (many-per-click) (measure) | signups |
| SignupValue2 | Sign-up Conv. Value (many-per-click) (measure) | signupValue |
| TopPosition | Highest Position Preference (attribute) | topPosition |
| TotalConversionValue2 | Total Conv. Value (measure) | convValue |
| TotalInteractions1 | Total Interactions (measure) | totalInteractions |
| Transactions2 | Conversions (many-per-click) (measure) | transactions |
| ValuePerClick2 | Conv. Value/Click (measure) | convVpc |
| ValuePerCost2 | Conv. Value/Cost (measure) | valueCostRatio |
| VideoPlaybackRate1 | Play Rate (measure) | playbackRate |
| VideoPlaybacks1 | Playbacks (measure) | videoPlaybacks |
| VideoPlaybacksThrough100Percent1 | Playbacks through 100 % of video (measure) | videoPlaybacksThrough100Percent |
| VideoPlaybacksThrough25Percent1 | Playbacks through 25 % of video (measure) | videoPlaybacksThrough25Percent |
| VideoPlaybacksThrough50Percent1 | Playbacks through 50 % of video (measure) | videoPlaybacksThrough50Percent |
| VideoPlaybacksThrough75Percent1 | Playbacks through 75 % of video (measure) | videoPlaybacksThrough75Percent |
| VideoSkips1 | Skips (measure) | videoSkips |
Setting DefinedReportJob.aggregationTypes to
DayOfWeek causes the report job to have the following required and optional columns:
You must include these values in DefinedReportJob.selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| Keyword | Keyword (attribute) | keyword / site / kwSite |
| KeywordId | Keyword Id (attribute) | keywordid |
You can also include these columns in selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| AdDistributionWithSearchPartners | Ad Distribution: with search partners (attribute) | adDistributionWithSearchPartners |
| AdGroup | Ad Group (attribute) | adgroup |
| AdGroupId | Ad Group Id (attribute) | adgroupid |
| AdGroupMaxCpa1 | Max CPA (attribute) | agMaxCpa |
| AdGroupStatus | Ad Group Status (attribute) | agStatus |
| AdWordsType | Ad Distribution (attribute) | adwordsType |
| AverageConversionValue2 | Value/Conv. (1-per-click) (measure) | avgConvValue |
| AverageInteractions1 | Average Interactions (measure) | averageInteractions |
| AveragePosition | Avg Position (measure) | pos |
| AvgPercentOfVideoPlayed1 | Avg Percent Played (measure) | avgPercentPlayed |
| BottomPosition | Lowest Position Preference (attribute) | bottomPosition |
| CPC | Avg CPC (measure) | cpc |
| CPM | Avg CPM (measure) | cpm |
| CTR | CTR (measure) | ctr |
| Campaign | Campaign (attribute) | campaign |
| CampaignId | Campaign Id (attribute) | campaignid |
| CampaignStatus | Campaign Status (attribute) | campStatus |
| Clicks | Clicks (measure) | clicks |
| ConversionCategory1 | Action Category (attribute) | conversioncategory |
| ConversionDescription1 | Action Description (attribute) | conversiondescription |
| ConversionName1 | Action Name (attribute) | conversionname |
| ConversionRate2 | Conv. Rate (1-per-click) (measure) | convRate |
| Conversions2 | Conversions (1-per-click) (measure) | conv |
| Cost | Cost (measure) | cost |
| CostPerConverstion2 | Cost/Conv. (1-per-click) (measure) | costPerConv |
| CostPerTransaction2 | Cost/Conv. (many-per-click) (measure) | cpt |
| CostPerVideoPlayback1 | Avg CPV (measure) | costPerVideoPlayback |
| CustomerName1 | Account (attribute) | acctname |
| CustomerTimeZone1 | Time Zone (attribute) | timezone |
| DailyBudget | Daily Budget (attribute) | budget |
| DefaultCount2 | Other Conv. (many-per-click) (measure) | defaultConv |
| DefaultValue2 | Other Conv. Value (many-per-click) (measure) | defaultConvValue |
| ExternalCustomerId1 | Customer Id (attribute) | customerid |
| FirstPageCpc3 | Est. First Page Bid (attribute) | firstPageCpc |
| Impressions | Impressions (measure) | imps |
| InteractedImpressionRate1 | Interacted Impression Rate (measure) | interactedImpressionRate |
| InteractedImpressions1 | Interacted Impressions (measure) | interactedImpressions |
| InteractionEnabledImpressions1 | Interaction-Enabled Impressions (measure) | interactionEnabledImpressions |
| InteractionRate1 | Interaction Rate (measure) | interactionRate |
| InteractionValue1 | Interaction Value (measure) | interactionValue |
| KeywordDestUrlDisplay | Keyword Destination URL (attribute) | kwDestUrl |
| KeywordMinCPCdep | Keyword Min CPC (attribute) | keywordMinCpc |
| KeywordStatus | Keyword Status (attribute) | kwStatus / siteStatus / siteKwStatus |
| KeywordTypeDisplay | Keyword Type (attribute) | kwType / siteType / kwSiteType |
| LeadCount2 | Leads Conv. (many-per-click) (measure) | leads |
| LeadValue2 | Leads Conv. Value (many-per-click) (measure) | leadValue |
| MaxContentCPC | Content Bid (attribute) | maxContentCpc |
| MaximumCPC | Current Maximum CPC (attribute) | maxCpc |
| MaximumCPM | Current Maximum CPM (attribute) | maxCpm |
| PageViewCount2 | Page View Conv. (many-per-click) (measure) | pageviews |
| PageViewValue2 | Page View Conv. Value (many-per-click) (measure) | pageviewValue |
| PreferredCPC1 | Current Preferred CPC (attribute) | preferredCpc |
| PreferredCPM1 | Current Preferred CPM (attribute) | preferredCpm |
| QualityScore | Quality Score (attribute) | qualityScore |
| SalesCount2 | Sales Conv. (many-per-click) (measure) | purchases |
| SalesValue2 | Sales Conv. Value (many-per-click) (measure) | purchaseValue |
| SignupCount2 | Sign-up Conv. (many-per-click) (measure) | signups |
| SignupValue2 | Sign-up Conv. Value (many-per-click) (measure) | signupValue |
| TopPosition | Highest Position Preference (attribute) | topPosition |
| TotalConversionValue2 | Total Conv. Value (measure) | convValue |
| TotalInteractions1 | Total Interactions (measure) | totalInteractions |
| Transactions2 | Conversions (many-per-click) (measure) | transactions |
| ValuePerClick2 | Conv. Value/Click (measure) | convVpc |
| ValuePerCost2 | Conv. Value/Cost (measure) | valueCostRatio |
| VideoPlaybackRate1 | Play Rate (measure) | playbackRate |
| VideoPlaybacks1 | Playbacks (measure) | videoPlaybacks |
| VideoPlaybacksThrough100Percent1 | Playbacks through 100 % of video (measure) | videoPlaybacksThrough100Percent |
| VideoPlaybacksThrough25Percent1 | Playbacks through 25 % of video (measure) | videoPlaybacksThrough25Percent |
| VideoPlaybacksThrough50Percent1 | Playbacks through 50 % of video (measure) | videoPlaybacksThrough50Percent |
| VideoPlaybacksThrough75Percent1 | Playbacks through 75 % of video (measure) | videoPlaybacksThrough75Percent |
| VideoSkips1 | Skips (measure) | videoSkips |
Setting DefinedReportJob.aggregationTypes to
Monthly causes the report job to have the following required and optional columns:
You must include these values in DefinedReportJob.selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| Keyword | Keyword (attribute) | keyword / site / kwSite |
| KeywordId | Keyword Id (attribute) | keywordid |
You can also include these columns in selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| AdDistributionWithSearchPartners | Ad Distribution: with search partners (attribute) | adDistributionWithSearchPartners |
| AdGroup | Ad Group (attribute) | adgroup |
| AdGroupId | Ad Group Id (attribute) | adgroupid |
| AdGroupMaxCpa1 | Max CPA (attribute) | agMaxCpa |
| AdGroupStatus | Ad Group Status (attribute) | agStatus |
| AdWordsType | Ad Distribution (attribute) | adwordsType |
| AverageConversionValue2 | Value/Conv. (1-per-click) (measure) | avgConvValue |
| AverageInteractions1 | Average Interactions (measure) | averageInteractions |
| AveragePosition | Avg Position (measure) | pos |
| AvgPercentOfVideoPlayed1 | Avg Percent Played (measure) | avgPercentPlayed |
| BottomPosition | Lowest Position Preference (attribute) | bottomPosition |
| CPC | Avg CPC (measure) | cpc |
| CPM | Avg CPM (measure) | cpm |
| CTR | CTR (measure) | ctr |
| Campaign | Campaign (attribute) | campaign |
| CampaignId | Campaign Id (attribute) | campaignid |
| CampaignStatus | Campaign Status (attribute) | campStatus |
| Clicks | Clicks (measure) | clicks |
| ConversionCategory1 | Action Category (attribute) | conversioncategory |
| ConversionDescription1 | Action Description (attribute) | conversiondescription |
| ConversionName1 | Action Name (attribute) | conversionname |
| ConversionRate2 | Conv. Rate (1-per-click) (measure) | convRate |
| Conversions2 | Conversions (1-per-click) (measure) | conv |
| Cost | Cost (measure) | cost |
| CostPerConverstion2 | Cost/Conv. (1-per-click) (measure) | costPerConv |
| CostPerTransaction2 | Cost/Conv. (many-per-click) (measure) | cpt |
| CostPerVideoPlayback1 | Avg CPV (measure) | costPerVideoPlayback |
| CustomerName1 | Account (attribute) | acctname |
| CustomerTimeZone1 | Time Zone (attribute) | timezone |
| DailyBudget | Daily Budget (attribute) | budget |
| DefaultCount2 | Other Conv. (many-per-click) (measure) | defaultConv |
| DefaultValue2 | Other Conv. Value (many-per-click) (measure) | defaultConvValue |
| ExternalCustomerId1 | Customer Id (attribute) | customerid |
| FirstPageCpc3 | Est. First Page Bid (attribute) | firstPageCpc |
| Impressions | Impressions (measure) | imps |
| InteractedImpressionRate1 | Interacted Impression Rate (measure) | interactedImpressionRate |
| InteractedImpressions1 | Interacted Impressions (measure) | interactedImpressions |
| InteractionEnabledImpressions1 | Interaction-Enabled Impressions (measure) | interactionEnabledImpressions |
| InteractionRate1 | Interaction Rate (measure) | interactionRate |
| InteractionValue1 | Interaction Value (measure) | interactionValue |
| KeywordDestUrlDisplay | Keyword Destination URL (attribute) | kwDestUrl |
| KeywordMinCPCdep | Keyword Min CPC (attribute) | keywordMinCpc |
| KeywordStatus | Keyword Status (attribute) | kwStatus / siteStatus / siteKwStatus |
| KeywordTypeDisplay | Keyword Type (attribute) | kwType / siteType / kwSiteType |
| LeadCount2 | Leads Conv. (many-per-click) (measure) | leads |
| LeadValue2 | Leads Conv. Value (many-per-click) (measure) | leadValue |
| MaxContentCPC | Content Bid (attribute) | maxContentCpc |
| MaximumCPC | Current Maximum CPC (attribute) | maxCpc |
| MaximumCPM | Current Maximum CPM (attribute) | maxCpm |
| PageViewCount2 | Page View Conv. (many-per-click) (measure) | pageviews |
| PageViewValue2 | Page View Conv. Value (many-per-click) (measure) | pageviewValue |
| PreferredCPC1 | Current Preferred CPC (attribute) | preferredCpc |
| PreferredCPM1 | Current Preferred CPM (attribute) | preferredCpm |
| QualityScore | Quality Score (attribute) | qualityScore |
| SalesCount2 | Sales Conv. (many-per-click) (measure) | purchases |
| SalesValue2 | Sales Conv. Value (many-per-click) (measure) | purchaseValue |
| SignupCount2 | Sign-up Conv. (many-per-click) (measure) | signups |
| SignupValue2 | Sign-up Conv. Value (many-per-click) (measure) | signupValue |
| TopPosition | Highest Position Preference (attribute) | topPosition |
| TotalConversionValue2 | Total Conv. Value (measure) | convValue |
| TotalInteractions1 | Total Interactions (measure) | totalInteractions |
| Transactions2 | Conversions (many-per-click) (measure) | transactions |
| ValuePerClick2 | Conv. Value/Click (measure) | convVpc |
| ValuePerCost2 | Conv. Value/Cost (measure) | valueCostRatio |
| VideoPlaybackRate1 | Play Rate (measure) | playbackRate |
| VideoPlaybacks1 | Playbacks (measure) | videoPlaybacks |
| VideoPlaybacksThrough100Percent1 | Playbacks through 100 % of video (measure) | videoPlaybacksThrough100Percent |
| VideoPlaybacksThrough25Percent1 | Playbacks through 25 % of video (measure) | videoPlaybacksThrough25Percent |
| VideoPlaybacksThrough50Percent1 | Playbacks through 50 % of video (measure) | videoPlaybacksThrough50Percent |
| VideoPlaybacksThrough75Percent1 | Playbacks through 75 % of video (measure) | videoPlaybacksThrough75Percent |
| VideoSkips1 | Skips (measure) | videoSkips |
Setting DefinedReportJob.aggregationTypes to
Quarterly causes the report job to have the following required and optional columns:
You must include these values in DefinedReportJob.selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| Keyword | Keyword (attribute) | keyword / site / kwSite |
| KeywordId | Keyword Id (attribute) | keywordid |
You can also include these columns in selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| AdDistributionWithSearchPartners | Ad Distribution: with search partners (attribute) | adDistributionWithSearchPartners |
| AdGroup | Ad Group (attribute) | adgroup |
| AdGroupId | Ad Group Id (attribute) | adgroupid |
| AdGroupMaxCpa1 | Max CPA (attribute) | agMaxCpa |
| AdGroupStatus | Ad Group Status (attribute) | agStatus |
| AdWordsType | Ad Distribution (attribute) | adwordsType |
| AverageConversionValue2 | Value/Conv. (1-per-click) (measure) | avgConvValue |
| AverageInteractions1 | Average Interactions (measure) | averageInteractions |
| AveragePosition | Avg Position (measure) | pos |
| AvgPercentOfVideoPlayed1 | Avg Percent Played (measure) | avgPercentPlayed |
| BottomPosition | Lowest Position Preference (attribute) | bottomPosition |
| CPC | Avg CPC (measure) | cpc |
| CPM | Avg CPM (measure) | cpm |
| CTR | CTR (measure) | ctr |
| Campaign | Campaign (attribute) | campaign |
| CampaignId | Campaign Id (attribute) | campaignid |
| CampaignStatus | Campaign Status (attribute) | campStatus |
| Clicks | Clicks (measure) | clicks |
| ConversionCategory1 | Action Category (attribute) | conversioncategory |
| ConversionDescription1 | Action Description (attribute) | conversiondescription |
| ConversionName1 | Action Name (attribute) | conversionname |
| ConversionRate2 | Conv. Rate (1-per-click) (measure) | convRate |
| Conversions2 | Conversions (1-per-click) (measure) | conv |
| Cost | Cost (measure) | cost |
| CostPerConverstion2 | Cost/Conv. (1-per-click) (measure) | costPerConv |
| CostPerTransaction2 | Cost/Conv. (many-per-click) (measure) | cpt |
| CostPerVideoPlayback1 | Avg CPV (measure) | costPerVideoPlayback |
| CustomerName1 | Account (attribute) | acctname |
| CustomerTimeZone1 | Time Zone (attribute) | timezone |
| DailyBudget | Daily Budget (attribute) | budget |
| DefaultCount2 | Other Conv. (many-per-click) (measure) | defaultConv |
| DefaultValue2 | Other Conv. Value (many-per-click) (measure) | defaultConvValue |
| ExternalCustomerId1 | Customer Id (attribute) | customerid |
| FirstPageCpc3 | Est. First Page Bid (attribute) | firstPageCpc |
| Impressions | Impressions (measure) | imps |
| InteractedImpressionRate1 | Interacted Impression Rate (measure) | interactedImpressionRate |
| InteractedImpressions1 | Interacted Impressions (measure) | interactedImpressions |
| InteractionEnabledImpressions1 | Interaction-Enabled Impressions (measure) | interactionEnabledImpressions |
| InteractionRate1 | Interaction Rate (measure) | interactionRate |
| InteractionValue1 | Interaction Value (measure) | interactionValue |
| KeywordDestUrlDisplay | Keyword Destination URL (attribute) | kwDestUrl |
| KeywordMinCPCdep | Keyword Min CPC (attribute) | keywordMinCpc |
| KeywordStatus | Keyword Status (attribute) | kwStatus / siteStatus / siteKwStatus |
| KeywordTypeDisplay | Keyword Type (attribute) | kwType / siteType / kwSiteType |
| LeadCount2 | Leads Conv. (many-per-click) (measure) | leads |
| LeadValue2 | Leads Conv. Value (many-per-click) (measure) | leadValue |
| MaxContentCPC | Content Bid (attribute) | maxContentCpc |
| MaximumCPC | Current Maximum CPC (attribute) | maxCpc |
| MaximumCPM | Current Maximum CPM (attribute) | maxCpm |
| PageViewCount2 | Page View Conv. (many-per-click) (measure) | pageviews |
| PageViewValue2 | Page View Conv. Value (many-per-click) (measure) | pageviewValue |
| PreferredCPC1 | Current Preferred CPC (attribute) | preferredCpc |
| PreferredCPM1 | Current Preferred CPM (attribute) | preferredCpm |
| QualityScore | Quality Score (attribute) | qualityScore |
| SalesCount2 | Sales Conv. (many-per-click) (measure) | purchases |
| SalesValue2 | Sales Conv. Value (many-per-click) (measure) | purchaseValue |
| SignupCount2 | Sign-up Conv. (many-per-click) (measure) | signups |
| SignupValue2 | Sign-up Conv. Value (many-per-click) (measure) | signupValue |
| TopPosition | Highest Position Preference (attribute) | topPosition |
| TotalConversionValue2 | Total Conv. Value (measure) | convValue |
| TotalInteractions1 | Total Interactions (measure) | totalInteractions |
| Transactions2 | Conversions (many-per-click) (measure) | transactions |
| ValuePerClick2 | Conv. Value/Click (measure) | convVpc |
| ValuePerCost2 | Conv. Value/Cost (measure) | valueCostRatio |
| VideoPlaybackRate1 | Play Rate (measure) | playbackRate |
| VideoPlaybacks1 | Playbacks (measure) | videoPlaybacks |
| VideoPlaybacksThrough100Percent1 | Playbacks through 100 % of video (measure) | videoPlaybacksThrough100Percent |
| VideoPlaybacksThrough25Percent1 | Playbacks through 25 % of video (measure) | videoPlaybacksThrough25Percent |
| VideoPlaybacksThrough50Percent1 | Playbacks through 50 % of video (measure) | videoPlaybacksThrough50Percent |
| VideoPlaybacksThrough75Percent1 | Playbacks through 75 % of video (measure) | videoPlaybacksThrough75Percent |
| VideoSkips1 | Skips (measure) | videoSkips |
Setting DefinedReportJob.aggregationTypes to
Summary causes the report job to have the following required and optional columns:
You must include these values in DefinedReportJob.selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| Keyword | Keyword (attribute) | keyword / site / kwSite |
| KeywordId | Keyword Id (attribute) | keywordid |
You can also include these columns in selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| AdDistributionWithSearchPartners | Ad Distribution: with search partners (attribute) | adDistributionWithSearchPartners |
| AdGroup | Ad Group (attribute) | adgroup |
| AdGroupId | Ad Group Id (attribute) | adgroupid |
| AdGroupMaxCpa1 | Max CPA (attribute) | agMaxCpa |
| AdGroupStatus | Ad Group Status (attribute) | agStatus |
| AdWordsType | Ad Distribution (attribute) | adwordsType |
| AverageConversionValue2 | Value/Conv. (1-per-click) (measure) | avgConvValue |
| AverageInteractions1 | Average Interactions (measure) | averageInteractions |
| AveragePosition | Avg Position (measure) | pos |
| AvgPercentOfVideoPlayed1 | Avg Percent Played (measure) | avgPercentPlayed |
| BottomPosition | Lowest Position Preference (attribute) | bottomPosition |
| CPC | Avg CPC (measure) | cpc |
| CPM | Avg CPM (measure) | cpm |
| CTR | CTR (measure) | ctr |
| Campaign | Campaign (attribute) | campaign |
| CampaignId | Campaign Id (attribute) | campaignid |
| CampaignStatus | Campaign Status (attribute) | campStatus |
| Clicks | Clicks (measure) | clicks |
| ConversionCategory1 | Action Category (attribute) | conversioncategory |
| ConversionDescription1 | Action Description (attribute) | conversiondescription |
| ConversionName1 | Action Name (attribute) | conversionname |
| ConversionRate2 | Conv. Rate (1-per-click) (measure) | convRate |
| Conversions2 | Conversions (1-per-click) (measure) | conv |
| Cost | Cost (measure) | cost |
| CostPerConverstion2 | Cost/Conv. (1-per-click) (measure) | costPerConv |
| CostPerTransaction2 | Cost/Conv. (many-per-click) (measure) | cpt |
| CostPerVideoPlayback1 | Avg CPV (measure) | costPerVideoPlayback |
| CustomerName1 | Account (attribute) | acctname |
| CustomerTimeZone1 | Time Zone (attribute) | timezone |
| DailyBudget | Daily Budget (attribute) | budget |
| DefaultCount2 | Other Conv. (many-per-click) (measure) | defaultConv |
| DefaultValue2 | Other Conv. Value (many-per-click) (measure) | defaultConvValue |
| ExternalCustomerId1 | Customer Id (attribute) | customerid |
| FirstPageCpc3 | Est. First Page Bid (attribute) | firstPageCpc |
| Impressions | Impressions (measure) | imps |
| InteractedImpressionRate1 | Interacted Impression Rate (measure) | interactedImpressionRate |
| InteractedImpressions1 | Interacted Impressions (measure) | interactedImpressions |
| InteractionEnabledImpressions1 | Interaction-Enabled Impressions (measure) | interactionEnabledImpressions |
| InteractionRate1 | Interaction Rate (measure) | interactionRate |
| InteractionValue1 | Interaction Value (measure) | interactionValue |
| KeywordDestUrlDisplay | Keyword Destination URL (attribute) | kwDestUrl |
| KeywordMinCPCdep | Keyword Min CPC (attribute) | keywordMinCpc |
| KeywordStatus | Keyword Status (attribute) | kwStatus / siteStatus / siteKwStatus |
| KeywordTypeDisplay | Keyword Type (attribute) | kwType / siteType / kwSiteType |
| LeadCount2 | Leads Conv. (many-per-click) (measure) | leads |
| LeadValue2 | Leads Conv. Value (many-per-click) (measure) | leadValue |
| MaxContentCPC | Content Bid (attribute) | maxContentCpc |
| MaximumCPC | Current Maximum CPC (attribute) | maxCpc |
| MaximumCPM | Current Maximum CPM (attribute) | maxCpm |
| PageViewCount2 | Page View Conv. (many-per-click) (measure) | pageviews |
| PageViewValue2 | Page View Conv. Value (many-per-click) (measure) | pageviewValue |
| PreferredCPC1 | Current Preferred CPC (attribute) | preferredCpc |
| PreferredCPM1 | Current Preferred CPM (attribute) | preferredCpm |
| QualityScore | Quality Score (attribute) | qualityScore |
| SalesCount2 | Sales Conv. (many-per-click) (measure) | purchases |
| SalesValue2 | Sales Conv. Value (many-per-click) (measure) | purchaseValue |
| SignupCount2 | Sign-up Conv. (many-per-click) (measure) | signups |
| SignupValue2 | Sign-up Conv. Value (many-per-click) (measure) | signupValue |
| TopPosition | Highest Position Preference (attribute) | topPosition |
| TotalConversionValue2 | Total Conv. Value (measure) | convValue |
| TotalInteractions1 | Total Interactions (measure) | totalInteractions |
| Transactions2 | Conversions (many-per-click) (measure) | transactions |
| ValuePerClick2 | Conv. Value/Click (measure) | convVpc |
| ValuePerCost2 | Conv. Value/Cost (measure) | valueCostRatio |
| VideoPlaybackRate1 | Play Rate (measure) | playbackRate |
| VideoPlaybacks1 | Playbacks (measure) | videoPlaybacks |
| VideoPlaybacksThrough100Percent1 | Playbacks through 100 % of video (measure) | videoPlaybacksThrough100Percent |
| VideoPlaybacksThrough25Percent1 | Playbacks through 25 % of video (measure) | videoPlaybacksThrough25Percent |
| VideoPlaybacksThrough50Percent1 | Playbacks through 50 % of video (measure) | videoPlaybacksThrough50Percent |
| VideoPlaybacksThrough75Percent1 | Playbacks through 75 % of video (measure) | videoPlaybacksThrough75Percent |
| VideoSkips1 | Skips (measure) | videoSkips |
Setting DefinedReportJob.aggregationTypes to
Weekly causes the report job to have the following required and optional columns:
You must include these values in DefinedReportJob.selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| Keyword | Keyword (attribute) | keyword / site / kwSite |
| KeywordId | Keyword Id (attribute) | keywordid |
You can also include these columns in selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| AdDistributionWithSearchPartners | Ad Distribution: with search partners (attribute) | adDistributionWithSearchPartners |
| AdGroup | Ad Group (attribute) | adgroup |
| AdGroupId | Ad Group Id (attribute) | adgroupid |
| AdGroupMaxCpa1 | Max CPA (attribute) | agMaxCpa |
| AdGroupStatus | Ad Group Status (attribute) | agStatus |
| AdWordsType | Ad Distribution (attribute) | adwordsType |
| AverageConversionValue2 | Value/Conv. (1-per-click) (measure) | avgConvValue |
| AverageInteractions1 | Average Interactions (measure) | averageInteractions |
| AveragePosition | Avg Position (measure) | pos |
| AvgPercentOfVideoPlayed1 | Avg Percent Played (measure) | avgPercentPlayed |
| BottomPosition | Lowest Position Preference (attribute) | bottomPosition |
| CPC | Avg CPC (measure) | cpc |
| CPM | Avg CPM (measure) | cpm |
| CTR | CTR (measure) | ctr |
| Campaign | Campaign (attribute) | campaign |
| CampaignId | Campaign Id (attribute) | campaignid |
| CampaignStatus | Campaign Status (attribute) | campStatus |
| Clicks | Clicks (measure) | clicks |
| ConversionCategory1 | Action Category (attribute) | conversioncategory |
| ConversionDescription1 | Action Description (attribute) | conversiondescription |
| ConversionName1 | Action Name (attribute) | conversionname |
| ConversionRate2 | Conv. Rate (1-per-click) (measure) | convRate |
| Conversions2 | Conversions (1-per-click) (measure) | conv |
| Cost | Cost (measure) | cost |
| CostPerConverstion2 | Cost/Conv. (1-per-click) (measure) | costPerConv |
| CostPerTransaction2 | Cost/Conv. (many-per-click) (measure) | cpt |
| CostPerVideoPlayback1 | Avg CPV (measure) | costPerVideoPlayback |
| CustomerName1 | Account (attribute) | acctname |
| CustomerTimeZone1 | Time Zone (attribute) | timezone |
| DailyBudget | Daily Budget (attribute) | budget |
| DefaultCount2 | Other Conv. (many-per-click) (measure) | defaultConv |
| DefaultValue2 | Other Conv. Value (many-per-click) (measure) | defaultConvValue |
| ExternalCustomerId1 | Customer Id (attribute) | customerid |
| FirstPageCpc3 | Est. First Page Bid (attribute) | firstPageCpc |
| Impressions | Impressions (measure) | imps |
| InteractedImpressionRate1 | Interacted Impression Rate (measure) | interactedImpressionRate |
| InteractedImpressions1 | Interacted Impressions (measure) | interactedImpressions |
| InteractionEnabledImpressions1 | Interaction-Enabled Impressions (measure) | interactionEnabledImpressions |
| InteractionRate1 | Interaction Rate (measure) | interactionRate |
| InteractionValue1 | Interaction Value (measure) | interactionValue |
| KeywordDestUrlDisplay | Keyword Destination URL (attribute) | kwDestUrl |
| KeywordMinCPCdep | Keyword Min CPC (attribute) | keywordMinCpc |
| KeywordStatus | Keyword Status (attribute) | kwStatus / siteStatus / siteKwStatus |
| KeywordTypeDisplay | Keyword Type (attribute) | kwType / siteType / kwSiteType |
| LeadCount2 | Leads Conv. (many-per-click) (measure) | leads |
| LeadValue2 | Leads Conv. Value (many-per-click) (measure) | leadValue |
| MaxContentCPC | Content Bid (attribute) | maxContentCpc |
| MaximumCPC | Current Maximum CPC (attribute) | maxCpc |
| MaximumCPM | Current Maximum CPM (attribute) | maxCpm |
| PageViewCount2 | Page View Conv. (many-per-click) (measure) | pageviews |
| PageViewValue2 | Page View Conv. Value (many-per-click) (measure) | pageviewValue |
| PreferredCPC1 | Current Preferred CPC (attribute) | preferredCpc |
| PreferredCPM1 | Current Preferred CPM (attribute) | preferredCpm |
| QualityScore | Quality Score (attribute) | qualityScore |
| SalesCount2 | Sales Conv. (many-per-click) (measure) | purchases |
| SalesValue2 | Sales Conv. Value (many-per-click) (measure) | purchaseValue |
| SignupCount2 | Sign-up Conv. (many-per-click) (measure) | signups |
| SignupValue2 | Sign-up Conv. Value (many-per-click) (measure) | signupValue |
| TopPosition | Highest Position Preference (attribute) | topPosition |
| TotalConversionValue2 | Total Conv. Value (measure) | convValue |
| TotalInteractions1 | Total Interactions (measure) | totalInteractions |
| Transactions2 | Conversions (many-per-click) (measure) | transactions |
| ValuePerClick2 | Conv. Value/Click (measure) | convVpc |
| ValuePerCost2 | Conv. Value/Cost (measure) | valueCostRatio |
| VideoPlaybackRate1 | Play Rate (measure) | playbackRate |
| VideoPlaybacks1 | Playbacks (measure) | videoPlaybacks |
| VideoPlaybacksThrough100Percent1 | Playbacks through 100 % of video (measure) | videoPlaybacksThrough100Percent |
| VideoPlaybacksThrough25Percent1 | Playbacks through 25 % of video (measure) | videoPlaybacksThrough25Percent |
| VideoPlaybacksThrough50Percent1 | Playbacks through 50 % of video (measure) | videoPlaybacksThrough50Percent |
| VideoPlaybacksThrough75Percent1 | Playbacks through 75 % of video (measure) | videoPlaybacksThrough75Percent |
| VideoSkips1 | Skips (measure) | videoSkips |
Setting DefinedReportJob.aggregationTypes to
Yearly causes the report job to have the following required and optional columns:
You must include these values in DefinedReportJob.selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| Keyword | Keyword (attribute) | keyword / site / kwSite |
| KeywordId | Keyword Id (attribute) | keywordid |
You can also include these columns in selectedColumns:
| selectedColumns Value | Name | Response XML |
|---|---|---|
| AdDistributionWithSearchPartners | Ad Distribution: with search partners (attribute) | adDistributionWithSearchPartners |
| AdGroup | Ad Group (attribute) | adgroup |
| AdGroupId | Ad Group Id (attribute) | adgroupid |
| AdGroupMaxCpa1 | Max CPA (attribute) | agMaxCpa |
| AdGroupStatus | Ad Group Status (attribute) | agStatus |
| AdWordsType | Ad Distribution (attribute) | adwordsType |
| AverageConversionValue2 | Value/Conv. (1-per-click) (measure) | avgConvValue |
| AverageInteractions1 | Average Interactions (measure) | averageInteractions |
| AveragePosition | Avg Position (measure) | pos |
| AvgPercentOfVideoPlayed1 | Avg Percent Played (measure) | avgPercentPlayed |
| BottomPosition | Lowest Position Preference (attribute) | bottomPosition |
| CPC | Avg CPC (measure) | cpc |
| CPM | Avg CPM (measure) | cpm |
| CTR | CTR (measure) | ctr |
| Campaign | Campaign (attribute) | campaign |
| CampaignId | Campaign Id (attribute) | campaignid |
| CampaignStatus | Campaign Status (attribute) | campStatus |
| Clicks | Clicks (measure) | clicks |
| ConversionCategory1 | Action Category (attribute) | conversioncategory |
| ConversionDescription1 | Action Description (attribute) | conversiondescription |
| ConversionName1 | Action Name (attribute) | conversionname |
| ConversionRate2 | Conv. Rate (1-per-click) (measure) | convRate |
| Conversions2 | Conversions (1-per-click) (measure) | conv |
| Cost | Cost (measure) | cost |
| CostPerConverstion2 | Cost/Conv. (1-per-click) (measure) | costPerConv |
| CostPerTransaction2 | Cost/Conv. (many-per-click) (measure) | cpt |
| CostPerVideoPlayback1 | Avg CPV (measure) | costPerVideoPlayback |
| CustomerName1 | Account (attribute) | acctname |
| CustomerTimeZone1 | Time Zone (attribute) | timezone |
| DailyBudget | Daily Budget (attribute) | budget |
| DefaultCount2 | Other Conv. (many-per-click) (measure) | defaultConv |
| DefaultValue2 | Other Conv. Value (many-per-click) (measure) | defaultConvValue |
| ExternalCustomerId1 | Customer Id (attribute) | customerid |
| FirstPageCpc3 | Est. First Page Bid (attribute) | firstPageCpc |
| Impressions | Impressions (measure) | imps |
| InteractedImpressionRate1 | Interacted Impression Rate (measure) | interactedImpressionRate |
| InteractedImpressions1 | Interacted Impressions (measure) | interactedImpressions |
| InteractionEnabledImpressions1 | Interaction-Enabled Impressions (measure) | interactionEnabledImpressions |
| InteractionRate1 | Interaction Rate (measure) | interactionRate |
| InteractionValue1 | Interaction Value (measure) | interactionValue |
| KeywordDestUrlDisplay | Keyword Destination URL (attribute) | kwDestUrl |
| KeywordMinCPCdep | Keyword Min CPC (attribute) | keywordMinCpc |
| KeywordStatus | Keyword Status (attribute) | kwStatus / siteStatus / siteKwStatus |
| KeywordTypeDisplay | Keyword Type (attribute) | kwType / siteType / kwSiteType |
| LeadCount2 | Leads Conv. (many-per-click) (measure) | leads |
| LeadValue2 | Leads Conv. Value (many-per-click) (measure) | leadValue |
| MaxContentCPC | Content Bid (attribute) | maxContentCpc |
| MaximumCPC | Current Maximum CPC (attribute) | maxCpc |
| MaximumCPM | Current Maximum CPM (attribute) | maxCpm |
| PageViewCount2 | Page View Conv. (many-per-click) (measure) | pageviews |
| PageViewValue2 | Page View Conv. Value (many-per-click) (measure) | pageviewValue |
| PreferredCPC1 | Current Preferred CPC (attribute) | preferredCpc |
| PreferredCPM1 | Current Preferred CPM (attribute) | preferredCpm |
| QualityScore | Quality Score (attribute) | qualityScore |
| SalesCount2 | Sales Conv. (many-per-click) (measure) | purchases |
| SalesValue2 | Sales Conv. Value (many-per-click) (measure) | purchaseValue |
| SignupCount2 | Sign-up Conv. (many-per-click) (measure) | signups |
| SignupValue2 | Sign-up Conv. Value (many-per-click) (measure) | signupValue |
| TopPosition | Highest Position Preference (attribute) | topPosition |
| TotalConversionValue2 | Total Conv. Value (measure) | convValue |
| TotalInteractions1 | Total Interactions (measure) | totalInteractions |
| Transactions2 | Conversions (many-per-click) (measure) | transactions |
| ValuePerClick2 | Conv. Value/Click (measure) | convVpc |
| ValuePerCost2 | Conv. Value/Cost (measure) | valueCostRatio |
| VideoPlaybackRate1 | Play Rate (measure) | playbackRate |
| VideoPlaybacks1 | Playbacks (measure) | videoPlaybacks |
| VideoPlaybacksThrough100Percent1 | Playbacks through 100 % of video (measure) | videoPlaybacksThrough100Percent |
| VideoPlaybacksThrough25Percent1 | Playbacks through 25 % of video (measure) | videoPlaybacksThrough25Percent |
| VideoPlaybacksThrough50Percent1 | Playbacks through 50 % of video (measure) | videoPlaybacksThrough50Percent |
| VideoPlaybacksThrough75Percent1 | Playbacks through 75 % of video (measure) | videoPlaybacksThrough75Percent |
| VideoSkips1 | Skips (measure) | videoSkips |