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

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

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

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

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

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

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

שליחת בקשה

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

• customer_id
• שפת שאילתות ב-Google Ads query שמציינת את המשאב שעליו צריך לשלוח את השאילתה, את המאפיינים פלחים, מדדים לאחזר, והתנאים שבהם יש להשתמש כדי להגביל אילו אובייקטים מוחזרים
• (GoogleAdsService.Search בלבד) א' page_size כדי לציין כמה אובייקטים יוחזרו בתגובה יחידה כאשר באמצעות חלוקה לדפים.
• (GoogleAdsService.Search בלבד) אופציונלי: page_token, כדי לאחזר את קבוצת התוצאות הבאה בזמן השימוש חלוקה לדפים.

למידע נוסף על שפת השאילתות ב-Google Ads, ניתן לעיין בשפת השאילתות של Google Ads guide.

עיבוד תשובה

הפונקציה GoogleAdsService מחזירה רשימה של GoogleAdsRow אובייקטים.

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

לדוגמה, למרות של-ad_group_criterion יש מאפיין status, השדה status במאפיין ad_group_criterion של השורה לא מאוכלס תשובה לשאילתה שבה התנאי SELECT לא כולל ad_group_criterion.status באופן דומה, המאפיין campaign של השורה לא מאוכלס אם התנאי SELECT לא כולל שדות משאב campaign.

לכל GoogleAdsRow יכולים להיות מאפיינים ומדדים שונים משורה אחרת באותה קבוצת תוצאות; כך שיש לראות את השורות כאובייקטים בשורות הקבועות של הטבלה.

סוגי enum לא ידועים

אין תמיכה מלאה במשאבים שמוחזרים בסוג של 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.