AI-generated Key Takeaways
-
The new Search Ads 360 Reporting API offers enhanced flexibility for building custom reports and data integration.
-
You can request segmented reports (adGroup, campaign) to view clicks, impressions, and other metrics for each sitelink.
-
Conversion and visit reports provide raw data on individual interactions, including attributed sitelink IDs.
-
The feedItem report displays metrics and configuration details for each sitelink across all campaigns and ad groups.
You can request different types of reports that contain metrics for Google Ads sitelink extensions:
A segmented
adGrouporcampaignreport that shows the number of clicks, impressions, and other data for each sitelink in an ad group or campaign.A
conversionorvisitreport that shows raw data about individual visits and conversions, including the IDs of any sitelinks that were clicked and attributed for the visit/conversion.A
feedItemreport that shows metrics and configuration details for each sitelink across all campaigns and ad groups that it's been applied to.
Request a segmented adGroup or campaign report
To see the number of clicks, impressions, and other data for each sitelink in an ad group or
campaign, request an adGroup
or campaign report
and include one of the sitelink segmentation columns, such as sitelinkDisplayText.
Example request
{
"reportScope": {
"agencyId": "20700000000000123", // Replace with your IDs
"advertiserId": "2170000012345", // Replace with your IDs
"engineAccountId": "700000000042201" // Replace with your IDs
},
"reportType": "campaign",
"columns": [
{ "columnName": "account" },
{ "columnName": "campaign" },
{ "columnName": "sitelinkDisplayText" },
{ "columnName": "feedItemId" },
{ "columnName": "clicks" },
{ "columnName": "clicksWithFeedItemShowing" },
{ "columnName": "adWordsConversions" }
],
"timeRange" : {
"startDate" : "2014-07-21",
"endDate" : "2014-08-19"
},
"downloadFormat": "csv",
"maxRowsPerFile": 6000000,
"statisticsCurrency": "agency",
"verifySingleTimeZone": false,
"includeRemovedEntities": false
}
Example report
Here's an example of a campaign report in the CSV format segmented by sitelinkDisplayText:
account,campaign,sitelinkDisplayText,feedItemId,clicks,clicksWithFeedItemShowing,adWordsConversions
Hooper's - Google,Accessories,Summer 2014,33700000014504870,10895,12895,1157
Hooper's - Google,Accessories,$30 and Under,33700000014504871,10816,12816,1145
Hooper's - Google,Accessories,Tote Bags,33700000014504872,12790,12790,1147
Request a conversion or visit report with sitelink data
To see raw data about individual visits and conversions, including the IDs of any sitelinks
that were clicked and attributed for the visit/conversion, request a
conversion or
visit report and include the
feedItemId column in the request.
Example request
{
"reportScope": {
"agencyId": "20700000000000123", // Replace with your IDs
"advertiserId": "2170000012345", // Replace with your IDs
"engineAccountId": "700000000042201" // Replace with your IDs
},
"reportType": "conversion",
"columns": [
{ "columnName": "account" },
{ "columnName": "campaign" },
{ "columnName": "floodlightActivity" },
{ "columnName": "feedType" },
{ "columnName": "feedItemId" }
],
"timeRange" : {
"startDate" : "2014-07-21",
"endDate" : "2014-08-19"
},
"downloadFormat": "csv",
"maxRowsPerFile": 6000000,
"statisticsCurrency": "agency",
"verifySingleTimeZone": false,
"includeRemovedEntities": false
}
Example report
Here's an example of a conversion report in the CSV format with some feed item columns:
account,campaign,floodlightActivity,feedType,feedItemId Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504870 Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504871 Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504872
To get more information about the sitelinks in the conversions, request
a feedItem report. Then use the feedItemId to find the sitelinks that were
referenced in the conversion or visit report.
Request a feedItem report
To see metrics and configuration details for each sitelink across all campaigns and ad
groups that it's been applied to, request a feedItem
report.
Example request
{
"reportScope": {
"agencyId": "20700000000000123", // Replace with your IDs
"advertiserId": "2170000012345", // Replace with your IDs
"engineAccountId": "700000000042201" // Replace with your IDs
},
"reportType": "feedItem",
"columns": [
{ "columnName": "feedItemId" },
{ "columnName": "sitelinkDisplayText" },
{ "columnName": "sitelinkDescription1" },
{ "columnName": "sitelinkDescription2" },
{ "columnName": "sitelinkLandingPageUrl" },
{ "columnName": "clicks" },
{ "columnName": "clicksWithFeedItemShowing" },
{ "columnName": "dfaRevenue" }
],
"timeRange" : {
"startDate" : "2014-07-21",
"endDate" : "2014-08-19"
},
"downloadFormat": "csv",
"maxRowsPerFile": 6000000,
"statisticsCurrency": "agency",
"verifySingleTimeZone": false,
"includeRemovedEntities": false
}
Example report
Here's an example of a feedItem report in the CSV format:
feedItemId,sitelinkDisplayText,sitelinkDescription1,sitelinkDescription2,sitelinkLandingPageUrl,clicks,clicksWithFeedItemShowing,dfaRevenue
33700000014504870,Summer 2014,,,http://www.hoopers.com/summer2012,10895,12895,141653.25421900
33700000014504871,$30 and Under,,,http://www.hoopers.com/sortby/lowprice,10816,12816,143600.27534400
33700000014504872,Tote Bags,,,http://www.hoopers.com/tote,12790,12790,140178.19750400