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

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

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

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

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

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

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

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

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

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

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

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

{
    "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 ריק כדי לדווח על כל ההמרות. הבקשה הזו יוצרת מחדש דוח של ממשק המשתמש 'ביצועי המרות' על ידי הצגת קליקים על מודעות, עלות פרסום, עלות פרסום לקליק, עלות פרסום לכל ההמרות, חשיפות של מודעות, החזר על הוצאות פרסום, הכנסה כוללת וכל ההמרות לפי קבוצת ערוצים שמוגדרת כברירת מחדל.

{
    "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.

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