ניהול מקורות של המרות

במאמר הזה מוסבר איך להשתמש ב-Merchant API כדי לנהל את מקורות ההמרות של חשבון המוכר.

מקורות ההמרות ב-Merchant Center מאפשרים להציג נתוני המרות מכרטיסי מוצר חינמיים ומהאתר שלכם בחשבון המוכר.

כדי לנהל מקורות של המרות באמצעות Merchant API, צריך להגדיר תיוג אוטומטי ולתבוע בעלות על אתר בחשבון המוכר שלכם. חשבון מוכר יכול לכלול עד 200 מקורות של המרות.

תוכלו להשתמש ב-Google Analytics כדי לעקוב אחר המרות בכרטיסי המוצר החינמיים ובאתר שלכם.

אם יש לכם הרשאת אדמין לנכס ב-Google Analytics, תוכלו לקשר את הנכס לחשבון המוכר על ידי יצירת מקור המרות ב-Google Analytics.

בקשת ה-API הבאה יוצרת אובייקט ConversionSource חדש עבור חשבון המוכר ב-Google Analytics:

POST  https://merchantapi.googleapis.com/conversions/v1beta/accounts/accountId/

{
 "googleAnalyticsLink": {
   "propertyId": propertyId
  }
}

התשובה לדוגמה הבאה מכילה אובייקט ConversionSource. במקורות ההמרות ב-Google Analytics מוגדר השדה googleAnalyticsLink, והשדה conversionSourceId מתחיל ב-galk:.

{
  "conversionSourceId": "galk:propertyId",
  "googleAnalyticsLink": {
    "propertyId": "propertyId",
    "attributionSettings": {
       "attributionLookbackWindowDays": 30,
       "atributionModel": "CROSS_CHANNEL_DATA_DRIVEN",
       "conversionType": [
        {
           "name": "purchase",
           "report": true
        }
       ]
   },
   "propertyName": "My Property Name"
  },
 "state": "ACTIVE",
 "controller": "MERCHANT"
}

שימוש ב-Google Tag

אם אין לכם נכס ב-Google Analytics, תוכלו לשלוח נתוני המרות ישירות לחשבון המוכר על ידי יצירת מקור המרות באתר באמצעות Google Tag. אפשר להשתמש ב-Google Tag Manager API כדי להגדיר Google Tag קיים, או להשתמש בתג החדש שנוצר באופן אוטומטי כשמוסיפים מקור המרות חדש באתר.

הנה דוגמה שיוצרת אובייקט ConversionSource חדש למעקב אחר אתרים בחשבון המוכר שלכם:

POST https://merchantapi.googleapis.com/conversions/v1beta/accounts/accountId/

{
  "merchantCenterDestination": {
    "displayName": "My tag destination",
    "attributionSettings": {
      "attributionLookbackWindowDays": 30,
      "attributionModel": "CROSS_CHANNEL_LAST_CLICK"
    },
    "currencyCode": "CHF"
  }
}

הנה תגובה לדוגמה שמכילה אובייקט ConversionSource. במקורות של המרות באתר, השדה merchantCenterDestination מוגדר והשדה conversionSourceId מתחיל ב-mcdn:.

{
  "name": "mcdn:12341241234",
  "merchantCenterDestination": {
    "destination": "MC-ABCD1234",
    "attributionSettings": {
      "attributionLookbackWindowDays": 30,
      "attributionModel": "CROSS_CHANNEL_LAST_CLICK"
    },
    "displayName": "My tag destination",
    "currencyCode": "CHF"
  },
  "state": "ACTIVE",
  "controller": "MERCHANT"
}

אחרי שיוצרים את ההמרה, אפשר להשתמש ב-destination של מקור ההמרות עם Google Tag כדי לקבל נתוני המרות ישירות מהאתר.