API قبلی Search Ads 360 Reporting از کار افتاده است. اکنون می توانید گزارش های خود را با استفاده از Search Ads 360 Reporting API جدید ایجاد کنید.
توجه داشته باشید که روش‌های get و getByCustomerId در Search Ads 360 Conversion API در Q3 2025 منسوخ شده‌اند. برای ادامه دسترسی به داده‌های تبدیل، باید با استفاده از منبع تبدیل با استفاده از Search Ads 360 Reporting API جدید گزارشی ایجاد کنید. جزئیات بیشتر را اینجا ببینید.
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
به‌طور پیش‌فرض، یک تبدیل حاوی مقدار محدودی از داده‌های توصیفی است، مانند زمان انجام تبدیل، منبع تبدیل، و در صورت تمایل یک مقدار پولی. اگر داده‌های اضافی درباره تبدیل‌های خود جمع‌آوری می‌کنید، مانند کشوری که کالای خریداری‌شده به آن ارسال می‌شود، شناسه‌های محصول یا حتی مدت زمان تماس تلفنی، می‌توانید از متغیرهای Floodlight سفارشی برای ردیابی داده‌ها و آپلود آن در Search Ads 360 استفاده کنید. .
پس از آپلود داده ها، می توانید:
برای نمایش داده ها یا استفاده از آن برای فیلتر کردن ستون Floodlight، در Search Ads 360 ستون های گزارش ایجاد کنید.
از داده ها در ستون های فرمول استفاده کنید.
از داده ها برای بخش بندی و گروه بندی گزارش ها استفاده کنید.
به هر متغیر یک نام دوستانه اختصاص داده می شود که برای یک تبلیغ کننده خاص و یکی از انواع داده های زیر منحصر به فرد است:
متریک : داده های عددی که Search Ads 360 در گزارش های تبدیل جمع می کند. به عنوان مثال، از متغیرهای متریک می توان برای پیگیری هزینه های حمل و نقل کلی یا برای نگه داشتن تعداد اقلام خریداری شده استفاده کرد.
بعد : داده های عددی یا متنی که می توانند برای فیلتر کردن داده ها در گزارش استفاده شوند. به عنوان مثال، متغیرهای ابعاد می توانند نام فروشگاه یا شناسه عددی محصول را ردیابی کنند و سپس در ستون گزارش Floodlight که فقط حاوی داده های یک فروشگاه خاص یا برای یک محصول خاص است، استفاده شوند.
برای مثال، یک تبلیغ‌کننده متغیرهای Floodlight سفارشی زیر را برای Search Ads 360 پیکربندی کرده است:
فروش (متریک)
حمل و نقل (متریک)
محصول_نوع (بعد)
شناسه محصول (بعد)
اگر مشتری یک خرید را از طریق تلفن انجام دهد، می‌توانید درخواست Conversion.insert() زیر را برای آپلود تبدیل و شامل داده‌های معیارهای سفارشی ارسال کنید:
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
'kind': 'doubleclicksearch#conversionList',
'conversion' : [{
'agencyId': '12300000000000456', // Replace with your ID
'advertiserId': '78900000000000123', // Replace with your ID
'engineAccountId': '101100000000000123', // Replace with your ID
'campaignId': '13400000003156701', // Replace with your ID
'adGroupId': '58700000128508001', // Replace with your ID
'criterionId': '43700001095692142', // Replace with your ID
'adId': '0',
'conversionId': 'test_20140121_01',
'state': 'ACTIVE',
'type': 'TRANSACTION',
'revenueMicros': 10000000, // To report $10 of revenue, specify 10 million revenueMicros
'currencyCode': 'USD',
'segmentationType': 'FLOODLIGHT',
'segmentationId': '25700000001472562', // Replace with your ID
'conversionTimestamp': '1390073000011',
'floodlightOrderId': 'test',
'customMetric': [
{
'name': 'sales',
'value': 2.0
},
{
'name': 'shipping',
'value': 3.0
}
],
'customDimension': [
{
'name': 'product_type',
'value': 'shoes'
},
{
'name': 'product_id',
'value': 'shoe 2'
}
]
}]
}
پاسخ‌های Search Ads 360 را مدیریت کنید
مانند سایر درخواست‌های Conversion.insert() یا Conversion.update() ، در صورت موفقیت‌آمیز بودن درخواست، پاسخ شامل نمایش داخلی Search Ads 360 برای هر تبدیل آپلود شده است.
اگر درخواست تأیید یا بارگذاری نشد، پاسخ شامل پیام‌های شکست می‌شود. برای اطلاعات بیشتر درباره این پیام‌های خرابی، به پاسخ‌های Search Ads 360 برای درج درخواست‌ها مراجعه کنید.
تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eCustom Floodlight variables allow you to upload additional data about your conversions, such as product details or shipping information, to Search Ads 360.\u003c/p\u003e\n"],["\u003cp\u003eThis uploaded data can be used to create reporting columns, filter reports, build formula columns, segment data, and download reports via the API.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables are configured initially in Campaign Manager and then set up in Search Ads 360 by your customer service contact.\u003c/p\u003e\n"],["\u003cp\u003eEach variable has a friendly name and a data type: "Metric" for numeric, aggregated data, and "Dimension" for filtering and segmenting data.\u003c/p\u003e\n"],["\u003cp\u003eTo upload custom data, use the \u003ccode\u003eConversion.insert()\u003c/code\u003e or \u003ccode\u003eConversion.update()\u003c/code\u003e requests with the appropriate fields for metrics and dimensions, ensuring the variable names match the configuration in Search Ads 360.\u003c/p\u003e\n"]]],["Custom Floodlight variables allow tracking of additional conversion data beyond default information. To use them, set them up in Campaign Manager and Search Ads 360. Variables can be metrics (numeric, aggregated data) or dimensions (text/numeric, filterable data). Upload data via `Conversion.insert()` or `Conversion.update()` requests, including the variable's friendly name and value within `customMetric` or `customDimension` fields. This uploaded data can then be used in Search Ads 360 for reporting, filtering, formula columns, segmentation, and API-driven report downloads.\n"],null,["# Upload Data for Custom Floodlight Variables\n\nBy default, a conversion contains a limited amount of descriptive data, such as the time the\nconversion occurred, the source of the conversion, and optionally a monetary value. If you\ncollect additional data about your conversions, such as the country to which a purchased item\nis shipped, product IDs, or even the duration of a telephone call, you can use [custom Floodlight variables](https://support.google.com/dcm/partner/answer/2823222) to track\nthe data and upload it to Search Ads 360.\n\nAfter you upload the data, you can:\n\n- Create reporting columns in Search Ads 360 to display the data or use it to\n filter a Floodlight column.\n\n- Use the data in formula columns.\n\n- Use the data to segment and group reports.\n\n- Use the Search Ads 360 API to\n [download reports that contain the data](/search-ads/v2/how-tos/reporting/custom-metrics-dimensions).\n\n[Learn more](https://support.google.com/searchads/answer/4397154) about using the\nuploaded data.\n\nSetting up custom Floodlight variables\n--------------------------------------\n\nYou initially set up custom Floodlight variables as part of\n[configuring Floodlight in\nCampaign Manager](https://support.google.com/dcm/partner/answer/2823222). Then, your Search Ads 360 customer service contact will\n[set up the custom\nvariables in Search Ads 360](https://support.google.com/searchads/answer/4397154#setup). After these steps are done, you can specify data\nfor the variables when you add or modify conversions.\n\nVariable name and type\n----------------------\n\nEach variable is assigned a **friendly name** that is unique for a given\nadvertiser and one of the following data types:\n\n- **Metric**: Numeric data that Search Ads 360 aggregates in conversion reports. For\n example, metric variables can be used to keep track of overall shipping costs or to keep\n count of items purchased.\n\n- **Dimension** : Numeric or text data that can be used to filter data in a\n report. For example, dimension variables can track a store name or numeric product ID, and\n then be used in [a Floodlight reporting\n column](https://support.google.com/searchads/answer/2558771) that contains only the data from a specific store or for a specific\n product.\n\nUploading the custom data\n-------------------------\n\nTo upload data for a **metric** custom Floodlight variable, include the\nfollowing field in a\n[`Conversion.insert()`](/search-ads/v2/reference/conversion/insert)\nor [`Conversion.update()`](/search-ads/v2/reference/conversion/update)\nrequest: \n\n```text\n 'customMetric': [\n {\n 'name': 'friendly-name',\n 'value': Number\n },\n ]\n```\n\nTo upload data for a **dimension** custom Floodlight variable, include the\nfollowing field in a\n[`Conversion.insert()`](/search-ads/v2/reference/conversion/insert)\nor [`Conversion.update()`](/search-ads/v2/reference/conversion/update)\nrequest: \n\n```text\n 'customDimension': [\n {\n 'name': 'friendly-name',\n 'value': String\n },\n ]\n```\n| **Important:** Make sure the name you specify in the request matches the name of a custom Floodlight variable as it has been configured in Search Ads 360. Otherwise the request will fail and respond with error message like this: \n| `The request was not valid. Details: [Custom dimension/metric does not exist:\n| Dimension_1]\"`\n\nExample\n-------\n\nFor example, an advertiser has the following custom Floodlight variables configured for\nSearch Ads 360:\n\n- sales (metric)\n- shipping (metric)\n- product_type (dimension)\n- product_id (dimension)\n\nIf a customer completes a purchase over the telephone, you can make the following\n[`Conversion.insert()`](/search-ads/v2/reference/conversion/insert)\nrequest to upload the conversion and include data for the custom metrics: \n\n```carbon\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion\nAuthorization: Bearer your OAuth 2.0 access token\nContent-type: application/json\n\n{\n 'kind': 'doubleclicksearch#conversionList',\n 'conversion' : [{\n 'agencyId': '12300000000000456', // Replace with your ID\n 'advertiserId': '78900000000000123', // Replace with your ID\n 'engineAccountId': '101100000000000123', // Replace with your ID\n 'campaignId': '13400000003156701', // Replace with your ID\n 'adGroupId': '58700000128508001', // Replace with your ID\n 'criterionId': '43700001095692142', // Replace with your ID\n 'adId': '0',\n 'conversionId': 'test_20140121_01',\n 'state': 'ACTIVE',\n 'type': 'TRANSACTION',\n 'revenueMicros': 10000000, // To report $10 of revenue, specify 10 million revenueMicros\n 'currencyCode': 'USD',\n 'segmentationType': 'FLOODLIGHT',\n 'segmentationId': '25700000001472562', // Replace with your ID\n 'conversionTimestamp': '1390073000011',\n 'floodlightOrderId': 'test',\n 'customMetric': [\n {\n 'name': 'sales',\n 'value': 2.0\n },\n {\n 'name': 'shipping',\n 'value': 3.0\n }\n ],\n 'customDimension': [\n {\n 'name': 'product_type',\n 'value': 'shoes'\n },\n {\n 'name': 'product_id',\n 'value': 'shoe 2'\n }\n ]\n }]\n}\n```\n\nHandle Search Ads 360 responses\n-------------------------------\n\nAs with other [`Conversion.insert()`](/search-ads/v2/reference/conversion/insert)\nor [`Conversion.update()`](/search-ads/v2/reference/conversion/update) requests,\nif the request succeeds, the response includes the full Search Ads 360 internal representation\nfor each uploaded conversion.\n\nIf the request fails to validate or upload, the response includes failure messages.\nFor more information about these failure messages, see [Handle\nSearch Ads 360 responses](/search-ads/v2/how-tos/conversions/insert#if-the-request-does-not-succeed) for insert requests."]]
