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

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

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

בקשה לקטע טקסט

שולחים גוף בקשה רגיל של 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	המספר הכולל של פעולות ב-Campaign Manager בסביבות שונות.	ערך	Number	כן
dfaRevenueCrossEnv	ההכנסה המצטברת שנוצרה מעסקאות ב-Campaign Manager בסביבות שונות.	ערך	Money	כן
dfaTransactionsCrossEnv	המספר הכולל של עסקאות ב-Campaign Manager בסביבות שונות.	ערך	Number	כן
dfaWeightedActionsCrossEnv	סכום משוקלל של פעולות ב-Campaign Manager בסביבות שונות.	ערך	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. העמודה הזו מחזירה את מזהה הקבוצה של DS Floodlight בכל שורה. חשוב לזכור שלמדדים מסוימים אין ערכים מפולחים ב-Floodlight, כמו קליקים וביקורים.	פלח	ID	כן
floodlightGroupTag	הדוח מפולח לפי קבוצות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד שורה אחת לכל קבוצה ב-Floodlight. העמודה הזו מחזירה את תג הקבוצה של Floodlight לכל שורה. שימו לב: למדדים מסוימים אין ערכים מפולחים ב-Floodlight, כמו קליקים וביקורים.	פלח	String	כן
floodlightActivity	הדוח מפולח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד שורה אחת לכל פעילות ב-Floodlight. בעמודה הזו מוצג השם של הפעילות ב-Floodlight בכל שורה. חשוב לזכור שלמדדים מסוימים אין ערכים מפולחים ב-Floodlight, כמו קליקים וביקורים.	פלח	String	כן
floodlightActivityId	הדוח מפולח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד שורה אחת לכל פעילות ב-Floodlight. בעמודה הזו מופיע מזהה הפעילות ב-Floodlight של DS בכל שורה. שימו לב: למדדים מסוימים אין ערכים מפולחים ב-Floodlight, כמו קליקים וביקורים.	פלח	ID	כן
floodlightActivityTag	הדוח מפולח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד שורה אחת לכל פעילות ב-Floodlight. בעמודה הזו מופיע תג הפעילות ב-Floodlight של כל שורה. חשוב לזכור שלמדדים מסוימים אין ערכים מפולחים ב-Floodlight, כמו קליקים וביקורים.	פלח	String	כן