يُرجى العلم أنّنا سنوقف نهائيًا الطريقتَين get وgetByCustomerId في Search Ads 360 Conversion API في الربع الثالث من عام 2025. لمواصلة الوصول إلى بيانات الإحالات الناجحة، عليك إنشاء تقرير باستخدام مصدر الإحالة الناجحة باستخدام Search Ads 360 Reporting API الجديدة. يمكنك الاطّلاع على مزيد من التفاصيل هنا.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عندما يكمل أحد العملاء إجراءً محدّدًا مسبقًا على الموقع الإلكتروني لأحد المعلِنين، مثل شراء سلعة أو طلب المزيد من المعلومات، تسجّل "إعلانات شبكة البحث 360" إحالة ناجحة.
تبدأ الإحالات الناجحة لبعض المعلِنين على الإنترنت وتنتهي بلا اتّصال بالإنترنت. على سبيل المثال، يبدأ المستهلك عملية البحث على الإنترنت عن سلعة لشرائها، وينقر على إعلان، ثمّ يتّصل هاتفيًا بمركز اتّصال لإكمال عملية الشراء. ويمكن أن ينقر أحد المستهلكين من هاتف ذكي على زرّ "الاتصال الآن" في أحد الإعلانات ويشتري سلعة من خلال الهاتف. بالنسبة إلى هذه الإحالات الناجحة، ستتوفّر تلقائيًا لدى "إعلانات شبكة البحث 360" بيانات عن الجزء الذي تمّ على الإنترنت. إذا كنت تريد تقديم بيانات عن الجزء الذي تمّ بلا اتّصال بالإنترنت لتحسين التقارير، لاستخدامها في القواعد المبرمَجة، أو للتحسين في استراتيجية عروض أسعار، يمكنك تحميلها إلى "إعلانات شبكة البحث 360".
في بعض الحالات، قد تحتاج إلى تعديل قيمة إحالة ناجحة حالية. على سبيل المثال، يمكنك تعديل قيمة إحالة ناجحة لاحتساب الخصومات التي تم تطبيقها بعد إجراء عملية شراء على الإنترنت (مثل الخصم الذي يتم استرداده عبر البريد) أو المرتجعات التي تمّت مع دفع رسوم إعادة التخزين أو الأرصدة التي تم تطبيقها بعد عملية الشراء.
بعد إعداد تطبيق العميل كما هو موضّح في تطبيقي الأول (بما في ذلك تفعيل خدمة الإحالات الناجحة)، يمكنك إرسال الطلبات التالية ذات الصلة بالإحالات الناجحة إلى واجهة برمجة التطبيقات Search Ads 360 API:
جميع طلبات الإحالة الناجحة متزامنة. يمكنك تقديم طلبات متزامنة متوازية (حتى الحدّ الأقصى لمشروعك) في عميل واحد.
أرقام التعريف والإحالات الناجحة في "إعلانات شبكة البحث 360"
بما أنّه يجب تحديد مصدر الإحالات الناجحة على مستوى حملة وإعلان وكلمة رئيسية معيّنة، ويمكن أيضًا تحديد مصدرها على مستوى زيارة، تحدّد كل إحالة ناجحة رقم تعريف الإعلان والكلمة الرئيسية والحملة في "إعلانات شبكة البحث 360"، بالإضافة إلى أرقام تعريف العناصر الرئيسية في التسلسل الهرمي لـ "إعلانات شبكة البحث 360".
عند تلقّي إحالة ناجحة أو إضافتها أو تعديلها، عليك تحديد معظم أرقام التعريف هذه في الطلب.
الحصول على أرقام تعريف "إعلانات شبكة البحث 360"
للعثور على هذه المعرّفات، اتّبِع أيًّا من الخطوات التالية:
استخدِم واجهة مستخدم "إعلانات شبكة البحث 360" لتنزيل تقرير يتضمّن معرّفات المعلِن وحسابات محرّك البحث والحملات والمجموعات الإعلانية والكلمات الرئيسية والإعلانات.
أضِف وحدات ماكرو من "إعلانات شبكة البحث 360"، مثل CampaignID وTrackerID،
إلى عناوين URL لصفحاتك المقصودة. عندما ينقر أحد العملاء على إعلان، ستوجّه كل وحدة ماكرو
"إعلانات شبكة البحث 360" إلى تمرير رقم تعريفها إلى الصفحة المقصودة للمعلِن كمَعلمة عنوان URL.
يمكنك استرداد هذه المعرّفات من سجلات الويب الخاصة بالمعلِن واستخدامها في طلبات Conversion.
توفّر "إعلانات شبكة البحث 360" بضع وحدات ماكرو مختلفة لإرسال أرقام تعريف الكلمات الرئيسية إلى صفحة مقصودة. لتحديد مصدر الإحالات الناجحة على مستوى كلمة رئيسية، عليك إضافة وحدة الماكرو TrackerID إلى عناوين URL الخاصة بالصفحات المقصودة.
معرّفات النقرات
يتتبّع معرّف النقرة النقرة على إعلان، ويمكنك استخدامه لتحديد مصدر إحالة ناجحة على أنّها زيارة محدّدة بدلاً من تقديم التسلسل الهرمي الكامل لأرقام التعريف الخاصة بعناصر "إعلانات شبكة البحث 360". ستستخدِم "إعلانات شبكة البحث 360" معرّف النقرة للعثور على الكلمة الرئيسية والإعلان المناسبَين وتحديد مصدرهما.
معرّفات النقرات حسّاسة لحالة الأحرف، لذا تأكَّد من أنّ سجلات الويب وبرامج التتبُّع لا تغيّر حالة معرّف النقرة.
إنشاء معرّف نقرة
تُنشئ "إعلانات شبكة البحث 360" أو "إعلانات Google" معرّف النقرة.
في حال تفعيل وضع العلامات التلقائي في حساب على "إعلانات Google"، تنشئ "إعلانات Google" معرّف نقرة عند عرض إعلان. نتيجةً لذلك، إذا نقر أحد المستخدِمين على مرّة ظهور معيّنة للإعلان عدّة مرّات، سيتمّ ربط هذه النقرات بمعرّف نقرة واحد فقط. ستتشارك زيارات الصفحة المقصودة معرّف النقرة نفسه إذا كانت تلك الزيارات ناتجة عن مرّة الظهور نفسها.
يمكن أن تنشئ "إعلانات شبكة البحث 360" معرّف نقرة إذا
فعّلت خدمة واجهة برمجة التطبيقات الخاصة بالإحالات الناجحة. إذا تمت إعادة توجيه نقرة من "إعلانات Google" وكانت "إعلانات Google" قد أنشأت معرّف نقرة من قبل، تستخدِم "إعلانات شبكة البحث 360" معرّف "إعلانات Google" بدلاً من إنشاء معرّف جديد. إذا تمت إعادة توجيه نقرة من نوع آخر من محرّكات البحث المتوافقة، ستنشئ "إعلانات شبكة البحث 360" المعرّف.
مَعلمات معرّف النقرة
يتألف كل معرّف نقرة من مَعلمتَين. على سبيل المثال:
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
تحتوي المَعلمة gclid على معرّف حسّاس لحالة الأحرف للنقرة. تحتفظ "إعلانات شبكة البحث 360" بمعلومات تحديد المصدر (مثل الكلمة الرئيسية والإعلان والحملة والمجموعة الإعلانية) لكل معرّف نقرة تم إنشاؤه.
تشير المَعلمة gclsrc إلى مصدر معرّف النقرة. يمكن أن تكون القيمة إحدى القيم التالية:
gclsrc=ds: تم إنشاء معرّف النقرة من خلال "إعلانات شبكة البحث 360". بالإضافة إلى ذلك، تمّت النقرة إمّا على محرّك بحث آخر غير Google، أو تمّت النقرة على Google ولكنّ حساب "إعلانات Google" لا يستخدم ميزة "وضع العلامات التلقائي".
gclsrc=aw.ds: أنشأت "إعلانات Google" معرّف النقرة باستخدام ميزة وضع العلامات التلقائي، وتمت النقرة من خلال خادم النقرات في "إعلانات شبكة البحث 360".
gclsrc=: تكون المَعلمة فارغة في حال إنشاء معرّف النقرة بواسطة "إعلانات Google"، ولكن لم يتم تفعيل خدمة واجهة برمجة تطبيقات الإحالات الناجحة في "إعلانات شبكة البحث 360" عند حدوث النقرة.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eSearch Ads 360 reports a conversion when a customer completes a pre-defined action on an advertiser's website, such as purchasing an item or requesting information.\u003c/p\u003e\n"],["\u003cp\u003eYou can upload offline conversion data to Search Ads 360 to enhance reports, use in automated rules, or for bid strategy optimization.\u003c/p\u003e\n"],["\u003cp\u003eConversion values can be modified to account for factors like discounts, returns, or credits applied after a purchase.\u003c/p\u003e\n"],["\u003cp\u003eThe Search Ads 360 API allows you to get, insert, and update conversions, but it cannot be used to send personally identifiable information or for advertising targeting.\u003c/p\u003e\n"],["\u003cp\u003eTo attribute conversions, each conversion needs to specify the Search Ads 360 ID of an ad, keyword, and campaign, or utilize a click ID to track the click and attribute accordingly.\u003c/p\u003e\n"]]],["Search Ads 360 reports a conversion when a customer completes a specified action. Advertisers can upload offline conversion data to enhance reports and optimize bid strategies. The Search Ads 360 API allows getting, adding, and updating conversions. Conversions require Search Ads 360 IDs of relevant entities or a click ID to attribute to specific ads. Click IDs, generated by either Search Ads 360 or Google Ads, track ad clicks. Advertisers should maintain the click ID case from the landing page.\n"],null,["# Upload Data About Conversions\n\nWhen a customer completes a pre-defined action on an advertiser's website, such as\npurchasing an item or requesting more information, Search Ads 360 reports a **conversion**.\n\nConversions for some advertisers start online and finish offline. For example, a\nconsumer initiates research online for a purchase, clicks on an ad, and then telephones a\ncall center to complete the purchase. Or a consumer with a smartphone taps a \"call now\"\nbutton in an ad and purchases an item over the telephone. For these conversions,\nSearch Ads 360 will automatically have data about the online portion. If you want to\nprovide data about the offline portion---to enhance reports, for use in automated\nrules, or for optimization in a bid strategy---you can upload it to Search Ads 360.\n\nIn some cases, you might need to modify the value of an existing conversion. For\nexample, you might edit a conversion value to account for discounts that were applied\nafter an online purchase was made (such as a mail-in-rebate), returns that occurred with\na restocking fee, or credits that were applied after the purchase.\n\n\nAfter you've set up your client app as described in [My First App](/search-ads/v2/first-app) (including [activating the\nconversion service](/search-ads/v2/prereqs#activate-conversion-service)), you can send the following conversion-related requests to the\nSearch Ads 360 API:\n\n\n[Insert](/search-ads/v2/how-tos/conversions/insert)\n\n:\n Adds new conversions.\n\n\n[Update](/search-ads/v2/how-tos/conversions/update)\n\n: Modifies existing conversions.\n\n| **Advertisers are prohibited** from using the Search Ads 360 API to send personally identifiable information, as outlined by the [Terms of Service](/search-ads/terms) for the API. Further, this API provides no ability to target advertising. The conversion data is used by advertisers to better manage and report on the amount they pay for advertising and the ROI they get from it.\n\n### Synchronous Requests\n\nAll conversion requests are synchronous. You can make parallel synchronous requests (up to your project's limit) in a single client.\n\nSearch Ads 360 IDs and Conversions\n----------------------------------\n\n\nBecause conversions need to be attributed to a specific campaign, ad, keyword, and\noptionally to a visit, each conversion specifies the Search Ads 360 ID of an ad,\nkeyword, and campaign, along with the IDs of the parent objects in the [Search Ads 360 hierarchy](https://support.google.com/searchads/answer/2491240).\nWhen you get, add, or update a conversion, you'll need to specify most of these IDs in\nthe request.\n\n### Obtaining Search Ads 360 IDs\n\nTo find these IDs, do any of the following:\n\n-\n Use the Search Ads 360 UI to [download\n a report](https://support.google.com/searchads/answer/1184146) that contains IDs for the advertiser, engine accounts, campaigns, ad\n groups, keywords, and ads.\n\n-\n [Add\n Search Ads 360 macros](https://support.google.com/searchads/answer/1649566#macros) such as `CampaignID` and `TrackerID`\n to your landing page URLs. When a customer clicks an ad, each macro will instruct\n Search Ads 360 to pass its ID to the advertiser's landing page as URL parameter.\n You can retrieve these IDs from the advertiser's web logs and use them in your `Conversion`\n requests.\n\n\n Search Ads 360 provides a few different macros for sending keyword IDs to a landing\n page. To attribute conversions to a keyword, you'll need to add the **TrackerID**\n macro to the landing page URLs.\n\n### Click IDs\n\nA **click ID** tracks a click on an ad, and you can use it to attribute a\nconversion to a specific visit instead of providing the entire hierarchy of IDs for\nSearch Ads 360 objects. Search Ads 360 will use the click ID to find and attribute the\nappropriate keyword and ad.\n\nClick IDs are case-sensitive, so **make sure your web logs and tracking software\ndo not change the case of the click ID**.\n\n#### Generating a Click ID\n\nEither Search Ads 360 or Google Ads generates the click ID.\n\nIf [auto-tagging](https://support.google.com/google-ads/answer/3095550) is enabled\nin an Google Ads account, Google Ads generates a click ID when an ad is shown. As a result, if a\nuser clicks on a particular ad impression multiple times, those clicks will be associated\nwith only one click ID. Landing page visits for the exact same impression will share the\nsame click ID.\n\nSearch Ads 360 can generate a click ID if you [activate the conversion API service](https://support.google.com/searchads/answer/2604604#activate). If a click is redirected from Google Ads and Google Ads has\nalready generated a click ID, Search Ads 360 uses the Google Ads ID instead of generating a new one. If a\nclick is redirected from another type of supported engine, Search Ads 360 generates the ID.\n\n#### Click ID Parameters\n\nEach click ID consists of two parameters. For example: \n\n```\ngclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds\n```\n\n\nThe `gclid` parameter contains a case-sensitive ID for the click. Search Ads 360\nmaintains the attribution information (such as keyword, ad, campaign, ad group) for\neach click ID generated.\n\n\nThe `gclsrc` parameter indicates the source of the click ID. Currently, it\ncan have one of the following values:\n\n-\n `gclsrc=ds`: the click ID was generated by Search Ads 360. In addition, the\n click was either on an engine other than Google, or the click was on Google but the\n Google Ads account is not using auto-tagging.\n\n-\n `gclsrc=aw.ds`: the click ID was generated by Google Ads that is using\n auto-tagging, and the click went through the Search Ads 360 clickserver.\n\n-\n `gclsrc=`: the parameter is empty if the click ID was generated by Google Ads,\n but the conversion API service was not enabled in Search Ads 360 when the click occurred.\n\n| **Tip**: We recommend you use the landing page of the website to keep track of the customer's offline contact information (such as phone number called) together with the click ID. When an offline conversion happens, the click ID can then be used to report the conversion back to Search Ads 360."]]
