סוג הדוח: המרה

נתוני אירועים גולמיים לגבי המרות.

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

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

בקשה לקטע טקסט

שולחים גוף בקשה רגיל של Reports.request(), אבל מציינים את הערך "reportType": "conversion". 

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

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

columnNameתיאורהתנהגותסוגאפשר לסנן
status הסטטוס של ההמרה: Active או Removed. מאפיין Status כן
deviceSegment פלח המכשירים שאליו משויכת ההמרה: Desktop,‏ Mobile,‏ Tablet או Other. מאפיין Device segment כן
floodlightGroup שם הקבוצה ב-Floodlight. מאפיין String כן
floodlightGroupConversionType סוג ההמרות שנוצרו על ידי הפעילויות ב-Floodlight בקבוצה הזו: Action או Transaction. מאפיין Conversion type כן
floodlightGroupId מזהה הקבוצה ב-Floodlight של DS. מאפיין ID כן
floodlightGroupTag תג קבוצה ב-Floodlight. מאפיין String כן
floodlightActivity השם של הפעילות ב-Floodlight. מאפיין String כן
floodlightActivityId מזהה הפעילות ב-Floodlight של DS. מאפיין ID כן
floodlightActivityTag תג פעילות ב-Floodlight. מאפיין String כן
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 שמכיל את המוצר שמשויך ל-conversion. המערכת של DS יוצרת את המזהה הזה כשמקשרים חשבון מלאי שטחי פרסום ב-DS. מאפיין ID כן
productId המזהה של המוצר שמשויך להמרה הזו. מאפיין String כן
productCountry המדינה (בפורמט ISO 3166) שרשומה בפיד המלאי שמכיל את המוצר שמשויך להמרה הזו. מאפיין String כן
productLanguage השפה (ISO 639-1) של המוצר שמשויך להמרה הזו. מאפיין String כן
productStoreId החנות במודעת המלאי של החנות המקומית שמשויכת לאותו המרה. הערך הזה צריך להתאים למזהי החנויות שמשמשים בפיד המוצרים של החנויות המקומיות. מאפיין String כן
productChannel ערוץ המכירות של המוצר שמשויך להמרה: Online או Local. מאפיין Product channel כן
conversionId מזהה שנוצר על ידי Search Ads 360 לכל המרה. מאפיין ID כן
advertiserConversionId בהמרות אופליין, זהו מזהה שמסופק על ידי המפרסמים. אם המפרסם לא מציין מזהה כזה, מערכת Search Ads 360 יוצרת מזהה כזה. בהמרות אונליין, הערך הזה שווה לעמודה conversionId או לעמודה floodlightOrderId, בהתאם להוראות של המפרסם ב-Floodlight. מאפיין String כן
conversionType סוג ההמרה: Action או Transaction. מאפיין Conversion type כן
conversionRevenue הסכום הכולל של ההמרה בדולר. מאפיין Money כן
conversionQuantity כמות הפריטים שתועדו בהמרה, כפי שנקבע על ידי הפרמטר qty. המפרסם אחראי לאכלוס דינמי של הפרמטר (למשל, מספר הפריטים שנמכרו בהמרה). אחרת, הערך שמוגדר כברירת מחדל הוא 1. מאפיין Number כן
conversionDate התאריך שבו התרחשה ההמרה, לפי אזור הזמן של הרשת ב-Campaign Manager. התאריך הזה משמש לצבירה של מדדי ההמרות. לדוגמה, כשמערכת DS אוספת פעולות ל-1 במאי, היא סופרת את כל ההמרות מסוג פעולה שהערך של השדה conversionDate שלהן הוא 1 במאי. מאפיין Date כן
conversionTimestamp חותמת הזמן לפי שעון UTC שבה ההמרה התרחשה. מאפיין Timestamp כן
conversionLastModifiedTimestamp חותמת הזמן בשעון UTC של השינוי האחרון בהמרה. מאפיין Timestamp כן
conversionAttributionType הגורם שאליו משויכת ההמרה: Visit או Keyword+Ad. מאפיין Conversion attribution type כן
conversionVisitId מזהה הביקור ב-DS שאליו משויכת ההמרה. מאפיין ID כן
conversionVisitTimestamp חותמת הזמן בשעון UTC של הביקור שאליו משויכת ההמרה. מאפיין Timestamp כן
conversionVisitExternalClickId מחרוזת ייחודית של הביקור שאליו משויכת ההמרה, שמועברת לדף הנחיתה כפרמטר כתובת ה-URL gclid. התכונה מופעלת רק למפרסמים עם שילוב של Conversion API או שילוב של Google Analytics. מאפיין String כן
conversionSearchTerm מונח החיפוש שהוביל להמרה. מאפיין String כן
floodlightOriginalRevenue ההכנסה המקורית ללא שינוי שמשויכת לאירוע ב-Floodlight (במטבע של הדוח הנוכחי), לפני השינויים בהוראות המטבע ב-Floodlight. מאפיין Money כן
floodlightEventRequestString מחרוזת הבקשה של ההמרה ב-Floodlight. מאפיין String כן
floodlightReferrer אתר המפנה של ההמרה ב-Floodlight. מאפיין String כן
floodlightOrderId מזהה ההזמנה ב-Floodlight שסיפק המפרסם עבור ההמרה. מאפיין String כן
feedItemId המזהה של שורת פריט הפיד שמשויכת להמרה הזו. מאפיין ID כן
feedId המזהה של טבלת הפיד שמשויכת להמרה הזו. מאפיין ID כן
feedType סוג הפיד שמשויך להמרה הזו. מאפיין Feed type כן