מתבצע אחזור של אובייקטים

המטרה: להבין איך מאחזרים אובייקטים ונתונים סטטיסטיים של ביצועים באמצעות GoogleAdsService. למידע על מושגים של דיווח, כדאי לעיין במדריכים בנושא דוחות.

GoogleAdsService הוא השירות המאוחד לאחזור אובייקטים ודיווח ב-Google Ads API. בשירות יש שיטות ש:

• אחזור תכונות ספציפיות של אובייקטים.
• אחזור מדדי ביצועים של אובייקטים על סמך טווח תאריכים.
• סדר אובייקטים על סמך המאפיינים שלהם.
• משתמשים בתנאים כדי לציין אילו אובייקטים רוצים להחזיר בתגובה.
• הגבלת מספר האובייקטים המוחזרים.

GoogleAdsService יכול להחזיר תוצאות בשתי דרכים:

• GoogleAdsService.SearchStream מחזירה את כל השורות בתגובת סטרימינג אחת, והיא יעילה יותר בקבוצות תוצאות גדולות (יותר מ-10,000 שורות). אפשרות זו מתאימה יותר אם אפליקציית האצווה שלכם רוצה להוריד כמה שיותר נתונים במהירות האפשרית.
• GoogleAdsService.Search מפצלת תשובות גדולות לדפי תוצאות שניתן לנהל. מתאים יותר אם האפליקציה האינטראקטיבית שלך מציגה דף של תוצאות בכל פעם.

למידע נוסף על דפדוף לעומת סטרימינג.

יצירת בקשה

שיטת החיפוש מחייבת SearchGoogleAdsRequest, שמורכב מהמאפיינים הבאים:

• א customer_id
• שפת השאילתות של Google Ads query שמציינת איזה משאב יש לשלוח שאילתה, המאפיינים, הפלחים והמדדים שצריך לאחזר, והתנאים שבהם צריך להשתמש כדי להגביל את האובייקטים שמוחזרים
• (GoogleAdsService.Search בלבד) A page_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.