סוג הדוח: מודעה

מדדי ביצועים ומאפייני הגדרות של מודעות.

ניתן להחזיר דוח זה רק באמצעות בקשה אסינכרונית (כלומר, דרך השיטה 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 כן