דוגמה לתרחיש נפוץ

עכשיו נבחן תרחיש נפוץ לדוגמה: סיכום הביצועים של חשבון במהלך 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.

נקודה חשובה: בדוגמה הזו מוצגת בקשת ה-HTTP הבסיסית רק כשיטת הוראה. מומלץ מאוד להשתמש באחת מספריות הלקוח כדי לשלוח בקשות באפליקציה שלכם.

כתובת URL של בקשת HTTP

הבקשה מכילה HTTP POST (POST POST) לשרת של Google Ads API, בכתובת ה-URL הבאה:

https://googleads.googleapis.com/v17/customers/{customer_id}/googleAds:searchStream

השלמת דוגמה של בקשת HTTP

לפניכם דוגמה מלאה להגדרת הדוח שלמעלה, שמצורפת לבקשת HTTP POST.

POST /v17/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, אבל התהליך דומה בכל השפות.