تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في ما يلي كيفية استخدام Merchant API لإدارة مصادر الإحالات الناجحة لحسابك على
Merchant Center.
تتيح لك مصادر الإحالات الناجحة في Merchant Center الاطّلاع على بيانات الإحالات الناجحة من
البيانات المجانية ومن موقعك الإلكتروني في
حسابك على Merchant Center.
قبل أن تتمكّن من إدارة مصادر الإحالات الناجحة باستخدام Merchant API، عليك
إعداد ميزة وضع العلامات التلقائي والمطالبة بموقع إلكتروني لحسابك على
Merchant Center. يمكن أن يتضمّن حساب Merchant Center ما يصل إلى 200
مصدر إحالة ناجحة.
ربط "إحصاءات Google"
يمكنك استخدام إحصاءات Google لتتبُّع الإحالات الناجحة في بياناتك المعروضة مجانًا
وموقعك الإلكتروني.
إذا كان لديك إذن وصول إداري إلى موقع على "إحصاءات Google"، يمكنك ربط
الموقع بحسابك على Merchant Center من خلال إنشاء مصدر إحالة ناجحة
في "إحصاءات Google".
ينشئ طلب البيانات من واجهة برمجة التطبيقات التالي عنصرًا جديدًا
ConversionSource ضمن حسابك على Merchant Center
لخدمة "إحصاءات Google":
POST https://merchantapi.googleapis.com/conversions/v1/accounts/ACCOUNT_ID/conversionSources{ "googleAnalyticsLink": { "propertyId": PROPERTY_ID }}
يحتوي نموذج الردّ التالي على عنصر ConversionSource. تم ضبط الحقل googleAnalyticsLink لمصادر الإحالات الناجحة في "إحصاءات Google"، ويأتي اسمها بعد accounts/{ACCOUNT}/conversionSources/galk:{PROPERTY_ID}.
إذا لم يكن لديك موقع على "إحصاءات Google"، يمكنك إرسال بيانات الإحالات الناجحة
مباشرةً إلى حسابك على Merchant Center من خلال
إنشاء مصدر إحالة ناجحة لموقع إلكتروني باستخدام علامة Google.
يمكنك استخدام Google Tag Manager API لإعداد علامة Google حالية، أو استخدام العلامة الجديدة التي يتم إنشاؤها تلقائيًا عند إضافة مصدر إحالة ناجحة جديد لصنّاع المحتوى على الويب.
في ما يلي نموذج لإنشاء عنصر
accounts.conversionSources
جديد لتتبُّع الموقع الإلكتروني ضمن حسابك على Merchant Center:
POST https://merchantapi.googleapis.com/conversions/v1/accounts/ACCOUNT_ID/conversionSources{ "merchantCenterDestination": { "attributionSettings": { "attributionLookbackWindowDays": 30, "attributionModel": "CROSS_CHANNEL_LAST_CLICK" }, "displayName": "My tag destination", "currencyCode": "CHF" }}
في ما يلي نموذج استجابة يحتوي على عنصر ConversionSource. يتم ضبط الحقل merchantCenterDestination لمصادر الإحالات الناجحة في الموقع الإلكتروني، ويتبع اسمهاaccounts/{ACCOUNT_ID}/conversionSources/mcdn:{PROPERTY_ID}.
تاريخ التعديل الأخير: 2025-08-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Merchant API allows you to manage conversion sources for your Merchant Center account, enabling you to view data from free listings and your website.\u003c/p\u003e\n"],["\u003cp\u003eBefore managing conversion sources, ensure auto-tagging is set up and a website is claimed for your Merchant Center account, with a limit of 200 conversion sources per account.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Analytics can be linked to track conversions by creating a Google Analytics conversion source if you have administrator access to a Google Analytics property.\u003c/p\u003e\n"],["\u003cp\u003eAlternatively, if you don't have a Google Analytics property, you can send conversion data directly to your Merchant Center account by creating a website conversion source with a Google tag.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating a conversion source, you can use its \u003ccode\u003edestination\u003c/code\u003e with a Google tag to receive conversion data directly from your website.\u003c/p\u003e\n"]]],["To manage conversion data for free listings and websites in a merchant account, use the Merchant API. First, set up autotagging and claim your website. You can link a Google Analytics property by creating a `ConversionSource` object using a POST request, specifying the property ID. Alternatively, for website tracking without Google Analytics, create a `ConversionSource` with a Google tag via another POST request. A merchant account can have up to 200 conversion sources. Once set, use the conversion source's `destination` with a Google Tag.\n"],null,["# Manage conversion sources\n\nHere's how to use the Merchant API to manage the conversion sources for your\nMerchant Center account.\n\nMerchant Center conversion sources let you view conversion data from\n[free listings](//support.google.com/merchants/answer/13889434), and from [your website](//support.google.com/merchants/answer/13071753), in your\nMerchant Center account.\n\nBefore you can manage conversion sources with the Merchant API, you need to\n[set up autotagging](//support.google.com/merchants/answer/11127659) and [claim a website](//support.google.com/merchants/answer/176793) for your\nmerchant center center account. A Merchant Center account can have up to 200\nconversion sources.\n\nLink Google Analytics\n---------------------\n\nYou can use [Google Analytics](//support.google.com/merchants/answer/12046446) to track conversions on your free\nlistings and your website.\n\nIf you have administrator access to a Google Analytics property, you can link\nthe property to your Merchant Center account by creating a Google Analytics\nconversion source.\n\nThe following API request creates a new\n[`ConversionSource`](/merchant/api/reference/rest/conversions_v1/accounts.conversionSources#resource:-conversionsource) object under your Merchant Center\naccount for Google Analytics: \n\n POST https://merchantapi.googleapis.com/conversions/v1/accounts/\u003cvar translate=\"no\"\u003eACCOUNT_ID\u003c/var\u003e/conversionSources\n\n {\n \"googleAnalyticsLink\": {\n \"propertyId\": \u003cvar translate=\"no\"\u003ePROPERTY_ID\u003c/var\u003e\n }\n }\n\nThe following sample response contains a `ConversionSource` object. Google\nAnalytics conversion sources have the field `googleAnalyticsLink` set and their\nname follows the `accounts/`\u003cvar translate=\"no\"\u003e{ACCOUNT}\u003c/var\u003e`/conversionSources/galk:`\u003cvar translate=\"no\"\u003e{PROPERTY_ID}\u003c/var\u003e. \n\n {\n \"name\": \"accounts/\u003cvar translate=\"no\"\u003e{ACCOUNT_ID}\u003c/var\u003e/conversionSources/galk:\u003cvar translate=\"no\"\u003ePROPERTY_ID\u003c/var\u003e\"\n \"googleAnalyticsLink\": {\n \"propertyId\": \"\u003cvar translate=\"no\"\u003ePROPERTY_ID\u003c/var\u003e\",\n \"attributionSettings\": {\n \"attributionLookbackWindowDays\": 30,\n \"atributionModel\": \"CROSS_CHANNEL_DATA_DRIVEN\",\n \"conversionType\": [\n {\n \"name\": \"purchase\",\n \"report\": true\n }\n ]\n },\n \"propertyName\": \"My Property Name\"\n },\n \"state\": \"ACTIVE\",\n \"controller\": \"MERCHANT\"\n }\n\nUse a Google tag\n----------------\n\nIf you don't have a Google Analytics property, you can send conversion data\ndirectly to your Merchant Center account by\n[creating a website conversion source with a Google tag](//support.google.com/merchants/answer/13071753).\nYou can use the [Google Tag Manager API](/tag-platform/tag-manager/api/v2) to set up an existing\nGoogle tag, or use the new tag that is automatically created when you add a new\nwebsite conversion source.\n\nHere's a sample that creates a new\n[`accounts.conversionSources`](/merchant/api/reference/rest/conversions_v1/accounts.conversionSources)\nobject for website tracking under your Merchant Center account: \n\n POST https://merchantapi.googleapis.com/conversions/v1/accounts/\u003cvar translate=\"no\"\u003eACCOUNT_ID\u003c/var\u003e/conversionSources\n\n {\n \"merchantCenterDestination\": {\n \"attributionSettings\": {\n \"attributionLookbackWindowDays\": 30,\n \"attributionModel\": \"CROSS_CHANNEL_LAST_CLICK\"\n },\n \"displayName\": \"My tag destination\",\n \"currencyCode\": \"CHF\"\n }\n }\n\nHere's a sample response that contains a `ConversionSource` object. Website\nconversion sources have the field `merchantCenterDestination` set and their name\nfollows the `accounts/`\u003cvar translate=\"no\"\u003e{ACCOUNT_ID}\u003c/var\u003e`/conversionSources/mcdn:`\u003cvar translate=\"no\"\u003e{PROPERTY_ID}\u003c/var\u003e. \n\n {\n \"name\": \"accounts/\u003cvar translate=\"no\"\u003e{ACCOUNT_ID}\u003c/var\u003e/conversionSources/mcdn:\u003cvar translate=\"no\"\u003e{PROPERTY_ID}\u003c/var\u003e\",\n \"merchantCenterDestination\": {\n \"destination\": \"MC-ABCD1234\",\n \"attributionSettings\": {\n \"attributionLookbackWindowDays\": 30,\n \"attributionModel\": \"CROSS_CHANNEL_LAST_CLICK\"\n },\n \"displayName\": \"My tag destination\",\n \"currencyCode\": \"CHF\"\n },\n \"state\": \"ACTIVE\",\n \"controller\": \"MERCHANT\"\n }\n\nOnce created, you can use the conversion source's `destination` with a\n[Google tag](/tag-platform/tag-manager) to get conversion data directly from your website.\n\nLearn more\n----------\n\nTo learn about migrating from Content API for Shopping, see\n[Migrate conversion sources management](/merchant/api/guides/compatibility/conversion-sources)."]]
