שאלות נפוצות בנושא דיווח

Search Ads 360 Reporting API החדש זמין עכשיו. ה-API החדש מספק גמישות משופרת ליצירה של דוחות בהתאמה אישית ולשילוב הנתונים באפליקציות הדיווח ותהליכים. מידע נוסף על המעבר לממשק החדש של Search Ads 360 ועל השימוש בו API.

מה צריך להיות היקף הדוח שלי?

ברוב הדוחות מומלץ להגדיר Reports.reportScope לחשבון מנוע חיפוש או למפרסם ספציפי. למכשירים גדולים מאוד דוחות, כמו דוחות על מילות מפתח, דוחות המרות או עם פילוח מדויק – מומלץ להגביל את ההיקף חשבון מנוע חיפוש ספציפי. ה-API עשוי להחזיר שגיאות בדוחות שגדולים מ- 10 מיליון שורות.

למה מופיעה שגיאה מסוג 'אסור' (403)?

סביר להניח שתצטרכו לקבל אסימון OAuth לרענון.

איך אפשר למצוא את המזהים של סוכנויות ומפרסמים?

אם עדיין אין לכם את המזהים של הסוכנויות והמפרסמים שיש לכם הרשאה לצפייה, לבקש הרשאת צפייה advertiser עם העמודות agencyId ו-advertiserId, אבל לא מציינים את reportScope. מערכת Search Ads 360 תחזיר רשימה של כל מזהי הסוכנות והמפרסמים שאתם לחשבון Google יש הרשאת צפייה.

דוגמה לבקשה:

POST  https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
  "reportType": "advertiser",
  "columns": [
    { "columnName": "agency" },
    { "columnName": "agencyId" },
    { "columnName": "advertiser" },
    { "columnName": "advertiserId" }
  ],
  "statisticsCurrency": "usd"
}
        

כדי לשלוח את הבקשה, צריך להשתמש בסקריפט של כלי השירות של Search Ads 360

כדי לשלוח בקשת JSON POST גולמית, אפשר להשתמש ב-sa360Api.py סקריפט באופן הבא:

1. מעתיקים את אובייקט ה-JSON לדוגמה (כל מה שמופיע בין השניים, כולל סוגריים מסולסלים) בקובץ טקסט חדש בשם request.txt.
2. משנים את מזהה הסוכנות שמופיע בקוד ה-JSON למזהה הסוכנות שלכם.
3. מסירים תגובות, למשל // The date column segments the report by individual days.
4. מרכיבים את פרטי הכניסה של OAuth 2.0 במחרוזת אחת שמופרדת בפסיקים עוקב:
   client-ID,client-secret,refresh-token
   (זו אותה המחרוזת ש-sa360Api.py יוצרת כשמריצים את sa360Api.py --login, כפי שמתואר בהגדרה הרשאה).
5. מפעילים את sa360Api.py באופן הבא:
   sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
   בפקודה שלמעלה, מחליפים ב-CREDENTIALS את המחרוזת שהרכבתם בשלב הקודם.
   מחליפים את השם של שיטת ה-POST בתיבה שלמטה בשדה API-method.

   לדוגמה:
   sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/reports/generate --post < request.txt

הערה:

statisticsCurrency הוא שדה חובה, ולכן צריך לציין usd בבקשה הזו. בדוחות אחרים שכוללים היקף של מפרסם או רמה נמוכה יותר, אפשר לבקש את הדוח שיוחזר במטבע אחר.

מידת העדכניות של נתוני הדיווח

חלק מהמדדים עדכניים יותר מאחרים. לקבלת פרטים, ניתן לעיין במאמר עד כמה נתוני הדיווח עדכניים ב-Search Ads 360?

כדי לוודא שהדוחות כוללים את כל המדדים הזמינים, מומלץ להמתין כ-4 שעות אחרי חצות (אזור הזמן בחשבון מנוע החיפוש) לפני שליחת דוחות על metrics; לדוח conversion, מומלץ להמתין 12 שעות אחרי חצות (אזור הזמן של המפרסם ב-Campaign Manager). אם אתם משתמשים ב-API כדי להעלות נתוני המרות: insert.operation פרטים על הזמינות של הנתונים שהועלו.

גם אחרי כמה ימים, מדד עדיין עשוי להשתנות עקב מסנני ספאם במנוע או מצב אופליין המרות שמועלות דרך ה-API. כדי להוריד את העדכונים האלה בהדרגה שינויים, בקשת דוחות, דוחות על הנתונים שהשתנו מאז ההורדה האחרונה. אם מורידים נתונים מצטברים אנחנו ממליצים לבקש דוח מלא מדי פעם. לדוגמה, יכול להיות שתורידו שינויים מצטברים כל כמה ימים, ותבקשו דוח מלא פעם אחת חודש.

