Conversion: insert
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
دسته ای از تبدیل های جدید را در DoubleClick Search درج می کند. اکنون آن را امتحان کنید .
درخواست کنید
درخواست HTTP
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد:
| دامنه |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.
درخواست بدن
در بدنه درخواست، یک منبع تبدیل با ویژگی های زیر ارائه کنید:
| نام ملک | ارزش | توضیحات | یادداشت ها |
|---|
| ویژگی های مورد نیاز |
conversion[]. conversionId | string | برای تبدیل‌های آفلاین، تبلیغ‌کنندگان این شناسه را ارائه می‌کنند. تبلیغ‌کنندگان می‌توانند هر شناسه‌ای را که برایشان معنادار است، مشخص کنند. هر تبدیل در یک درخواست باید یک شناسه منحصر به فرد را مشخص کند و ترکیب شناسه و مهر زمانی باید در بین همه تبدیل‌های موجود در تبلیغ‌کننده منحصر به فرد باشد.
برای تبدیل‌های آنلاین، DS بسته به دستورالعمل‌های Floodlight تبلیغ‌کننده، dsConversionId یا floodlightOrderId را در این ویژگی کپی می‌کند. | |
conversion[]. conversionTimestamp | unsigned long | زمانی که در آن تبدیل صورت گرفت، در دوره UTC. | |
conversion[]. segmentationType | string | نوع تقسیم بندی این تبدیل (به عنوان مثال، FLOODLIGHT ).
مقادیر قابل قبول عبارتند از: | |
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eInserts a batch of new conversions into DoubleClick Search using the provided Conversion resource and requires authorization with the \u003ccode\u003edoubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eEach conversion requires a unique ID, timestamp, and segmentation type (e.g., FLOODLIGHT).\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a Conversion resource in the response body.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows insertion of both offline and online conversions, with specific ID handling for each.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can test the method using the provided APIs Explorer or the standalone Explorer.\u003c/p\u003e\n"]]],["This outlines how to insert new conversions into DoubleClick Search using a POST request to the specified endpoint. Authorization with the `https://www.googleapis.com/auth/doubleclicksearch` scope is required. The request body should include a Conversion resource containing properties like `conversionId` (unique identifier), `conversionTimestamp` (time of conversion in UTC), and `segmentationType` (e.g., `FLOODLIGHT`). Successful requests return a Conversion resource in the response body.\n"],null,["# Conversion: insert\n\n| **Note:** Requires [authorization](#auth).\n\nInserts a batch of new conversions into DoubleClick Search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion\n```\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Conversion resource](/search-ads/v2/reference/conversion#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|------------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| **Required Properties** ||||\n| conversion[].`conversionId` | `string` | For offline conversions, advertisers provide this ID. Advertisers can specify any ID that is meaningful to them. Each conversion in a request must specify a unique ID, and the combination of ID and timestamp must be unique amongst all conversions within the advertiser. For online conversions, DS copies the `dsConversionId` or `floodlightOrderId` into this property depending on the advertiser's Floodlight instructions. | |\n| conversion[].`conversionTimestamp` | `unsigned long` | The time at which the conversion took place, in epoch millis UTC. | |\n| conversion[].`segmentationType` | `string` | The segmentation type of this conversion (for example, `FLOODLIGHT`). \u003cbr /\u003e Acceptable values are: - \"`FLOODLIGHT`\" | |\n\nResponse\n--------\n\nIf successful, this method returns a [Conversion resource](/search-ads/v2/reference/conversion#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.conversion.insert)."]]
