GoogleAdsService
הוא השירות המאוחד לאחזור אובייקטים ודיווח ב-Google Ads API. בשירות יש שיטות ש:
- אחזור תכונות ספציפיות של אובייקטים.
- אחזור מדדי ביצועים של אובייקטים על סמך טווח תאריכים.
- סדר אובייקטים על סמך המאפיינים שלהם.
- משתמשים בתנאים כדי לציין אילו אובייקטים רוצים להחזיר בתגובה.
- הגבלת מספר האובייקטים המוחזרים.
GoogleAdsService
יכול להחזיר תוצאות בשתי דרכים:
GoogleAdsService.SearchStream
מחזירה את כל השורות בתגובת סטרימינג אחת, והיא יעילה יותר בקבוצות תוצאות גדולות (יותר מ-10,000 שורות). אפשרות זו מתאימה יותר אם אפליקציית האצווה שלכם רוצה להוריד כמה שיותר נתונים במהירות האפשרית.GoogleAdsService.Search
מפצלת תשובות גדולות לדפי תוצאות שניתן לנהל. מתאים יותר אם האפליקציה האינטראקטיבית שלך מציגה דף של תוצאות בכל פעם.
למידע נוסף על דפדוף לעומת סטרימינג.
יצירת בקשה
שיטת החיפוש מחייבת SearchGoogleAdsRequest
, שמורכב מהמאפיינים הבאים:
- א
customer_id
- שפת השאילתות של Google Ads
query
שמציינת איזה משאב יש לשלוח שאילתה, המאפיינים, הפלחים והמדדים שצריך לאחזר, והתנאים שבהם צריך להשתמש כדי להגביל את האובייקטים שמוחזרים - (
GoogleAdsService.Search
בלבד) Apage_size
, כדי לציין כמה אובייקטים להחזיר בתגובה אחת כשמשתמשים בהחלפה. - (
GoogleAdsService.Search
בלבד) שדהpage_token
אופציונלי כדי לאחזר את האצווה הבאה של התוצאות כשמשתמשים בהחלפה.
למידע נוסף על שפת השאילתות של Google Ads, קראו את המדריך לשפת השאילתות של Google Ads.
עיבוד תשובה
GoogleAdsService
מחזיר רשימה של GoogleAdsRow
אובייקטים.
כל GoogleAdsRow
מייצג אובייקט שמוחזר על ידי שאילתה, ומורכב מקבוצת מאפיינים שמאוכלסים בהתאם לשדות הנדרשים בסעיף SELECT
. מאפיינים שלא נכללים בסעיף SELECT
לא מאוכלסים באובייקטים GoogleAdsRow
שבתגובה.
לדוגמה, למרות שהשדה ad_group_criterion
כולל את המאפיין status
, השדה status
של המאפיין ad_group_criterion
בשורה לא מאוכלס בתגובה לשאילתה שבה הסעיף SELECT
לא כולל את ad_group_criterion.status
. באופן דומה, המאפיין campaign
של השורה לא יאוכלס אם הסעיף SELECT
לא כולל שדות מהמשאב campaign
.
לכל GoogleAdsRow
יכולים להיות מאפיינים ומדדים שונים משורה אחרת באותה קבוצת תוצאות. לכן יש להתייחס לשורות כאובייקטים ולא כשורות קבועות בטבלה.
סוגי טיפוסים בני מנייה לא ידועים
אין תמיכה מלאה במשאבים שמוחזרים מסוג UNKNOWN
בגרסת ה-API הזו. יכול להיות שהמשאבים האלה נוצרו דרך ממשקים אחרים, כמו ממשק המשתמש של Google Ads. אפשר לבחור מדדים כשהמשאב הוא מסוג UNKNOWN
, אבל אי אפשר לשנות את המשאב דרך ה-API. דוגמה לכך: קמפיין חדש או מודעה חדשה שמוצגים בממשק המשתמש, אבל הם לא נתמכים בגרסת ה-API שעליה אתם מריצים את השאילתה.
הנה כמה שיקולים שכדאי לזכור:
- אפשר יהיה לתמוך במשאב מסוג
UNKNOWN
מאוחר יותר, או להישאר ב-UNKNOWN
ללא הגבלת זמן. - אובייקטים חדשים מסוג
UNKNOWN
יכולים להופיע בכל שלב. האובייקטים האלה תואמים לאחור כי ערך ה-enum כבר זמין. אנחנו מוסיפים את המשאבים האלה ברגע שהם זמינים, כדי שתקבלו תמונה מדויקת של החשבון. המשאבUNKNOWN
יכול להופיע כתוצאה מפעילויות חדשות בחשבון דרך ממשקים אחרים, או כשאין יותר תמיכה במשאב. - אפשר לצרף למשאבים של
UNKNOWN
מדדים מפורטים שאפשר להריץ עליהם שאילתות. UNKNOWN
משאבים בדרך כלל גלויים במלואם בממשק המשתמש של Google Ads.- בדרך כלל, לא ניתן לשנות משאבים ב-
UNKNOWN
.
פילוח
התשובה תכיל GoogleAdsRow
אחד לכל שילוב של המאפיינים הבאים:
- מופע של המשאב הראשי שצוין בסעיף
FROM
- הערך של כל שדה
segment
שנבחר
לדוגמה, התשובה לשאילתה שבוחרת את הערך FROM campaign
, שמכילה segments.ad_network_type
ו-segments.date
בסעיף SELECT
, תכיל שורה אחת לכל שילוב של הפריטים הבאים:
campaign
segments.ad_network_type
segments.date
התוצאות מפולחות באופן מרומז לפי כל מופע של המשאב הראשי, ולא לפי הערכים של השדות הנפרדים שנבחרו. לדוגמה,
SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS
מתקבלת שורה אחת לכל קמפיין, ולא שורה אחת לכל ערך ייחודי של השדה campaign.status
.