מתי השינויים במאפיינים יופיעו בדוחות?

שינוי מאפיינים שמשתמש מבצע ב-Search Ads 360 מופיע תוך כדקה הדוחות שאתם מורידים דרך ה-API. שינויים שמתבצעים ישירות במנוע החיצוני (לא דרך Search Ads 360) צריך לייבא קודם אל Search Ads 360 באמצעות סנכרון נכנס.

אנחנו ממליצים להחזיר רק את הנתונים שהשתנו כדי לקבוע באילו ישויות יש שינויים במאפיינים.

מהן מודעות ומילות מפתח ללא שיוך?

לפעמים מערכת Search Ads 360 לא יכולה לשייך מדדים למודעה ספציפית. לדוגמה, מודעה עם פורמט שאינו נתמך או שכתובת ה-URL של השרת למעקב אחרי קליקים עם שגיאה יכולה למנוע ממערכת Search Ads 360 לשייך את המדדים של מודעה. בכל קבוצת מודעות, מערכת Search Ads 360 מדווחת על המדדים שלא משויכים להם 'מודעה ללא שיוך'. כדי לבקש את המדדים האלה בדוח, צריך להגדיר includeRemovedEntities אל true. כדי שיהיה קל לראות אילו מודעות לא משויכות, צריך לכלול את קטע הקוד הבא: isUnattributedAd בבקשה.

באופן דומה, לפעמים מערכת Search Ads 360 לא יכולה לשייך מדדים למילת מפתח ספציפית. מצב זה קורה כאשר מתרחשים פערים בדיווח. במקרים כאלה, העמודה keywordId של מילות מפתח ללא שיוך מוגדרת ל-0.

האם הדוחות כוללים המרות מותאמות?

במקרים מסוימים, קשה למדוד המרות. למשל, כשקובצי ה-Cookie של האתר מאחסנים מידע על קליקים על המודעות שלך אינו זמין עקב גורמים, כולל הגדרות הדפדפן. במקרים כאלה, מערכת Floodlight משתמשת בהתאמה לעומס כדי להביא בחשבון את נתוני ההמרות שלא ניתן נמדדים ישירות. כלומר, מערכת Floodlight מחילה את למידת המכונה על נתונים היסטוריים כדי לבנות מודל מספר ההמרות וסכום ההכנסות מההמרות שלא ניתן למדוד. Floodlight יכול להוסיף את ההערכה שהתקבלה למדדי ההמרות שלה, כדי לקבל תמונה מלאה יותר של האופן שבו הפרסום שלכם מניב המרות.

מערכת Floodlight תמיד מחילה את ההתאמה לעומס (scaling) על עמודות הדיווח הבאות:

• dfaActions
• dfaRevenue
• dfaTransactions
• dfaWeightedActions
• עמודות שמורות לדווח על פעילויות ב-Floodlight

conversion הדוח לא כולל המרות מותאמות. מוצגות רק המרות שנמדדו ישירות. מספר ההמרות וסכום ההכנסות בדוח conversion לא צפויות להיות תואמות להמרות ולהכנסות שמדווחות בעמודות שרשומות למעלה.

למה ההמרות הגולמיות לא מסתכמות למדד המצטבר X?

במקרים הנדירים שבהם מדדים מצטברים לא תואמים לאירועים גולמיים ב-Search Ads 360, אפשר לסמוך על מדד מצטבר. כשמדדי המחשוב מצטברים, מערכת Search Ads 360 מנסה לנקות נתונים ולהסיר המרות שחשודות ככפילויות.

מה אם לא מצאתם כאן תשובה לשאלה שלי?

אם יש בעיה שאתם לא מצליחים לפתור אחרי קריאת המשאבים באתר, לפנות לתמיכה ולקבל את הפרטים הבאים מוכנים:

• מזהה הסוכנות ומזהה המפרסם ב-Search Ads 360 שאליהם ניסיתם לגשת

• מספר הפרויקט מ-Google API Console

• שם המשתמש של חשבון Google שבו אתם משתמשים כדי לגשת ל-API.
  זהו החשבון שנשלח הרשאה לגשת ל-Search Ads 360, שהוא אותו חשבון שאתם משתמשים בו כדי להגדיר הרשאה.

• קטע הקוד של הבקשה שלך

• תגובת JSON
  אם התשובה היא שגיאה, הקפידו לכלול את הודעת השגיאה, ולא רק קוד שגיאה מספרי.