מדדי ביצועים ומאפייני הגדרות של מודעות.
ניתן להחזיר דוח זה רק באמצעות בקשה אסינכרונית (כלומר, דרך השיטה Reports.request()).
בקשה לקטע
שליחת אימייל רגיל
Reports.request()
גוף הבקשה, אבל יש לציין "reportType": "ad"
.
{ ... "reportType": "ad", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
בכל עמודה שרוצים להחזיר או לסנן בדוח,
לציין את columnName
שמפורט בטבלה שלמטה.
אפשר גם לציין
headerText,
startDate,
ו-endDate.
לידיעתכם, יש עמודות שאי אפשר לסנן. לעיין באפשרות 'ניתן לסינון' בטבלה שלמטה.
columnName | תיאור | התנהגות | סוג | ניתן לסינון |
---|---|---|---|---|
status |
הסטטוס של המודעה: Active , Paused או Removed . לתשומת ליבכם: לקמפיינים, לקבוצות של מודעות, למילות מפתח ולמודעות יש סטטוס משלה. מידע נוסף זמין בקטע סטטוס. |
שיוך | Status |
כן |
engineStatus |
הסטטוס הנוסף של המודעה בחשבון מנוע החיפוש החיצוני. סטטוסים אפשריים (בהתאם לסוג החשבון החיצוני) כוללים active , eligible , creative deleted , creative approved family safe וכו'. |
שיוך | String |
כן |
creationTimestamp |
חותמת הזמן של יצירת המודעה, בפורמט ISO 8601. | שיוך | Timestamp |
כן |
lastModifiedTimestamp |
חותמת הזמן של השינוי האחרון במודעה, בפורמט ISO 8601. | שיוך | Timestamp |
כן |
agency |
שם הסוכנות. | שיוך | String |
כן |
agencyId |
מזהה הסוכנות ב-DS. | שיוך | ID |
כן |
advertiser |
שם המפרסם. | שיוך | String |
כן |
advertiserId |
מזהה המפרסם ב-DS. | שיוך | ID |
כן |
account |
שם חשבון מנוע החיפוש. | שיוך | String |
כן |
accountId |
מספר חשבון מנוע החיפוש ב-DS. | שיוך | ID |
כן |
accountEngineId |
המספר המזהה של החשבון בחשבון מנוע החיפוש החיצוני. | שיוך | String |
כן |
accountType |
סוג חשבון מנוע החיפוש: Google AdWords , Bing Ads , Yahoo Japan Listing Ads , Yahoo Search Marketing , Yahoo Gemini , Baidu או Comparison Shopping . |
שיוך | Engine type |
כן |
campaign |
שם קמפיין. | שיוך | String |
כן |
campaignId |
מזהה הקמפיין ב-DS. | שיוך | ID |
כן |
campaignStatus |
הסטטוס של הקמפיין שמכיל את הפריט הזה. | שיוך | Status |
כן |
adGroup |
שם קבוצת המודעות. | שיוך | String |
כן |
adGroupId |
מזהה קבוצת מודעות ב-DS. | שיוך | ID |
כן |
adGroupStatus |
הסטטוס של קבוצת המודעות שמכילה את הפריט הזה. | שיוך | Status |
כן |
ad |
שם המודעה. | שיוך | String |
כן |
adId |
מזהה מודעה ב-DS. הערך 0 מציין שהמודעה ללא שיוך. | שיוך | ID |
כן |
adEngineId |
המזהה של המודעה בחשבון מנוע החיפוש החיצוני. | שיוך | ID |
כן |
isUnattributedAd |
מציין אם המדדים בשורה הזו לא ניתנים לשיוך למודעה מסוימת. לדוגמה, מודעה שהפורמט שלה לא נתמך או כתובת URL שגויה של שרת למעקב אחרי קליקים יכולה למנוע מ-DS לשייך מדדים למודעה. | שיוך | Boolean |
כן |
adHeadline |
כותרת המודעה. | שיוך | String |
כן |
adHeadline2 |
כותרת מודעה 2; אינו זמין במנועים מסוימים. | שיוך | String |
כן |
adHeadline3 |
כותרת מודעה 3; אינו זמין במנועים מסוימים. | שיוך | String |
כן |
adDescription1 |
שורת תיאור 1 של מודעה. | שיוך | String |
כן |
adDescription2 |
שורת תיאור 2 של מודעה; אינו זמין במנועים מסוימים. | שיוך | String |
כן |
adDisplayUrl |
כתובת URL לתצוגה של מודעה. | שיוך | String |
כן |
adLandingPage |
דף הנחיתה של המודעה. מידע נוסף זמין בקטע כתובות URL של דפי נחיתה ושל שרת למעקב אחרי קליקים. | שיוך | String |
כן |
adType |
סוג המודעה: Text , Product , Dynamic search , Mobile app install , Call-Only , Expanded text או Expanded dynamic search . |
שיוך | Ad type |
כן |
adPromotionLine |
שורה לקידום מודעה. מסר קצר לקידום מכירות של מודעת מוצר. | שיוך | String |
כן |
adLabels |
שמות של תוויות שהוקצו ישירות למודעה הזו. תוויות שעברו בירושה לא נכללות. | שיוך | String list |
כן |
adPathField1 |
שדה 1 בנתיב שיוצג במודעה. שדות הנתיב 1 ו-2 משולבים עם adDisplayUrl כדי ליצור את כתובת ה-URL שמוצגת במודעה. | שיוך | String |
כן |
adPathField2 |
שדה 2 בנתיב המודעה. שדות הנתיב 1 ו-2 משולבים עם adDisplayUrl כדי ליצור את כתובת ה-URL שמוצגת במודעה. | שיוך | String |
כן |
effectiveLabels |
השמות של כל התוויות שעברו בירושה או שהוקצו ישירות למודעה הזו. | שיוך | String list |
כן |
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 |
כן |
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 |
כן |