סוג הדוח: adGroupTarget

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

ניתן להחזיר דוח זה רק באמצעות בקשה אסינכרונית (כלומר, דרך המתודה Reports.request()).

בקשה לקטע

שליחת אימייל רגיל Reports.request() גוף הבקשה, אבל יש לציין "reportType": "adGroupTarget".

{
...
  "reportType": "adGroupTarget",
  "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 כן
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 כן
engineRemarketingList השם של רשימת הרימרקטינג שמשויכת ליעד. שיוך String כן
engineRemarketingListBidModifier התאמת הצעת המחיר שמשויכת ליעד. שיוך Number כן
dynamicSearchAdsTargetConditions הקריטריונים שיעד המודעה הדינמית משתמש בהם כדי לבחור דפים בדומיין האתר. שיוך String לא
dynamicSearchAdsTargetCpcBid הגדרת העלות המקסימלית לקליק (max. CPC) של יעד המודעה הדינמית. שיוך Money כן
dynamicSearchAdsTargetLandingPageUrl תבנית כתובת ה-URL של יעד המודעה הדינמית. שיוך String כן
dynamicSearchAdsTargetCoverage אחוז הדפים באתר של המפרסם שתואמים ליעד המודעה הדינמית. שיוך Number כן
locationTargetName השם של המיקום הגיאוגרפי לטירגוט. שיוך String כן
locationTargetBidModifier התאמת הצעת המחיר שמשויכת למיקום הגיאוגרפי לטירגוט. שיוך Number כן
ageTargetAgeRange טווח הגילאים של הטירגוט לפי גיל. שיוך Age range כן
ageTargetBidModifier התאמת הצעת המחיר שמשויכת לטירגוט לפי גיל. שיוך Number כן
genderTargetGenderType סוג המגדר של הטירגוט לפי מגדר: זכר, נקבה, לא ידוע. שיוך Gender type כן
genderTargetBidModifier התאמת הצעת המחיר שמשויכת לטירגוט לפי מגדר. שיוך Number כן
unclassifiedTargetName שם היעד הלא מסווג. שיוך String כן
unclassifiedTargetType הסוג של היעד הלא מסווג: Dynamic search. שיוך Unclassified target type כן
adGroupTargetId מזהה ה-DS שנוצר ליעד של קבוצת מודעות. שיוך ID כן
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 כן