המרכיבים העיקריים של Search Ads 360 Reporting API הם משאבים ושירותים. משאב מייצג ישות של Search Ads 360, ואתם משתמשים בשירות כדי לאחזר ישויות של Search Ads 360.
היררכיית אובייקטים
חשבון Search Ads 360 הוא היררכיה של אובייקטים.
המשאב ברמה העליונה של החשבון הוא customer (לקוח).
כל חשבון מכיל קמפיין פעיל אחד או יותר.
כל
Campaignמכיל קבוצת מודעות אחת או יותר, שבהן המודעות מקובצות לפי נושאים.כל
AdGroupמכיל מודעה אחת או יותר של קבוצת מודעות.אפשר לצרף
AdGroupCriterionאוCampaignCriterionאחד או יותר לקבוצת מודעות או לקמפיין. הקריטריונים מגדירים איך המודעות מופעלות.- יש הרבה סוגי קריטריונים, כמו מילות מפתח, טווחי גילאים ומיקומים. קריטריונים שמוגדרים ברמת הקמפיין משפיעים על כל הנכסים האחרים בקמפיין. אפשר גם לציין תקציבים ותאריכים ברמת הקמפיין.
משאבים
משאבים מייצגים את הישויות בחשבון Search Ads 360. דוגמאות למשאבים: Customer, Campaign ו-AdGroup.
מזהי אובייקטים
לכל אובייקט ב-Search Ads 360 יש מזהה משלו. יש מזהים שהם ייחודיים באופן גלובלי, כלומר בכל חשבונות Search Ads 360, ויש מזהים שהם ייחודיים רק בהיקף מוגבל.
| היקף הייחודיות של מזהה האובייקט | |
|---|---|
| מזהה תקציב | גלובלי |
| מזהה הקמפיין | גלובלי |
| קוד זיהוי של קבוצת מודעות | גלובלי |
| מזהה המודעה | קבוצת מודעותכל צמד של AdGroupId / AdId
הוא ייחודי באופן גלובלי. |
| מזהה קריטריון של קבוצת מודעות | קבוצת מודעותכל צמד של AdGroupId /
CriterionId הוא ייחודי באופן גלובלי. |
| מזהה CampaignCriterion | קמפייןכל צמד של 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. בשתי השיטות צריך להשתמש בשאילתה שמציינת את המשאב שאותו רוצים לשאול, את מאפייני המשאב ומדדי הביצועים שרוצים לאחזר, את התנאים שרוצים להשתמש בהם כדי לסנן את הבקשה ואת הפלחים שרוצים להשתמש בהם כדי לפרק עוד יותר את נתוני הביצועים. מידע נוסף זמין במאמרים בנושא יצירת דוחות על חיפושים ושפת השאילתות של Search Ads 360.- שירות בשטח
SearchAds360FieldServiceמאחזר מטא-נתונים על משאבים, כמו המאפיינים הזמינים של משאב וסוג הנתונים שלו. אפשר לבקש את הקטלוג של המשאבים, השדות של המשאבים, מפתחות הפילוח והמדדים שזמינים בSearchAds360Serviceשיטות החיפוש. מידע נוסף זמין במאמר בנושא אחזור מטא-נתונים של משאבים.- שירותים שספציפיים לישות
השירותים האלה מספקים שיטת בקשה
GETשמחלצת מופע משאב יחיד. האפשרות הזו שימושית לבדיקת המבנה של משאב.דוגמאות לשירותים ספציפיים לישות:
- CustomColumnService שמחזיר את העמודה המותאמת אישית המבוקשת עם כל הפרטים.