Search Ads 360 Reporting API מבוסס על פלטפורמה מודרנית ומציג כמה מושגים חדשים. הם מתוארים בקטעים הבאים.
משאבים
אובייקטים של משאבים מחליפים את סוגי הדוחות. במקום לבקש סוגים מוגדרים מראש של דוחות, עכשיו אפשר להריץ שאילתות על כל המשאבים באמצעות שפת שאילתות חדשה שדומה ל-SQL. מידע נוסף זמין במאמר על המבנה של Search Ads 360 Reporting API.
דיווח על חיפוש
לחיפוש יש שירות משלו ב-API החדש. שירות החיפוש מחליף את שירות הדוחות הקודם. כל השאילתות עוברות דרך SearchAds360Service, שמספק שתי שיטות, SearchStream ו-Search, לחיפוש ולאחזור של נתונים ומדדים של דיווח. שתי שיטות החיפוש מחזירות את כל האובייקטים SearchAds360Row שתואמים לשאילתת החיפוש. מידע נוסף זמין במאמר יצירת דוחות חיפוש.
מטא-נתונים של משאבים
באמצעות SearchAds360FieldService אפשר לבקש באופן דינמי את הקטלוג של משאבים, שדות משאבים, מפתחות פילוח ומדדים שזמינים בשיטות החיפוש SearchAds360Service. למידע נוסף, ראו אחזור מטא-נתונים של משאבים.
שמות שדות
ב-API נעשה שימוש בשמות שדה בתצוגת עץ, שמפרידים ביניהם באמצעות סימן הנקודה. לדוגמה, campaign.id ו-ad_group.id. אפשר גם להוסיף עוד רמות עץ, לדוגמה,ad_group.campaign.id. מידע נוסף זמין במאמר המבנה של Search Ads 360 Reporting API.
הדיווח ב-Search Ads 360 API הקודם מבוסס על שדות נפרדים בישויות שונות למושגים דומים. לדוגמה, גם הדוח campaign וגם הדוח adgroup כוללים שדה campaignId נפרד.
שפת השאילתה
ה-API מציג את שפת השאילתות ב-Search Ads 360. זוהי שפה גמישה שדומה ל-SQL, שמאפשרת להגדיר שאילתות כדי לאחזר את נתוני הדיווח הספציפיים שמתאימים לעסק שלכם. מידע נוסף זמין במאמר שפת השאילתות של Search Ads 360.
קבלת בקשות
ב-API החדש, לחיפוש יש שירות משלו (SearchAds360Service), אבל בקשות GET עדיין קיימות בשירות הספציפי של כל ישות. לדוגמה, אפשר לקבל מידע על עמודות בהתאמה אישית מה-CustomColumnService. מידע נוסף זמין במאמר שינויים בפורמט ב-Search Ads 360 Reporting API.
עמודות מותאמות אישית
בממשק החדש של Search Ads 360, עמודות של נוסחאות והמרות בהתאמה אישית נקראות עמודות בהתאמה אישית. מידע נוסף על עמודות בהתאמה אישית הגרסה החדשה של CustomColumnService מפעילה עמודות בהתאמה אישית. אם יש לכם את ההרשאות הנדרשות, תוכלו לבקש משאבים מסוג CustomColumn שבבעלות כל חשבון בעץ החשבונות.
ניהול חשבון
החשבונות בממשק החדש של Search Ads 360 מאורגנים בהיררכיה של חשבונות ניהול, חשבונות ניהול משניים וחשבונות לקוח. חשבון ניהול מייצג את חשבון הסוכנות, וחשבונות ניהול משניים מייצגים חשבונות של מפרסמים בממשק הקודם של Search Ads 360. מידע נוסף זמין במאמר מידע על חשבונות ניהול ב-Search Ads 360.
אתם יכולים לבצע שאילתות בעץ החשבונות ואז לשלוח בקשות לכל חשבון שבו אתם רוצים לדווח על נתונים.
כתוצאה מהשינוי בהיררכיית החשבון, שדות שקשורים לקונספט של המפרסם/הסוכנות הוחלפו בחלופות מתאימות כדי לספק שוויון פונקציונלי ככל האפשר. במיפויים של שדות מופיעה רשימה של השדות שהושפעו והתחליפים שלהם.
הכותרת של מספר הלקוח בהתחברות
login-customer-id הוא כותרת חדשה שנדרשת כשמשתמשים בחשבון ניהול כדי לגשת לחשבון ניהול משני או לחשבון לקוח. למידע נוסף, ראו כותרת של מזהה לקוח להתחברות.
ניהול גרסאות
ב-Search Ads 360 Reporting API נעשה שימוש במיקום גרסאות סמנטי.
יש גרסאות ראשיות ומשנה, בפורמט vMAJOR_MINOR. מידע נוסף זמין במאמר ניהול גרסאות.