במקרה השימוש הזה מוצג סיכום של ביצועי החשבון ב-30 הימים האחרונים לפי קמפיין, עם פילוח לפי מכשיר. השאילתה של הדוח הזה היא:
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
כדי להגיש את הבקשה הזו, צריך להעביר את ההצהרה הזו בשפת השאילתות של Google Ads לממשק GoogleAdsService.SearchStream
.
כתובת URL של בקשת HTTP
הבקשה מורכבת מ-HTTP POST לשרת Google Ads API בכתובת ה-URL הבאה:
https://googleads.googleapis.com/v21/customers/{customer_id}/googleAds:searchStream
דוגמה מלאה לבקשת HTTP
הנה דוגמה מלאה להגדרת הדוח, שמופיעה בבקשת HTTP POST:
POST /v21/customers/{customer_id}/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com User-Agent: curl Content-Type: application/json Accept: application/json Authorization: Bearer [Enter OAuth 2.0 access token here] developer-token: [Enter developerToken here] Parameters: { "query" : "SELECT campaign.name, campaign.status, segments.device, metrics.impressions, metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_30_DAYS" }
דוגמאות קוד
כדאי לצפות בסרטון שמציג הסבר מפורט על דוגמת קוד שמחפשת קמפיינים עם מדדים מ-7 הימים האחרונים. דוגמת הקוד הזו נכתבה ב-Java, אבל התהליך דומה בכל השפות.