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