במאמר הזה מוסבר איך להשתמש ב-Merchant API כדי לנהל את מקורות ההמרות של חשבון המוכר.
מקורות ההמרות ב-Merchant Center מאפשרים להציג נתוני המרות מכרטיסי מוצר חינמיים ומהאתר שלכם בחשבון המוכר.
כדי לנהל מקורות של המרות באמצעות Merchant API, צריך להגדיר תיוג אוטומטי ולתבוע בעלות על אתר בחשבון המוכר שלכם. חשבון מוכר יכול לכלול עד 200 מקורות של המרות.
קישור Google Analytics
תוכלו להשתמש ב-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 כדי לקבל נתוני המרות ישירות מהאתר.