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

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

ניתן להחזיר את הדוח הזה רק באמצעות בקשה אסינכרונית (כלומר, בשיטה 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 הסופית שהמשתמש יבקר בה אחרי שילחץ על המודעה. כדאי לעיין בכתובות של דפי נחיתה וכתובות אתרים של שרתי קליקים.	מאפיין	String	כן
keywordClickserverUrl	כתובת ה-URL שמשמשת את DS למעקב אחר פעילות. משתמש שלוחץ על מודעה יכול קודם לבקר בכתובת ה-URL של שרת הקליקים, ולאחר מכן יופנה לדף הנחיתה הסופי. כדאי לעיין בכתובות של דפי נחיתה וכתובות אתרים של שרתי קליקים.	מאפיין	String	כן
isDisplayKeyword	מציין אם זו מילת מפתח המשמשת כ-placeholder, והיא משמשת לדיווח ברשת המדיה ובמיקום.	מאפיין	Boolean	כן
keywordMaxBid	אם מילת המפתח הזו מנוהלת בשיטת בידינג ב-DS, שיטת הבידינג לעולם לא תגדיל את הצעות המחיר מעבר למגבלה הזו. מידע נוסף זמין במאמר החלת שיטת בידינג על מילות מפתח.	מאפיין	Money	כן
keywordMinBid	אם מילת המפתח הזו מנוהלת באמצעות שיטת בידינג ב-DS, שיטת הבידינג אף פעם לא תקטין את הצעות המחיר מתחת למגבלה הזו. מידע נוסף זמין במאמר החלת שיטת בידינג על מילות מפתח.	מאפיין	Money	כן
keywordUrlParams	פרמטרים נוספים של כתובת URL נוספו לדף הנחיתה. עיינו בהוספת פרמטרים של כתובות URL.	מאפיין	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	המספר הכולל של פעולות 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	כן
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. עמודה זו מחזירה את מזהה הקבוצה ב-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	כן
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	כן