מדדי ביצועים ומאפייני הגדרה של מודעות.
אפשר להחזיר את הדוח הזה רק באמצעות בקשה אסינכררונית (כלומר, באמצעות השיטה Reports.request()).
בקשה לקטע טקסט
שולחים גוף בקשה רגיל של Reports.request(), אבל מציינים את הערך "reportType": "ad".
{
...
"reportType": "ad",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
לכל עמודה שרוצים להציג או לסנן בדוח, מציינים את הערך של columnName שמופיע בטבלה הבאה.
אפשר גם לציין את הפרמטרים headerText, startDate ו-endDate.
חשוב לזכור שאי אפשר לסנן עמודות מסוימות. אפשר לעיין בעמודה 'ניתן לסינון' בטבלה שבהמשך.
columnName | תיאור | התנהגות | סוג | אפשר לסנן |
|---|---|---|---|---|
status |
הסטטוס של המודעה: Active, Paused או Removed. חשוב לזכור שלכל קמפיין, קבוצת מודעות, מילת מפתח ומודעה יש סטטוס משלהם. סטטוס |
מאפיין | Status |
כן |
engineStatus |
סטטוס נוסף של המודעה בחשבון של מנוע החיפוש החיצוני. סטטוסים אפשריים (בהתאם לסוג החשבון החיצוני) כוללים active, eligible, creative deleted, creative approved family safe וכו'. |
מאפיין | 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 |
כן |
ad |
שם המודעה. | מאפיין | String |
כן |
adId |
מזהה מודעה ב-DS. ערך של 0 מציין שהמודעה לא משויכת. | מאפיין | ID |
כן |
adEngineId |
המזהה של המודעה בחשבון מנוע החיפוש החיצוני. | מאפיין | ID |
כן |
isUnattributedAd |
מציין אם אי אפשר לשייך את המדדים בשורה הזו למודעה ספציפית. לדוגמה, מודעה בפורמט שאינו נתמך או כתובת URL שגויה של שרת למעקב אחר קליקים יכולות למנוע מ-DS לשייך מדדים למודעה. | מאפיין | Boolean |
כן |
adHeadline |
כותרת המודעה. | מאפיין | String |
כן |
adHeadline2 |
כותרת 2 של המודעה. האפשרות הזו לא זמינה במנועי חיפוש מסוימים. | מאפיין | String |
כן |
adHeadline3 |
כותרת 3 של מודעה. האפשרות הזו לא זמינה במנועי חיפוש מסוימים. | מאפיין | String |
כן |
adDescription1 |
שורת התיאור 1 של המודעה. | מאפיין | String |
כן |
adDescription2 |
שורת תיאור 2 של המודעה. השדה לא זמין במנועי חיפוש מסוימים. | מאפיין | String |
כן |
adDisplayUrl |
כתובת ה-URL לתצוגה של המודעה. | מאפיין | String |
כן |
adLandingPage |
דף הנחיתה של המודעה. כתובות URL של דפי נחיתה ושרתים למעקב אחרי קליקים | מאפיין | String |
כן |
adType |
סוג המודעה: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text או Expanded dynamic search. |
מאפיין | Ad type |
כן |
adPromotionLine |
שורת קידום המכירות של המודעה. הודעה קצרה לקידום מכירות של מודעת מוצר. | מאפיין | String |
כן |
adLabels |
שמות של תוויות שהוקצו ישירות למודעה הזו. תוויות שעברו בירושה לא נכללות. | מאפיין | String list |
כן |
adPathField1 |
שדה 1 בנתיב המודעה. שדות הנתיב 1 ו-2 משולבים עם adDisplayUrl כדי ליצור את כתובת ה-URL שמוצגת במודעה. | מאפיין | String |
כן |
adPathField2 |
שדה 2 בנתיב המודעה. שדות הנתיב 1 ו-2 משולבים עם adDisplayUrl כדי ליצור את כתובת ה-URL שמוצגת במודעה. | מאפיין | String |
כן |
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 |
כן |