נתונים גולמיים של אירועים על המרות.
ניתן להחזיר את הדוח הזה רק באמצעות בקשה אסינכרונית (כלומר, בשיטה Reports.request() ).
אירועים מתרחשים בתאריכים ספציפיים, ולכן בקשה לדוח חייבת לציין timeRange. אפשר לציין כל אחת מהאפשרויות הבאות:
- startDate ו-endDate.
- changedMetricsFromTimestamp (changedAttributesFromTimestamp לא חוקי לאירועים).
בקשת קטע
שליחה של גוף בקשה רגיל של 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 |
כן |