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