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