מידע בסיסי בנושא דיווח על המרות

במדריך הזה מוסבר איך להשתמש בפונקציונליות של דיווח על המרות ב-Google Analytics Data API v1. התכונה הזו מאפשרת ליצור דוחות שמתמקדים באירועי המרה, עם תמיכה במודלים שונים של שיוך (Attribution). דוחות ההמרות שנוצרים באמצעות Data API דומים לדוחות השיוך שאפשר למצוא בקטע פרסום > המרות בממשק המשתמש של Google Analytics. מידע נוסף זמין במאמר במרכז העזרה בנושא הדוח 'ביצועי המרות'.

מטרת הדיווח על המרות

דיווח על המרות מאפשר לנתח את היעילות של פעולות השיווק על ידי שיוך המרות לקמפיינים, למקורות ולסוגי מדיה ספציפיים. בניגוד לדוחות רגילים שמבוססים על אירועים וסופרים רק את האירועים, בדוחות על המרות מוחל מודל שיוך (Attribution) כדי לחלק את הקרדיט בין נקודות המגע עם הלקוח שהובילו להמרה.

השוואה בין דוחות המרות לבין דוחות מבוססי-אירועים

  • דוחות מבוססי-אירועים: הדוחות האלה מספקים ספירות גולמיות של אירועים (למשל, eventCount) ועוזרים להבין את הפעילות הכללית בנכס.
  • דוחות המרות: מתמקדים באירועים שסומנו כהמרות. הם מתבססים על מאפיינים ומדדים ספציפיים (אפשר לעיין בסכימת דוחות ההמרות) ומאפשרים לכם לראות נתונים משויכים על סמך מודלים כמו מודל מבוסס-נתונים או מודל קליק אחרון.

הפעלת דוחות המרות

כדי להריץ דוח המרות, משתמשים בשיטה runReport. בקשה נחשבת לדוח המרות אם היא שולחת שאילתה לגבי מדד המרה אחד או יותר (לדוגמה, allConversionsByInteractionDate) או אם השדה conversionSpec מאוכלס בגוף הבקשה.

אובייקט conversionSpec מכיל את השדות הבאים:

  • ‫conversionActions: רשימה של שמות משאבים של פעולות המרה שצריך לכלול בדוח (לדוגמה, ["conversionActions/12345"]). אם הרשימה ריקה, כל ההמרות נכללות. אפשר לאחזר מזהים תקינים של פעולות המרה מהשדה conversion_action ברשימה conversions בתשובה של השיטה GetMetadata.
  • ‫attributionModel: מודל השיוך שבו רוצים להשתמש. הערכים שנתמכים הם DATA_DRIVEN (ברירת מחדל) ו-LAST_CLICK.

יצירת דוח המרות

הנה בקשה לדוגמה באמצעות השיטה runReport ליצירת דוח המרות שמציג המרות לפי שם הקמפיין באמצעות מודל השיוך מבוסס-הנתונים.

HTTP

פתיחה ב-API Explorer 
{
    "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

פתיחה ב-API Explorer 
{
    "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.

רשימה מלאה של המאפיינים והמדדים שזמינים בדוחות ההמרות מופיעה בסכימה של דוחות ההמרות.