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

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

ניתן להחזיר דוח זה רק באמצעות בקשה אסינכרונית (כלומר, דרך המתודה 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 שמכיל את המוצר המשויך להמרה. מערכת 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 מחרוזת ייחודית, עבור הביקור שאליו משויכת ההמרה, מועברת אל דף הנחיתה בתור הפרמטר 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 כן