סוג הדוח: productTarget

מדדי ביצועים ומאפייני תצורה של יעדי מוצרים. יעדי מוצרים שימשו בקמפיינים של מודעות פרטי מוצר ב-Google Ads כדי לציין אילו מוצרים בחשבון Google Merchant Center יפעילו מודעות פרטי מוצר (מודעות שופינג) להופיע בחיפושים קשורים ב-Google. הקמפיינים של טירגוט לפי מוצר וקמפיינים של מודעות פרטי מוצר הוחלפו בקמפיינים של שופינג ב-Google Ads. מ-DS, עדיין אפשר לבקש דוחות של מדדים היסטוריים ששויכו לקמפיינים של מודעות פרטי מוצר לפני השדרוג לקמפיינים של שופינג.

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

בקשה לקטע

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

{
...
  "reportType": "productTarget",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

בכל עמודה שרוצים להחזיר או לסנן בדוח, לציין את columnName שמפורט בטבלה שלמטה. אפשר גם לציין headerText, startDate, ו-endDate. לידיעתכם, יש עמודות שאי אפשר לסנן. לעיין באפשרות 'ניתן לסינון' בטבלה שלמטה.

columnName	תיאור	התנהגות	סוג	ניתן לסינון
status	הסטטוס של הטירגוט לפי מוצר: Active, Paused או Removed. לתשומת ליבכם: לקמפיינים, לקבוצות של מודעות, לטירגוט לפי מוצר ולמודעות יש סטטוס משלה. מידע נוסף זמין בקטע סטטוס.	שיוך	Status	כן
engineStatus	סטטוס נוסף של הטירגוט לפי מוצר בחשבון מנוע החיפוש החיצוני. סטטוסים אפשריים (בהתאם לסוג החשבון החיצוני) כוללים review, campaign paused וכן הלאה.	שיוך	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	כן
productTargetId	מזהה יעד מוצר ב-DS.	שיוך	ID	כן
productTargetFilter	מסנן מוצרים בחשבון Google Merchant Center עם יעד מוצר זה. אפשר לציין קריטריונים להתאמה באמצעות מאפיינים כמו מזהי מוצרים, מותג וכו'.	שיוך	String	לא
productTargetEngineId	המזהה של הטירגוט לפי מוצר בחשבון מנוע החיפוש החיצוני.	שיוך	ID	כן
productTargetLandingPage	הערך שמציין את כתובת ה-URL הסופית שאליה המשתמש יבקר אחרי שילחץ על מודעת השופינג שלכם. פרטים נוספים זמינים בדפי הנחיתה של מודעות שופינג.	שיוך	String	כן
productTargetClickserverUrl	כתובת ה-URL שמשמשת את DS למעקב אחרי פעילות. משתמש שילחץ על מודעת שופינג יבקר קודם בכתובת ה-URL של השרת למעקב אחרי קליקים, ואז יופנה לדף הנחיתה הסופי. פרטים נוספים זמינים בדפי הנחיתה של מודעות שופינג.	שיוך	String	כן
productTargetLabels	שמות של תוויות שהוקצו ישירות לטירגוט לפי מוצר הזה; תוויות שעברו בירושה לא נכללות.	שיוך	String list	כן
productTargetMaxCpc	ביטול של המחיר המקסימלי לקליק של קבוצת המודעות ומגדיר את הסכום המקסימלי שאתם מוכנים לשלם אם מישהו לוחץ על מודעה למוצר עבור יעד המוצר הספציפי הזה. אם השדה הזה ריק, הטירגוט לפי מוצר ישתמש בעלות המקסימלית לקליק של קבוצת המודעות.	שיוך	Money	כן
effectiveProductTargetMaxCpc	העלות המקסימלית לקליק (max. CPC) שחלה על יעד מוצר זה. הערך הזה יהיה זהה לערך של העלות המקסימלית לקליק בקבוצת המודעות, או, אם היעד לפי מוצר מבטל את ההגדרה של קבוצת המודעות, הערך של העלות המקסימלית לקליק של היעד לפי מוצר.	שיוך	Money	כן
productTargetMaxBid	אם הטירגוט לפי מוצר הזה מנוהל על ידי שיטת הבידינג DS, שיטת הבידינג אף פעם לא תגדיל את הצעות המחיר מעבר למגבלה הזו. מידע נוסף זמין בקטע החלת שיטת בידינג על טירגוטים לפי מוצרים.	שיוך	Money	כן
productTargetMinBid	אם הטירגוט לפי מוצר הזה מנוהל על ידי שיטת בידינג של DS, שיטת הבידינג אף פעם לא תקטין את הצעות המחיר מתחת למגבלה הזו. מידע נוסף זמין בקטע החלת שיטת בידינג על טירגוטים לפי מוצרים.	שיוך	Money	כן
effectiveBidStrategyId	מזהה ה-DS של שיטת הבידינג שהוקצתה לישות הזו או הועברה בירושה לישות הזו.	שיוך	ID	כן
effectiveBidStrategy	השם של שיטת הבידינג שהוקצתה לישות הזו או הועברה בירושה לישות הזו.	שיוך	String	כן
bidStrategyInherited	שדה זה מציין אם שיטת הבידינג של הישות הזו עברה בירושה.	שיוך	Boolean	כן
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	כן