Conversion: insert
إدراج دُفعة من الإحالات الناجحة الجديدة في DoubleClick Search.
تجربة ذلك الآن
الطلب
طلب HTTP
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
| النطاق |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، قدِّم مورد إحالة ناجحة مع السمات التالية:
| اسم الموقع |
القيمة |
الوصف |
ملاحظات |
| الخصائص المطلوبة |
conversion[].conversionId |
string |
وبالنسبة إلى الإحالات الناجحة بلا إنترنت، يقدّم المعلِنون هذا المعرّف. ويمكن للمعلنين تحديد أي رقم تعريف مفيد لهم. يجب أن تحدد كل إحالة ناجحة في الطلب معرّفًا فريدًا، كما يجب أن تكون تركيبة المعرّف والطابع الزمني فريدة بين جميع الإحالات الناجحة ضمن المعلن.
بالنسبة إلى الإحالات الناجحة على الإنترنت، ينسخ DS dsConversionId أو floodlightOrderId في هذا الموقع استنادًا إلى تعليمات Floodlight لدى المعلِن. |
|
conversion[].conversionTimestamp |
unsigned long |
الوقت الذي حدث فيه التحويل، بالمللي ثانية بالتوقيت العالمي المنسق (UTC). |
|
conversion[].segmentationType |
string |
نوع التصنيف لهذه الإحالة الناجحة (مثل FLOODLIGHT).
القيم المقبولة هي:
|
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-20 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-20 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Inserts a batch of new conversions into DoubleClick Search using the provided Conversion resource and requires authorization with the `doubleclicksearch` scope."],["Each conversion requires a unique ID, timestamp, and segmentation type (e.g., FLOODLIGHT)."],["Successful requests return a Conversion resource in the response body."],["The API allows insertion of both offline and online conversions, with specific ID handling for each."],["Developers can test the method using the provided APIs Explorer or the standalone Explorer."]]],["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"]]
