סוג הדוח: ביקור

נתוני אירועים גולמיים של ביקורים. ביקור מתרחש בכל פעם שצרכן לוחץ על מודעה ומופנה אוטומטית לדף נחיתה.

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

מאחר שאירועים מתרחשים בתאריכים ספציפיים, בקשה לדוח הזה חייבת לציין timeRange. ניתן לציין אחת מהאפשרויות הבאות:

בקשה לקטע

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

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

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

columnNameתיאורהתנהגותסוגניתן לסינון
status סטטוס הביקור. לא ניתן לשנות את הביקורים, לכן הערך הוא תמיד Active. שיוך Status כן
deviceSegment פלח המכשיר שאליו משויך הביקור: Desktop, Mobile, Tablet או Other. שיוך Device segment כן
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 כן
productTargetId מזהה יעד מוצר ב-DS. שיוך ID כן
productGroupId מזהה קבוצת המוצרים שמשויכת לביקור הזה. רק לביקורים מקמפיינים של שופינג יש מזהי קבוצות מוצרים. אין להשתמש במזהי קבוצות מוצרים כדי להצטרף. שיוך ID כן
ad שם המודעה. שיוך String כן
adId מזהה מודעה ב-DS. הערך 0 מציין שהמודעה ללא שיוך. שיוך ID כן
isUnattributedAd מציין אם המדדים בשורה הזו לא ניתנים לשיוך למודעה מסוימת. לדוגמה, מודעה שהפורמט שלה לא נתמך או כתובת URL שגויה של שרת למעקב אחרי קליקים יכולה למנוע מ-DS לשייך מדדים למודעה. שיוך Boolean כן
inventoryAccountId מספר חשבון המלאי ב-DS שמכיל את המוצר שעליו המשתמש לחץ. מערכת DS יוצרת את המזהה הזה כשמקשרים חשבון מלאי ב-DS. שיוך ID כן
productId המזהה של המוצר שעליו לחצו. שיוך String כן
productCountry המדינה (בפורמט ISO 3166) הרשומה בפיד המלאי שמכיל את המוצר שעליו לחצו. שיוך String כן
productLanguage השפה (ISO 639-1) שהוגדרה עבור הפיד של Merchant Center שמכיל נתונים על המוצר. שיוך String כן
productStoreId החנות במודעת המלאי של החנות המקומית שלחצו עליה. המזהה הזה צריך להתאים למזהי החנויות שמופיעים בפיד המוצרים של חנויות מקומיות. שיוך String כן
productChannel ערוץ המכירות של המוצר שעליו המשתמש לחץ: Online או Local. שיוך Product channel כן
visitId מזהה הביקור ב-DS. שיוך ID כן
visitSearchQuery שאילתת החיפוש שגרמה לביקור הזה. שיוך String כן
visitDate התאריך שבו התרחש הביקור באזור הזמן של חשבון מנוע החיפוש. התאריך הזה משמש לצבירת ביקורים. לדוגמה, כאשר DS צובר ביקורים מ-1 במאי, הוא סופר את כל הביקורים שבהם visitDate הוא 1 במאי. שיוך Date כן
visitTimestamp חותמת הזמן לפי שעון UTC בזמן הביקור. שיוך Timestamp כן
visitNetworkType רשת המודעות שהניבו את הביקור הזה: Content, Search או Other. שיוך Network type כן
visitReferrer כתובת ה-URL המפנה של הביקור. שיוך String כן
visitExternalClickId מחרוזת ייחודית לכל ביקור, שמועברת לדף הנחיתה כפרמטר gclid של כתובת האתר. האפשרות הזו מופעלת רק למפרסמים עם שילוב של Conversion API או של Google Analytics. שיוך String כן
feedItemId המזהה של שורת הפריט בפיד שמשויכת לביקור הזה. שיוך ID כן
feedId המזהה של טבלת הפיד שמשויכת לביקור הזה. שיוך ID כן
feedType סוג הפיד המשויך לביקור הזה. שיוך Feed type כן