הרכיבים העיקריים ב-Search Ads 360 Reporting API הם משאבים ושירותים. משאב מייצג ישות ב-Search Ads 360, ומשתמשים בשירות כדי לאחזר ישויות ב-Search Ads 360.
היררכיית אובייקטים
חשבון Search Ads 360 הוא היררכיה של אובייקטים.
המשאב ברמה העליונה של החשבון הוא הלקוח.
כל חשבון מכיל קמפיין פעיל אחד או יותר.
כל
Campaignמכיל קבוצת מודעות אחת או יותר שמקבצות את המודעות שלכם לאוספים לוגיים.כל
AdGroupמכיל מודעה אחת או יותר בקבוצת מודעות.אפשר לצרף קובץ
AdGroupCriterionאוCampaignCriterionאחד או יותר לקבוצת מודעות או לקמפיין. הקריטריונים קובעים איך המודעות מופעלות.- יש הרבה סוגים של קריטריונים, כמו מילות מפתח, טווחי גילאים ומיקומים. קריטריונים שמוגדרים ברמת הקמפיין משפיעים על כל שאר המשאבים באותו קמפיין. אפשר גם לציין תקציבים ותאריכים ברמת הקמפיין.
משאבים
המשאבים מייצגים את הישויות בחשבון Search Ads 360. דוגמאות למשאבים: Customer, Campaign ו-AdGroup.
מזהי אובייקטים
כל אובייקט ב-Search Ads 360 מזוהה באמצעות מזהה משלו. חלק מהמזהים הם ייחודיים באופן גלובלי, כלומר בכל חשבונות Search Ads 360, ואחרים הם ייחודיים רק בהיקף מוגבל.
| היקף הייחודיות של מזהה האובייקט | |
|---|---|
| מזהה תקציב | גלובלי |
| מזהה הקמפיין | גלובלי |
| קוד זיהוי של קבוצת מודעות | גלובלי |
| Ad ID | קבוצת מודעותכל צמד של AdGroupId מתוך AdId הוא ייחודי בכל העולם. |
| מזהה AdGroupCriterion | קבוצת מודעותכל צמד AdGroupId / CriterionId הוא ייחודי באופן גלובלי. |
| CampaignCriterion ID | קמפייןכל צמד CampaignId / CriterionId הוא ייחודי באופן גלובלי. |
| תוספים למודעות | קמפייןכל צמד CampaignId / AdExtensionId הוא ייחודי באופן גלובלי. |
| מזהה העדכון | גלובלי |
| מזהה הפריט בפיד | גלובלי |
| מזהה מאפיין פיד | פיד |
| מזהה מיפוי פידים | גלובלי |
| קוד זיהוי תווית | גלובלי |
| מזהה של רשימת משתמשים | גלובלי |
כללי הזיהוי האלה יכולים להיות שימושיים בתכנון אחסון מקומי לאובייקטים של Search Ads 360.
סוגי אובייקטים
אפשר להשתמש באובייקטים מסוימים בכמה סוגי ישויות. במקרה כזה, האובייקט מכיל שדה type שמתאר את התוכן שלו. לדוגמה, הערך AdGroupAd יכול להתייחס למודעת טקסט, למודעת מלון או למודעת עסק מקומי.
אפשר לגשת לערך הסוג באמצעות השדה AdGroupAd.ad.type. הערך שלו מוחזר ב-enum AdType.
שמות המשאבים
כל משאב מזוהה באופן ייחודי באמצעות מחרוזת resource_name שמקשרת את המשאב ואת ההורים שלו לנתיב.
לדוגמה, השמות של משאבי הקמפיין מופיעים בתבנית:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
בקמפיין עם המזהה 987654 בחשבון Search Ads 360 עם מספר הלקוח 1234567, המאפיינים של resource_name הם:
customers/1234567/campaigns/987654
שירותים
שירותים מאפשרים לך לאחזר את הישויות והמטא-נתונים של Search Ads 360. יש שלושה סוגי שירותים:
- שירות חיפוש
SearchAds360Serviceהוא השירות המאוחד לאחזור כל אובייקטי המשאבים ונתוני הסטטיסטיקה של הביצועים. יש שתי שיטות:Searchו-SearchStream. שתי ה-methods מחייבות שאילתה שמציינת את המשאב לשליחת השאילתה, מאפייני המשאבים ומדדי הביצועים לאחזור, הפרדיקטים שבהם צריך להשתמש לסינון הבקשה והפלחים שבהם צריך להשתמש כדי להציג פירוט נוסף של הנתונים הסטטיסטיים של הביצועים. מידע נוסף זמין במאמרים יצירת דוחות חיפוש ושפת השאילתות של Search Ads 360.- שירות שדה
SearchAds360FieldServiceמאחזר מטא-נתונים על משאבים, כמו המאפיינים הזמינים של משאב וסוג הנתונים שלו. אפשר לבקש בקטלוג משאבים, שדות משאבים, מפתחות פילוח ומדדים שזמינים בשיטות החיפושSearchAds360Service. במאמר אחזור מטא-נתונים של משאבים תוכלו לקרוא מידע נוסף.- שירותים ספציפיים לישות
השירותים האלה מספקים שיטת בקשה
GETשמאחזרת מכונה אחת של משאב. האפשרות הזו שימושית לבדיקה של המבנה של משאב.דוגמאות לשירותים ספציפיים לישות:
- CustomColumnService שמחזיר את העמודה בהתאמה אישית המבוקשת בפירוט מלא.