מדדי ביצועים ומאפייני תצורה של פריטים בפיד (לדוגמה, תוספי Sitelink, מיקום, שיחה או תוספי אפליקציה).
ניתן להחזיר דוח זה רק באמצעות בקשה אסינכרונית (כלומר, דרך השיטה Reports.request()).
בקשה לקטע
שליחת אימייל רגיל
Reports.request()
גוף הבקשה, אבל יש לציין "reportType": "feedItem"
.
{ ... "reportType": "feedItem", "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 , active וכן הלאה. |
שיוך | 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 |
כן |
sitelinkDisplayText |
טקסט תצוגת ה-Sitelink של הפריט בפיד. | שיוך | String |
כן |
sitelinkDescription1 |
תיאור 1 של Sitelink של הפריט בפיד. | שיוך | String |
כן |
sitelinkDescription2 |
תיאור 2 של Sitelink של הפריט בפיד. | שיוך | String |
כן |
sitelinkLandingPageUrl |
כתובת דף הנחיתה של קישור ה-Sitelink של הפריט בפיד. | שיוך | String |
כן |
sitelinkClickserverUrl |
שם כתובת ה-URL של שרת מעקב הקליקים (clickserver) של הפריט בפיד. | שיוך | String |
כן |
locationBusinessName |
שם העסק המוגדר בתוסף מיקום משודרג. | שיוך | String |
כן |
locationCategory |
הקטגוריה שהוגדרה לעסק בתוסף מיקום משודרג. | שיוך | String |
כן |
locationDetails |
פרטים על עסק המוגדר בתוסף מיקום משודרג. | שיוך | String |
כן |
callPhoneNumber |
מספר טלפון של תוסף שיחה. | שיוך | String |
כן |
callCountryCode |
קוד מדינה של תוסף שיחה. | שיוך | String |
כן |
callIsTracked |
הפונקציה מחזירה את הערך true אם מתבצע מעקב אחר שיחות של תוסף שיחה. אחרת, הערך false. | שיוך | Boolean |
כן |
callCallOnly |
הפונקציה מחזירה את הערך True אם תוסף השיחה מוגדר להציג רק מספר טלפון. הפונקציה מחזירה את הערך False אם מוצגים גם השיחה וגם קישור. | שיוך | Boolean |
כן |
callConversionTracker |
שם הכלי למעקב אחרי המרות שמשויך לתוסף השיחה הזה, אם יש כזה. | שיוך | String |
כן |
callConversionTrackerId |
המזהה של הכלי למעקב אחרי המרות שמשויך לפריט בפיד הזה, אם יש כזה. | שיוך | ID |
כן |
appId |
מזהה האפליקציה שהוגדר לתוסף האפליקציה. | שיוך | String |
כן |
appStore |
סוג חנות האפליקציות (Apple App Store, חנות Google Play) שמוגדר לתוסף אפליקציה. | שיוך | App store |
כן |
feedItemId |
מזהה שורת הפריט בפיד. | שיוך | ID |
כן |
feedId |
המזהה של טבלת הפיד | שיוך | ID |
כן |
clicksWithFeedItemShowing |
קליקים על קישור כלשהו במודעה בזמן שהפריט בפיד הוצג. העמודה הזו מחזירה ערך רק בדוח פריטים בפיד או בדוח שמפולח לפי עמודה של פריט פיד. | ערך | Integer |
כן |
costWithFeedItemShowing |
העלות של כל המודעות כשהפריט בפיד הוצג. העמודה הזו מחזירה ערך רק בדוח פריטים בפיד או בדוח שמפולח לפי עמודה של פריט פיד. | ערך | Money |
כן |
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 |
כן |
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 |
כן |