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

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

• 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
  אם התשובה היא שגיאה, יש לכלול את הודעת השגיאה ולא רק את קוד השגיאה המספרי.