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

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

ניתן להחזיר את הדוח הזה רק באמצעות בקשה אסינכרונית (כלומר, בשיטה 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 מחרוזת ייחודית לכל ביקור שמועבר לדף הנחיתה כפרמטר של כתובת URL ב-gclid. הופעל רק עבור מפרסמים עם שילוב של ממשק API להמרות או שילוב של Google Analytics. מאפיין String כן
feedItemId המזהה של שורת הפריט בפיד המשויכת לביקור הזה. מאפיין ID כן
feedId המזהה של טבלת הפיד המשויכת לביקור הזה. מאפיין ID כן
feedType סוג הפיד המשויך לביקור הזה. מאפיין Feed type כן