סוג הדוח: מפרסם

נתוני דיווח למפרסמים, כולל:

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

בקשה לקטע

שליחת אימייל רגיל Reports.request() או Reports.generate() גוף הבקשה, אבל יש לציין "reportType": "advertiser".

{
...
  "reportType": "advertiser",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

בכל עמודה שרוצים להחזיר או לסנן בדוח, לציין את columnName שמפורט בטבלה שלמטה. אפשר גם לציין headerText, startDate, ו-endDate. לידיעתכם, יש עמודות שאי אפשר לסנן. לעיין באפשרות 'ניתן לסינון' בטבלה שלמטה.

columnNameתיאורהתנהגותסוגניתן לסינון
status סטטוס המפרסם: Active, Paused או Removed. שיוך Status כן
creationTimestamp חותמת הזמן של יצירת המפרסם, בפורמט ISO 8601. שיוך Timestamp כן
lastModifiedTimestamp חותמת הזמן של השינוי האחרון שהתבצע על ידי המפרסם, בפורמט ISO 8601. שיוך Timestamp כן
agency שם הסוכנות. שיוך String כן
agencyId מזהה הסוכנות ב-DS. שיוך ID כן
advertiser שם המפרסם. שיוך String כן
advertiserId מזהה המפרסם ב-DS. שיוך ID כן
dfaAdvertiserId המזהה של המפרסם ב-Campaign Manager שמשויך למפרסם הזה ב-DS. שיוך ID כן
dfaNetworkId המזהה של רשת Campaign Manager שמשויכת למפרסם הזה ב-DS. שיוך ID כן
dfaNetworkTimeZone אזור הזמן ברשת Campaign Manager שמשויכת למפרסם הזה ב-DS בפורמט מסד נתונים של אזור זמן IANA, כמו America/New_York. שיוך String כן
advertiserCurrencyCode קוד המטבע של המפרסם בפורמט ISO 4217. שיוך String כן
googleAnalyticsTimeZone אזור הזמן של התצוגה המפורטת ב-Google Analytics שמקושרת למפרסם הזה ב-DS. נעשה שימוש בפורמט מסד הנתונים של אזור הזמן IANA, למשל America/New_York. שיוך String כן
dfaActions המספר הכולל של פעולות ב-Campaign Manager. ערך Integer כן
dfaRevenue ההכנסה המצטברת מעסקאות של Campaign Manager. ערך Money כן
dfaTransactions המספר הכולל של עסקאות ב-Campaign Manager. ערך Integer כן
dfaWeightedActions סכום משוקלל של פעולות ב-Campaign Manager. ערך Number כן
dfaActionsCrossEnv המספר הכולל של פעולות של מנהל הקמפיין בסביבות שונות. ערך Number כן
dfaRevenueCrossEnv ההכנסה המצטברת מעסקאות של Campaign Manager בסביבות שונות שנוצרות. ערך Money כן
dfaTransactionsCrossEnv המספר הכולל של עסקאות של מנהל קמפיינים בסביבות שונות. ערך Number כן
dfaWeightedActionsCrossEnv הסכום המשוקלל של פעולות מנהל הקמפיין בסביבות שונות. ערך Number כן
avgCpc מחיר ממוצע לקליק. ערך Money כן
avgCpm עלות ממוצעת לאלף חשיפות. ערך Money כן
avgPos מיקום ממוצע. ערך Number כן
clicks קליקים מצטברים. ערך Integer כן
cost העלות המצטברת ששולמה לחשבונות מנוע החיפוש. ערך Money כן
ctr שיעור קליקים ממוצע. ערך Number כן
impr מספר החשיפות הכולל. ערך Integer כן
adWordsConversions הנתונים שהמפרסם הגדיר לדיווח בעמודה 'המרות' ב-Google Ads. כשיוצרים פעולת המרה ב-Google Ads, המפרסם יכול לבחור אם לספור את ההמרות האלה בעמודה 'דיווח על המרות'. ערך Number כן
adWordsConversionValue הערך המצטבר של ההמרות ב-Google Ads. ערך Number כן
adWordsViewThroughConversions המספר הכולל של המרות בעקבות צפייה ב-Google Ads. ערך Integer כן
visits המספר הכולל של ביקורים ב-DS. ערך Integer כן
searchImpressionShare Google Ads ו-Bing Ads בלבד. מספר החשיפות שקיבלתם ברשת החיפוש חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. מוחזר כמספר בין 0.1 ל-1, או, אם השיתוף קטן מ-0.1, המחרוזת < 10%. ערך Impression share כן
searchBudgetLostImpressionShare Google Ads ו-Bing Ads בלבד. משך הזמן באחוזים שהמודעות שלכם לא הוצגו ברשת החיפוש כתוצאה מחוסר בתקציב. מוחזר כמספר בין 0 ל-0.9, או, אם השיתוף גדול מ-0.9, כמחרוזת > 90%. ערך Impression share כן
searchRankLostImpressionShare Google Ads ו-Bing Ads בלבד. משך הזמן באחוזים שהמודעות שלכם לא הוצגו ברשת החיפוש עקב דירוג מודעה נמוך. מוחזר כמספר בין 0 ל-0.9, או, אם השיתוף גדול מ-0.9, כמחרוזת > 90%. ערך Impression share כן
displayImpressionShare Google Ads בלבד. מספר החשיפות שקיבלתם ברשת המדיה חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. מוחזר כמספר בין 0.1 ל-1, או, אם השיתוף קטן מ-0.1, המחרוזת < 10%. ערך Impression share כן
displayBudgetLostImpressionShare Google Ads בלבד. משך הזמן באחוזים שהמודעות שלכם לא הוצגו ברשת המדיה עקב תקציב לא מספיק. מוחזר כמספר בין 0 ל-0.9, או, אם השיתוף גדול מ-0.9, כמחרוזת > 90%. ערך Impression share כן
displayRankLostImpressionShare Google Ads בלבד. משך הזמן באחוזים שהמודעות שלכם לא הוצגו ברשת המדיה עקב דירוג מודעה נמוך. מוחזר כמספר בין 0 ל-0.9, או, אם השיתוף גדול מ-0.9, כמחרוזת > 90%. ערך Impression share כן
qualityScoreAvg Google Ads ו-Bing Ads בלבד. הממוצע של ציון האיכות של המנוע (QS) אחרי שקלול לפי מספר החשיפות, בכל הימים ומילות המפתח שנכללים בדוח. ערך Number כן
topOfPageBidAvg Google Ads בלבד. אומדן של הצעת המחיר הממוצעת לקליק הדרושה בטווח הזמן של הדוח כדי שהמודעות שלך יופיעו באופן קבוע במיקומים העליונים מעל תוצאות החיפוש. ערך Money כן
absoluteTopImpressionPercentage אחוז החשיפות של המודעות שמוצגות בתור המודעה הראשונה מעל לתוצאות החיפוש האורגני. ערך Impression share כן
searchAbsoluteTopImpressionShare מספר החשיפות שהמודעות שלכם קיבלו במיקום הכי גבוה (המודעה הראשונה מעל לתוצאות החיפוש האורגניות) חלקי המספר המשוער של החשיפות במיקום בולט שהן היו יכולות לקבל. ערך Impression share כן
topImpressionPercentage אחוז החשיפות של המודעות שמוצגות במיקום כלשהו מעל תוצאות החיפוש האורגני. ערך Impression share כן
searchTopImpressionShare מספר החשיפות במיקום בולט שהמודעות שלכם קיבלו (במיקום כלשהו מעל תוצאות החיפוש האורגני) חלקי המספר המשוער של החשיפות במיקום בולט שהן היו יכולות לקבל. ערך Impression share כן
searchBudgetLostAbsoluteTopImpressionShare הערכה של התדירות שבה המודעה לא הייתה המודעה הראשונה מעל תוצאות החיפוש האורגניות עקב תקציב נמוך. ערך Impression share כן
searchBudgetLostTopImpressionShare המדד הזה עוזר לכם להבין באיזו תדירות המודעה לא הופיעה בשום מיקום מעל לתוצאות החיפוש האורגניות עקב תקציב נמוך. ערך Impression share כן
searchRankLostAbsoluteTopImpressionShare הערכה של התדירות שבה המודעה לא הייתה המודעה הראשונה מעל תוצאות החיפוש האורגני עקב דירוג מודעה נמוך. ערך Impression share כן
searchRankLostTopImpressionShare הערכה של התדירות שבה המודעה לא הופיעה בשום מיקום מעל לתוצאות החיפוש האורגניות עקב דירוג מודעה נמוך. ערך Impression share כן
date פילוח הדוח לפי ימים. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, אחת לכל יום. העמודה הזו מחזירה את התאריך של כל שורה. פלח Date כן
monthStart מפלחים את הדוח לפי חודשים. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, אחת לכל חודש. העמודה הזו מחזירה את היום הראשון בחודש של כל שורה. פלח Date כן
monthEnd מפלחים את הדוח לפי חודשים. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, אחת לכל חודש. העמודה הזו מחזירה את היום האחרון בחודש של כל שורה. פלח Date כן
quarterStart מפלחים את הדוח לפי רבעונים. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות – אחת לכל רבעון. העמודה הזו מחזירה את היום הראשון של הרבעון של כל שורה. פלח Date כן
quarterEnd מפלחים את הדוח לפי רבעונים. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות – אחת לכל רבעון. העמודה הזו מחזירה את היום האחרון של הרבעון של כל שורה. פלח Date כן
weekStart מפלחים את הדוח לפי שבועות (ראשון עד שבת). כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, אחת לכל שבוע. העמודה הזו מחזירה את היום הראשון (יום ראשון) של כל שורה. פלח Date כן
weekEnd מפלחים את הדוח לפי שבועות (ראשון עד שבת). כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, אחת לכל שבוע. העמודה הזו מחזירה את היום האחרון (שבת) של כל שורה. פלח Date כן
yearStart פילוח הדוח לפי שנים. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, אחת לכל שנה. העמודה הזו מחזירה את היום הראשון בשנה של כל שורה. פלח Date כן
yearEnd פילוח הדוח לפי שנים. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות – אחת לכל שנה. העמודה הזו מחזירה את היום האחרון בשנה של כל שורה. פלח Date כן
deviceSegment הפילוח של הדוח מתבצע לפי מכשיר. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד אחת לכל פלח של מכשיר. העמודה הזו מחזירה את פלח המכשיר בכל שורה. פלח Device segment כן
floodlightGroup מפלחים את הדוח לפי קבוצות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל קבוצה ב-Floodlight. העמודה הזו מחזירה את השם של הקבוצה ב-Floodlight של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח String כן
floodlightGroupId מפלחים את הדוח לפי קבוצות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל קבוצה ב-Floodlight. העמודה הזו מחזירה את מזהה קבוצת Floodlight של DS של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח ID כן
floodlightGroupTag מפלחים את הדוח לפי קבוצות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל קבוצה ב-Floodlight. העמודה הזו מחזירה את תג הקבוצה של Floodlight של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח String כן
floodlightActivity לפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את השם של הפעילות ב-Floodlight של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח String כן
floodlightActivityId לפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את מזהה הפעילות ב-DS של כל שורה ב-DS. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח ID כן
floodlightActivityTag לפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את תג הפעילות ב-Floodlight של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח String כן