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

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

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

בקשת קטע

שליחת גוף בקשה רגיל של Reports.request() או Reports.create() , אבל ציון של "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	כן