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

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

ניתן להחזיר את הדוח הזה רק באמצעות בקשה אסינכרונית (כלומר, בשיטה 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 מזהה הקבוצה ב-DS Floodlight. מאפיין ID כן
floodlightGroupTag תג קבוצה של Floodlight. מאפיין String כן
floodlightActivity שם הפעילות ב-Floodlight. מאפיין String כן
floodlightActivityId מזהה פעילות ב-DS Floodlight. מאפיין 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 שמכיל את המוצר שמשויך להמרה. ה-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 יוצרת מזהה כזה. עבור המרות אונליין, הערך הזה שווה לעמודה 'מזהה המרה' או לעמודה FloodlightFloodlightId, בהתאם להוראות ב-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 מחרוזת ייחודית, עבור הביקור שאליו ההמרה מיוחסת, שמועברת לדף הנחיתה כפרמטר של כתובת האתר gclid. הופעל רק עבור מפרסמים עם שילוב של ממשק 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 כן