Search Ads 360 Reporting API מבוסס על פלטפורמה מודרנית וכולל כמה מושגים חדשים. בקטעים הבאים מוסבר על כך.
משאבים
אובייקטי משאבים מחליפים את סוגי הדוחות. במקום לבקש סוגים מוגדרים מראש של דוחות, עכשיו אפשר להריץ שאילתות על כל המשאבים באמצעות שפת שאילתות חדשה דמוית SQL. מידע נוסף זמין במאמר מבנה של Search Ads 360 Reporting API.
דוחות של חיפוש Google
לחיפוש יש שירות משלו ב-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. למידע נוסף, ראו ניהול גרסאות.