قائمة الوثائق
البداية
ما هو Opus Growthبدء سريعأضفه إلى الذكاء الاصطناعيكيف يعملالأمان والموافقةالرصيدالخططالأسئلة الشائعةتطبيقات الذكاء الاصطناعي
كل التطبيقاتChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfMCP أخرىمنصات الإعلانات
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT Adsالوكالات وMCCمصادر البيانات
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag Managerالمواقع وSEO
AI ServerWordPressSEO Intelligenceالنقرات الاحتياليةمرجع الأدوات
كل الأدواتGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO Intelligenceالنقرات الاحتياليةعبر القنواتالحساب والفوترةاللغة
Search Terms Report
Search terms report: every search term Google reports for the period, one row per (ad group + matched keyword) with impressions, clicks, ctr, cost and conversions, so the same term appears once per ad group / keyword…
- النوع
- قراءة فقط
- الرصيد
- 2
- المنصة
- Google Ads
- الموافقة
- غير مطلوبة، لا يتغير شيء
ماذا يفعل
Search terms report: every search term Google reports for the period, one row per (ad group + matched keyword) with impressions, clicks, ctr, cost and conversions, so the same term appears once per ad group / keyword it matched. Each row has `bucket`: converter (conversions > 0), waste_candidate (no conversions and cost >= min_waste, not blocked by an existing negative), already_negative (an existing ad group, campaign or shared-list negative already blocks it; the blocking negative is in `already_negative`), or null. `buckets` gives the count and cost of each bucket over all rows; only = converters | waste_candidates | already_negative returns just that bucket's rows. sort: cost | impressions | clicks | conversions. min_clicks: 0 includes terms with impressions but no clicks. Google withholds very low-volume terms behind its privacy threshold. DATE: period ('today', 'yesterday', 'this_month', 'last_7_days', ... or 'YYYY-MM-DD[:YYYY-MM-DD]') overrides days; days=0 = today; start_date/end_date (YYYY-MM-DD) also set an explicit range. campaign_id: one id or comma-separated ids. Smart campaigns are included with campaign_type='SMART' (Google exposes only impressions, clicks and cost for them; conversions=null, bucket=null). limit = rows in this response (no upper bound; 0 = as many as fit, about 380 KB); when has_more is true, page_token=next_page_token returns the next rows without credits or a new query.
وصف الأداة بالإنجليزية لأنه النص الرسمي الذي يراه الذكاء الاصطناعي.
MCP: search_terms_report
كيفية الاستخدام
لا تستدعي الأدوات بأسمائها. اكتب ما تريد في ChatGPT أو Claude أو أي مساعد متصل بـ Opus Growth بكلماتك، وسيختار الذكاء الاصطناعي هذه الأداة عندما تناسب.
المعلمات
| الاسم | النوع | إلزامي | الافتراضي | |
|---|---|---|---|---|
| customer_id | string | اختياري | · | 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. |
| days | integer | اختياري | 90 | Number of calendar days to look back from now for this analysis or report. |
| min_waste | number | اختياري | 50.0 | Minimum waste or spend threshold used to surface an optimisation finding. |
| period | string | اختياري | · | Reporting period or date-range preset accepted by this operation. |
| sort | string | اختياري | cost | Sort field and direction accepted by this operation, in the provider's documented format. |
| min_clicks | integer | اختياري | 0 | Numeric min clicks value for search terms report. Use the provider's expected unit, range, and precision. |
| limit | integer | اختياري | 0 | Maximum 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. |
| campaign_id | string | اختياري | · | Exact campaign identifier to target. Use the ID returned by an Opus Growth list or create operation, not a display name. |
| start_date | string | اختياري | · | Inclusive start date for the requested period, in the format required by this tool. |
| end_date | string | اختياري | · | Inclusive end date for the requested period, in the format required by this tool. |
| only | string | اختياري | · | Exact only value for search terms report. 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. |
| page_token | string | اختياري | · | 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. |
أدوات ذات صلة
account_auditAccount Snapshotaccount_snapshotAdd Keywordsadd_keywordsAdd Negative Keywordadd_negative_keywordAdd PMax Imagesadd_pmax_imagesApply Recommendationapply_recommendationBudget Pacing Alertsbudget_pacing_alertsCompetitor Adscompetitor_adsConnect Business Profileconnect_business_profile