מדדי ביצועים ומאפייני תצורה של יעדי מוצרים. יעדי מוצרים שימשו עבור קמפיינים של מודעות פרטי מוצר ב-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 |
המספר הכולל של פעולות Campaign Manager בסביבות שונות. | ערך | Number |
כן |
dfaRevenueCrossEnv |
ההכנסה המצטברת שנוצרת מעסקאות של Campaign Manager בסביבות שונות. | ערך | Money |
כן |
dfaTransactionsCrossEnv |
המספר הכולל של עסקאות Campaign Manager בסביבות שונות. | ערך | Number |
כן |
dfaWeightedActionsCrossEnv |
סכום משוקלל של פעולות Campaign Manager בסביבות שונות. | ערך | 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. עמודה זו מחזירה את מזהה הקבוצה ב-DS Floodlight בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים. | פלח | ID |
כן |
floodlightGroupTag |
המערכת תפלח את הדוח לפי קבוצות Floodlight. כל שורה והמדדים המצטברים שלה יפוצלו למספר שורות, אחת לכל קבוצת Floodlight. העמודה הזו מחזירה את התג של קבוצת Floodlight בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים. | פלח | String |
כן |
floodlightActivity |
מפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את השם של פעילות ב-Floodlight בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים. | פלח | String |
כן |
floodlightActivityId |
מפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את מזהה הפעילות ב-Floodlight ב-DS בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים. | פלח | ID |
כן |
floodlightActivityTag |
מפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את תג הפעילות ב-Floodlight בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים. | פלח | String |
כן |