במדריך הזה מוסבר איך להשתמש בפונקציונליות של דיווח על המרות ב-Google Analytics Data API v1. התכונה הזו מאפשרת ליצור דוחות שמתמקדים באירועי המרה, עם תמיכה במודלים שונים של שיוך (Attribution). דוחות המרות שנוצרו באמצעות Data API דומים לדוחות השיוך (Attribution) שאפשר למצוא בקטע פרסום > המרות בממשק המשתמש של Google Analytics. מידע נוסף זמין במאמר במרכז העזרה בנושא הדוח "ביצועי המרות".
המטרה של דיווח על המרות
דיווח על המרות מאפשר לנתח את היעילות של מאמצי השיווק שלכם על ידי שיוך המרות לקמפיינים, למקורות ולאמצעי הגעה ספציפיים. בשונה מדוחות רגילים שמבוססים על אירועים ורק סופרים אירועים, בדיווח על המרות מופעל מודל שיוך (Attribution) כדי לחלק את הקרדיט בין נקודות המגע עם הלקוח שהובילו להמרה.
דוחות המרות לעומת דוחות מבוססי-אירועים
- דוחות מבוססי-אירועים: מספקים ספירות גולמיות של אירועים (למשל,
eventCount) ועוזרים להבין את הפעילות הכללית בנכס. - דוחות המרות: מתמקדים באירועים שסומנו כהמרות. הם משתמשים במאפיינים ובמדדים ספציפיים (ראו סכימת דיווח על המרות) ומאפשרים לכם לראות נתונים משויכים על סמך מודלים כמו "מבוסס-נתונים" או "קליק אחרון".
הפעלת דיווח על המרות
כדי להריץ דוח המרות, משתמשים ב-method runReport. בקשה נחשבת לדוח המרות אם היא שולחת שאילתה לגבי מדד המרות אחד או יותר (לדוגמה, allConversionsByInteractionDate), או אם השדה conversionSpec מאוכלס בגוף הבקשה.
האובייקט conversionSpec מכיל את השדות הבאים:
-
conversionActions: רשימה של שמות משאבים של פעולות המרה שצריך לכלול בדוח (למשל,["conversionActions/12345"]). אם הרשימה ריקה, כל ההמרות נכללות. אפשר לאחזר מזהי פעולה תקינים של המרות מהשדהconversion_actionברשימהconversionsבתגובה של השיטהGetMetadata. -
attributionModel: מודל השיוך שבו רוצים להשתמש. הערכים הנתמכים הםDATA_DRIVEN(ברירת מחדל) ו-LAST_CLICK.
יצירת דוח המרות
הנה דוגמה לבקשה שמשתמשת ב-method runReport כדי ליצור דוח דיווח על המרות שמציג המרות לפי שם הקמפיין באמצעות מודל שיוך מבוסס-נתונים.
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "campaignName" } ], "metrics": [ { "name": "allConversionsByConversionDate" } ], "conversionSpec": { "conversionActions": [], "attributionModel": "DATA_DRIVEN" } }
דוגמה: יצירה מחדש של דוח ביצועי המרות
בדוגמה הזו אפשר לראות איך קודם מאחזרים את פעולות ההמרה הזמינות לנכס, ואז משתמשים בהן כדי ליצור דוח שדומה לדוח "ביצועי המרות" שמוצג בממשק המשתמש של Google Analytics בקטע פרסום > המרות > ביצועי המרות.
שלב 1: אחזור של פעולות המרה
מפעילים את השיטה getMetadata כדי למצוא את מזהי הפעולות התקינים של ההמרה בנכס. כדי לראות את פעולות ההמרה שנוצרו לנכס, חשוב לציין את מזהה הנכס ב-GA (במקום להשתמש ב-0 כדי לקבל שדות שמשותפים לכל הנכסים).
התשובה מכילה רשימת conversions עם פעולות ההמרה הזמינות:
{
...
"conversions": [
{
"conversionAction": "conversionActions/12345",
"displayName": "purchase"
},
{
"conversionAction": "conversionActions/67890",
"displayName": "sign_up"
}
]
}
שלב 2: מריצים את הדוח
מפעילים את ה-method runReport.
כדי לסנן את הדוח, משתמשים במזהים של פעולות ההמרה שמצאתם בשלב 1. אם רוצים לדווח על כל ההמרות, משאירים את השדה conversionActions ריק. הבקשה הזו יוצרת מחדש דוח של ממשק המשתמש בנושא ביצועי המרות, על ידי הצגת קליקים על מודעות, עלות מודעה, עלות מודעה לקליק, עלות מודעה לכל ההמרות, חשיפות של מודעות, החזר על הוצאות פרסום, סה"כ הכנסות וכל ההמרות לפי קבוצת ערוצים שמוגדרת כברירת מחדל.
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "allConversionsByInteractionDate" }, { "name": "advertiserAdCost" }, { "name": "advertiserAdCostPerAllConversionsByInteractionDate" }, { "name": "advertiserAdImpressions" }, { "name": "advertiserAdClicks" }, { "name": "advertiserAdCostPerClick" }, { "name": "totalRevenueByInteractionDate" }, { "name": "returnOnAdSpendByInteractionDate" } ], "conversionSpec": { "conversionActions": [ "conversionActions/12345" ], "attributionModel": "DATA_DRIVEN" } }
זוהי דוגמה לתשובה לבקשה הזו:
{
"dimensionHeaders": [
{
"name": "defaultChannelGroup"
}
],
"metricHeaders": [
{
"name": "allConversionsByInteractionDate",
"type": "TYPE_FLOAT"
},
{
"name": "advertiserAdCost",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdCostPerAllConversionsByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdImpressions",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdClicks",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdCostPerClick",
"type": "TYPE_CURRENCY"
},
{
"name": "totalRevenueByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "returnOnAdSpendByInteractionDate",
"type": "TYPE_FLOAT"
}
],
"rows": [
{
"dimensionValues": [
{
"value": "Paid Search"
}
],
"metricValues": [
{
"value": "75.2"
},
{
"value": "500"
},
{
"value": "6.65"
},
{
"value": "10000"
},
{
"value": "500"
},
{
"value": "1"
},
{
"value": "1500"
},
{
"value": "3"
}
]
}
],
"rowCount": 1,
"metadata": {
"schemaRestrictionResponse": {},
"currencyCode": "USD",
"timeZone": "America/Los_Angeles",
"section": "SECTION_ADVERTISING"
},
"kind": "analyticsData#runReport"
}
כדי לוודא שהתגובה טופלה כדוח דיווח על המרות, בודקים שהשדה metadata.section בתגובה מוגדר כ-SECTION_ADVERTISING.
רשימה מלאה של המאפיינים והמדדים שזמינים בדוחות דיווח על המרות מופיעה במאמר סכימת דוחות ההמרות.