Reads

gads_get_segment_performance

Warehoused segment performance for one dimension — device, geo (targeted locations), day_of_week, hour, age, gender, or income — per campaign, with labeled buckets, currency units,

Warehoused segment performance for one dimension — device, geo (targeted locations), day_of_week, hour, age, gender, or income — per campaign, with labeled buckets, currency units, current bid modifiers (device/geo/schedule) and each campaign's bidding strategy (Smart Bidding ignores bid modifiers except device -100; check before proposing one). This is THE segment-insight path — use it before proposeDeviceBidModifier / proposeGeoTarget / proposeAdSchedule.

Scope: read token (or higher). Read-only.

Parameters

ParameterTypeRequiredDescription
dimension"device" | "geo" | "day_of_week" | "hour" | "age" | "gender" | "income"Yes
campaignIdstringNo
daysintegerNo(default: 30)
projectIdstringNoTarget account (project id). Required with an org-scoped token for account-scoped tools — call gads_list_ad_accounts to enumerate accounts. Omit with a project-scoped token.

On this page