Opus Growth

Microsoft Ads Report Query

Free-form READ of the Microsoft Advertising Reporting API (v13): any report type and column set.

النوع
قراءة فقط
الرصيد
2
المنصة
Microsoft Advertising
الموافقة
غير مطلوبة، لا يتغير شيء

ماذا يفعل

Free-form READ of the Microsoft Advertising Reporting API (v13): any report type and column set. report_type: CampaignPerformance, AdGroupPerformance, AdPerformance, KeywordPerformance, SearchQueryPerformance, GeographicPerformance, AgeGenderAudience, AudiencePerformance, AssetPerformance, ShareOfVoice, ProductPartitionPerformance, … (the 'ReportRequest' suffix is added). columns: that report's column names (TimePeriod, CampaignId, CampaignName, Impressions, Clicks, Spend, Conversions, Revenue, ImpressionSharePercent, …); the valid set differs per report type and Microsoft rejects invalid ones with an explanatory error. aggregation: Summary | Hourly | Daily | Weekly | Monthly | Yearly | DayOfWeek | HourOfDay (TimePeriod gives time rows). days = last N full days excluding today, or start_date/end_date (YYYY-MM-DD). Reference: https://learn.microsoft.com/en-us/advertising/reporting-service/reporting-service-reference. Read-only; reply carries the exact `period`. limit controls the response page; page_token=next_page_token returns later pages without another API call or credit.

وصف الأداة بالإنجليزية لأنه النص الرسمي الذي يراه الذكاء الاصطناعي.

MCP: microsoft_report_query

كيفية الاستخدام

لا تستدعي الأدوات بأسمائها. اكتب ما تريد في ChatGPT أو Claude أو أي مساعد متصل بـ Opus Growth بكلماتك، وسيختار الذكاء الاصطناعي هذه الأداة عندما تناسب.

المعلمات

الاسمالنوعإلزاميالافتراضي
report_typestringاختياري·Provider-specific report type accepted by this operation. Use a supported value from the tool documentation or returned provider data.
columnsarrayاختياري·Columns value for microsoft report query. Follow the documented provider format and use values returned by Opus Growth discovery tools where possible.
account_idstringاختياري·Advertising account identifier to query or change. Use the exact ID returned by the relevant account-listing tool, not the display name.
aggregationstringاختياريSummaryExact aggregation value for microsoft report query. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation.
daysintegerاختياري30Number of calendar days to look back from now for this analysis or report.
start_datestringاختياري·Inclusive start date for the requested period, in the format required by this tool.
end_datestringاختياري·Inclusive end date for the requested period, in the format required by this tool.
customer_idstringاختياري·Google Ads customer account ID to query or change. Use the numeric ID returned by list_accounts; omit separators unless this tool explicitly says otherwise.
limitintegerاختياري0Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete.
page_tokenstringاختياري·Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page.