סוג הדוח: מילת מפתח

מדדי ביצועים ומאפייני הגדרות של מילות מפתח.

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

בקשה לקטע

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

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

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

columnName	תיאור	התנהגות	סוג	ניתן לסינון
status	הסטטוס של מילת המפתח: Active, Paused או Removed. לתשומת ליבכם: לקמפיינים, לקבוצות של מודעות, למילות מפתח ולמודעות יש סטטוס משלה. מידע נוסף זמין בקטע סטטוס.	שיוך	Status	כן
engineStatus	הסטטוס הנוסף של מילת המפתח בחשבון מנוע החיפוש החיצוני. סטטוסים אפשריים (בהתאם לסוג החשבון החיצוני) כוללים criterion rarely served, criterion below first page bid, criterion low quality score, 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	כן
keywordId	מזהה מילת מפתח ב-DS. הערך 0 מציין שאין למילת המפתח שיוך.	שיוך	ID	כן
keywordMatchType	סוג התאמה של מילת מפתח: Broad, Exact, Phrase או Content.	שיוך	Match type	כן
keywordText	טקסט של מילת מפתח.	שיוך	String	כן
keywordEngineId	המזהה של מילת המפתח בחשבון מנוע החיפוש החיצוני.	שיוך	ID	כן
keywordMaxCpc	ביטול של המחיר המקסימלי לקליק של קבוצת המודעות והגדרה של הסכום המקסימלי שאתם מוכנים לשלם אם מישהו לוחץ על מודעה עבור מילת המפתח הספציפית הזו. אם השדה הזה ריק, מילת המפתח תשתמש בעלות המקסימלית לקליק של קבוצת המודעות.	שיוך	Money	כן
effectiveKeywordMaxCpc	העלות המקסימלית לקליק (max. CPC) שמוגדרת למילת המפתח הזו. הערך הזה יהיה זהה לערך של העלות המקסימלית לקליק בקבוצת המודעות, או, אם מילת המפתח מבטלת את ההגדרה של קבוצת המודעות, העלות המקסימלית לקליק של מילת המפתח עצמה.	שיוך	Money	כן
keywordLandingPage	כתובת ה-URL הסופית שאליה המשתמש יבקר אחרי שילחץ על המודעה. מידע נוסף זמין בקטע כתובות URL של דפי נחיתה ושל שרת למעקב אחרי קליקים.	שיוך	String	כן
keywordClickserverUrl	כתובת ה-URL שמשמשת את DS למעקב אחרי פעילות. משתמש שילחץ על מודעה יבקר קודם בכתובת ה-URL של השרת למעקב אחרי קליקים, ואז יופנה לדף הנחיתה הסופי. מידע נוסף זמין בקטע כתובות URL של דפי נחיתה ושל שרת למעקב אחרי קליקים.	שיוך	String	כן
isDisplayKeyword	מציינת אם זו מילת מפתח למעקב אחרי ביקורים שמשמשת לדיווח על מודעות לרשת המדיה ועל מיקומי מודעות.	שיוך	Boolean	כן
keywordMaxBid	אם מילת המפתח הזו מנוהלת על ידי שיטת בידינג של DS, שיטת הבידינג אף פעם לא תעלה הצעות מחיר שחורגות מהמגבלה הזו. איך מחילים שיטת בידינג על מילות מפתח	שיוך	Money	כן
keywordMinBid	אם מילת המפתח הזו מנוהלת על ידי שיטת בידינג של DS, שיטת הבידינג אף פעם לא תקטין את הצעות המחיר מתחת למגבלה הזו. איך מחילים שיטת בידינג על מילות מפתח	שיוך	Money	כן
keywordUrlParams	פרמטרים נוספים של כתובות אתרים נוספו לדף הנחיתה. כדאי לעיין בקטע הוספת פרמטרים של כתובות אתרים.	שיוך	String	כן
bingKeywordParam2	Param2 של מילת מפתח ב-Bing Ads.	שיוך	String	כן
bingKeywordParam3	Param3 של מילת מפתח ל-Bing Ads.	שיוך	String	כן
keywordLabels	שמות של תוויות שהוקצו ישירות למילת המפתח הזו; תוויות שעברו בירושה לא נכללות.	שיוך	String list	כן
qualityScoreCurrent	Google Ads ו-Bing Ads בלבד. הערך העדכני ביותר של ציון האיכות (QS) של המנוע עבור מילת מפתח. שימו לב שהעמודה הזו תמיד מדווחת על ציון האיכות האחרון של מילת המפתח, בלי קשר לטווח הזמן שמוגדר בדוח.	שיוך	Integer	כן
topOfPageBidCurrent	Google Ads בלבד. אומדן של הצעת המחיר הנוכחית לקליק הדרושה כדי שהמודעה שלך תופיע באופן קבוע במיקומים העליונים מעל תוצאות החיפוש. חשוב לשים לב שהעמודה הזו תמיד מדווחת על העלות לקליק שנדרשת כרגע, בלי קשר לטווח הזמן שמוגדר בדוח.	שיוך	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	כן
qualityScoreAvg	Google Ads ו-Bing Ads בלבד. הממוצע המשוקלל לפי חשיפות של ציון האיכות של המנוע (QS) בכל הימים ומילות המפתח שנכללים בדוח.	ערך	Number	כן
topOfPageBidAvg	Google Ads בלבד. אומדן של הצעת המחיר הממוצעת לקליק הדרושה בטווח הזמן של הדוח כדי שהמודעות שלך יופיעו באופן קבוע במיקומים העליונים מעל תוצאות החיפוש.	ערך	Money	כן
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	כן
ad	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את השם של המודעה בכל שורה.	פלח	String	כן
adId	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את מזהה ה-DS של המודעה בכל שורה.	פלח	ID	כן
isUnattributedAd	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. בעמודה הזו מצוין אם לא ניתן לשייך את המדדים בשורה הזו למודעה מסוימת.	פלח	Boolean	כן
adHeadline	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את הכותרת של המודעה בכל שורה.	פלח	String	כן
adHeadline2	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את כותרת 2 של המודעה בכל שורה. האפשרות לא זמינה במנועים מסוימים.	פלח	String	כן
adHeadline3	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את הכותרת 3 של המודעה בכל שורה. האפשרות לא זמינה במנועים מסוימים.	פלח	String	כן
adDescription1	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את שורת התיאור 1 של המודעה בכל שורה.	פלח	String	כן
adDescription2	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את שורת תיאור 2 של המודעה בכל שורה.	פלח	String	כן
adDisplayUrl	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את כתובת ה-URL לתצוגה של המודעה בכל שורה.	פלח	String	כן
adLandingPage	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את דף הנחיתה של המודעה בכל שורה.	פלח	String	כן
adType	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את סוג המודעה בכל שורה: Text או Product.	פלח	Ad type	כן
adPromotionLine	מפלחים את הדוח לפי מודעות. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל מודעה. העמודה הזו מחזירה את קו המבצע של מודעת המוצר בכל שורה.	פלח	String	כן