API قبلی Search Ads 360 Reporting از کار افتاده است. اکنون می توانید گزارش های خود را با استفاده از Search Ads 360 Reporting API جدید ایجاد کنید.
توجه داشته باشید که روش‌های get و getByCustomerId در Search Ads 360 Conversion API در Q3 2025 منسوخ شده‌اند. برای ادامه دسترسی به داده‌های تبدیل، باید با استفاده از منبع تبدیل با استفاده از Search Ads 360 Reporting API جدید گزارشی ایجاد کنید. جزئیات بیشتر را اینجا ببینید.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
وقتی مشتری یک اقدام از پیش تعریف شده را در وب سایت تبلیغ کننده انجام می دهد، مانند خرید یک مورد یا درخواست اطلاعات بیشتر، Search Ads 360 یک تبدیل را گزارش می کند.
تبدیل برای برخی از تبلیغ‌کنندگان به صورت آنلاین شروع می‌شود و به‌صورت آفلاین به پایان می‌رسد. به عنوان مثال، یک مصرف کننده تحقیقات آنلاین را برای خرید آغاز می کند، روی یک تبلیغ کلیک می کند و سپس برای تکمیل خرید با یک مرکز تماس تماس می گیرد. یا مصرف‌کننده‌ای با گوشی هوشمند روی دکمه «اکنون تماس بگیرید» در آگهی ضربه می‌زند و کالایی را از طریق تلفن خریداری می‌کند. برای این تبدیل‌ها، Search Ads 360 به‌طور خودکار اطلاعات مربوط به بخش آنلاین را خواهد داشت. اگر می‌خواهید داده‌هایی درباره بخش آفلاین ارائه کنید - برای بهبود گزارش‌ها، برای استفاده در قوانین خودکار یا برای بهینه‌سازی در یک استراتژی پیشنهادی - می‌توانید آن را در Search Ads 360 آپلود کنید.
در برخی موارد، ممکن است لازم باشد مقدار یک تبدیل موجود را تغییر دهید. برای مثال، ممکن است یک مقدار تبدیل را ویرایش کنید تا تخفیف‌هایی را که پس از خرید آنلاین اعمال شده‌اند (مانند تخفیف پستی)، بازپرداخت‌هایی که با کارمزد ذخیره‌سازی مجدد انجام شده است، یا اعتباراتی که پس از خرید اعمال شده‌اند، ویرایش کنید.
پس از اینکه برنامه مشتری خود را همانطور که در اولین برنامه من توضیح داده شده است راه اندازی کردید (از جمله فعال کردن سرویس تبدیل )، می توانید درخواست های مرتبط با تبدیل زیر را به Search Ads 360 API ارسال کنید:
همه درخواست های تبدیل همزمان هستند. می‌توانید درخواست‌های همزمان موازی (تا سقف پروژه خود) را در یک کلاینت انجام دهید.
جستجوی تبلیغات 360 شناسه و تبدیل
از آنجایی که تبدیل ها باید به یک کمپین، آگهی، کلمه کلیدی خاص و به صورت اختیاری به یک بازدید نسبت داده شوند، هر تبدیل شناسه Search Ads 360 یک تبلیغ، کلمه کلیدی و کمپین را به همراه شناسه اشیاء اصلی در سلسله مراتب Search Ads 360 مشخص می کند . وقتی تبدیلی را دریافت، اضافه یا به‌روزرسانی می‌کنید، باید بیشتر این شناسه‌ها را در درخواست مشخص کنید.
دریافت شناسه های جستجوی تبلیغات 360
برای یافتن این شناسه ها یکی از موارد زیر را انجام دهید:
از رابط کاربری Search Ads 360 برای بارگیری گزارشی استفاده کنید که حاوی شناسه‌های تبلیغ‌کننده، حساب‌های موتور، کمپین‌ها، گروه‌های تبلیغاتی، کلمات کلیدی و تبلیغات است.
ماکروهای Search Ads 360 مانند CampaignID و TrackerID را به URL های صفحه فرود خود اضافه کنید. وقتی مشتری روی تبلیغ کلیک می‌کند، هر ماکرو به Search Ads 360 دستور می‌دهد تا شناسه خود را به عنوان پارامتر URL به صفحه فرود تبلیغ‌کننده ارسال کند. می‌توانید این شناسه‌ها را از گزارش‌های وب تبلیغ‌کننده بازیابی کنید و از آنها در درخواست‌های Conversion خود استفاده کنید.
Search Ads 360 چند ماکرو مختلف برای ارسال شناسه کلمات کلیدی به صفحه فرود ارائه می دهد. برای نسبت دادن تبدیل به یک کلمه کلیدی، باید ماکرو TrackerID را به URL های صفحه فرود اضافه کنید.
روی شناسه ها کلیک کنید
شناسه کلیک، کلیک روی یک تبلیغ را ردیابی می‌کند، و می‌توانید به جای ارائه کل سلسله مراتب شناسه‌ها برای اشیاء Search Ads 360، از آن برای نسبت دادن یک تبدیل به یک بازدید خاص استفاده کنید. Search Ads 360 از شناسه کلیک برای یافتن و نسبت دادن کلمه کلیدی و تبلیغ مناسب استفاده می کند.
شناسه‌های کلیک به حروف کوچک و بزرگ حساس هستند، بنابراین مطمئن شوید که گزارش‌های وب و نرم‌افزار ردیابی شما حروف شناسه کلیک را تغییر نمی‌دهد .
ایجاد شناسه کلیک
یا Search Ads 360 یا Google Ads شناسه کلیک را تولید می کند.
اگر برچسب‌گذاری خودکار در حساب Google Ads فعال باشد، Google Ads با نمایش یک تبلیغ، شناسه کلیک ایجاد می‌کند. در نتیجه، اگر کاربر چندین بار روی یک نمایش تبلیغاتی خاص کلیک کند، آن کلیک‌ها تنها با یک شناسه کلیک مرتبط می‌شوند. بازدیدکنندگان از صفحه فرود برای برداشت دقیقاً مشابه، شناسه کلیک یکسانی را به اشتراک خواهند گذاشت.
اگر سرویس API تبدیل را فعال کنید، Search Ads 360 می‌تواند یک شناسه کلیک ایجاد کند. اگر یک کلیک از Google Ads هدایت شود و Google Ads قبلاً یک شناسه کلیک ایجاد کرده باشد، Search Ads 360 به جای ایجاد شناسه جدید از Google Ads ID استفاده می کند. اگر کلیکی از نوع دیگری از موتورهای پشتیبانی شده هدایت شود، Search Ads 360 شناسه را ایجاد می کند.
روی ID Parameters کلیک کنید
هر شناسه کلیک شامل دو پارامتر است. به عنوان مثال:
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
پارامتر gclid حاوی یک شناسه حساس به حروف کوچک برای کلیک است. Search Ads 360 اطلاعات انتساب (مانند کلمه کلیدی، تبلیغ، کمپین، گروه تبلیغات) را برای هر شناسه کلیک ایجاد شده حفظ می کند.
پارامتر gclsrc منبع شناسه کلیک را نشان می دهد. در حال حاضر، می تواند یکی از مقادیر زیر را داشته باشد:
gclsrc=ds : شناسه کلیک توسط Search Ads 360 ایجاد شده است. علاوه بر این، کلیک یا روی موتوری غیر از Google بوده است یا کلیک روی Google بوده است اما حساب Google Ads از برچسب گذاری خودکار استفاده نمی کند.
gclsrc=aw.ds : شناسه کلیک توسط Google Ads ایجاد شده است که از برچسب گذاری خودکار استفاده می کند و کلیک از طریق سرور کلیک Search Ads 360 انجام می شود.
gclsrc= : اگر شناسه کلیک توسط Google Ads ایجاد شده باشد، پارامتر خالی است، اما در زمان کلیک، سرویس API تبدیل در Search Ads 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."]]
