Conversion

يتضمّن مورد الإحالات الناجحة طرقًا تتيح للمستخدمين إنشاء الإحالات الناجحة في Floodlight وتعديلها واستردادها بشكل مجمّع.

للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.

تمثيلات الموارد

قائمة بالإحالات الناجحة

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}

اسم الموقع	القيمة	الوصف	ملاحظات
conversion[]	list	الإحالات الناجحة المطلوبة.
conversion[].adGroupId	long	رقم تعريف المجموعة الإعلانية في DS.
conversion[].adId	long	رقم تعريف الإعلان في DS.
conversion[].adUserDataConsent	string	يمثّل ذلك الموافقة على الإعدادات المفضّلة لخدمات المنصات الأساسية (CPS) في الإعدادات. لم يتم تحديد قيمة تلقائية. القيم المقبولة هي: GRANTED: حالة الموافقة المطلوبة هي "لمنح". يمكنك قراءة إعدادات CPS من إعدادات GTE. DENIED: حالة الموافقة المطلوبة هي الرفض قائمة خدمات المنصة الأساسية فارغة.
conversion[].advertiserId	long	الرقم التعريفي للمعلِن في DS.
conversion[].agencyId	long	رقم تعريف وكالة DS.
conversion[].attributionModel	string	لا يتوفر للمعلنين إلا بعد الاتصال بفريق دعم عملاء DoubleClick Search.
conversion[].campaignId	long	رقم تعريف الحملة في DS.
conversion[].channel	string	قناة بيع المنتج. القيم المقبولة هي: "local": متجر "online": متجر على الإنترنت
conversion[].clickId	string	رقم تعريف النقرة في DS للإحالة الناجحة.
conversion[].conversionId	string	وبالنسبة إلى الإحالات الناجحة بلا إنترنت، يقدّم المعلِنون هذا المعرّف. ويمكن للمعلنين تحديد أي رقم تعريف مفيد لهم. يجب أن تحدد كل إحالة ناجحة في الطلب معرّفًا فريدًا، كما يجب أن تكون تركيبة المعرّف والطابع الزمني فريدة بين جميع الإحالات الناجحة ضمن المعلن. بالنسبة إلى الإحالات الناجحة على الإنترنت، ينسخ DS dsConversionId أو floodlightOrderId في هذا الموقع استنادًا إلى تعليمات Floodlight لدى المعلِن.
conversion[].conversionModifiedTimestamp	unsigned long	الوقت الذي تم فيه آخر تعديل على الإحالة الناجحة، بالمللي ثانية حسب التوقيت العالمي المنسّق (UTC).
conversion[].conversionTimestamp	unsigned long	الوقت الذي حدث فيه التحويل، بالمللي ثانية بالتوقيت العالمي المنسق (UTC).
conversion[].countMillis	long	لا يتوفر للمعلنين إلا بعد الاتصال بفريق دعم عملاء DoubleClick Search.
conversion[].criterionId	long	رقم تعريف معيار DS (الكلمة الرئيسية).
conversion[].currencyCode	string	رمز العملة لأرباح الإحالة الناجحة. يجب أن يكون بتنسيق ISO 4217 الأبجدي (3 أحرف).	قابل للكتابة
conversion[].customDimension[]	list	السمات المخصّصة للإحالة الناجحة، والتي يمكن استخدامها لفلترة البيانات في أحد التقارير
conversion[].customDimension[].name	string	اسم البُعد المخصّص.
conversion[].customDimension[].value	string	قيمة البُعد المخصّص.
conversion[].customMetric[]	list	المقاييس المخصّصة للإحالة الناجحة
conversion[].customMetric[].name	string	اسم المقياس المخصّص
conversion[].customMetric[].value	double	القيمة الرقمية للمقياس المخصّص.
conversion[].customerId	string	الرقم التعريفي الجديد لعميل "إعلانات شبكة البحث 360" يجب أن يكون حساب عميل. وعند ضبط هذا الحقل، يجب ضبط جميع حقول أرقام التعريف الأخرى على أرقام تعريف التجربة الجديدة من "إعلانات شبكة البحث 360".
conversion[].deviceType	string	نوع الجهاز الذي حدثت عليه الإحالة الناجحة. في ما يلي القيم المقبولة: "DESKTOP" "HIGH_END_MOBILE" "OTHER_DEVICE" "TABLET"
conversion[].dsConversionId	long	رقم التعريف الذي ينشئه DoubleClick Search لكل إحالة ناجحة.
conversion[].engineAccountId	long	رقم تعريف حساب محرك البحث في DS.
conversion[].floodlightOrderId	string	رقم تعريف طلب Floodlight الذي يقدّمه المعلِن للإحالة الناجحة
conversion[].inventoryAccountId	long	رقم التعريف الذي ينشئه DS ويستخدمه لتحديد حساب المستودع الذي يحتوي على المنتج بشكلٍ فريد.
conversion[].productCountry	string	البلد المسجَّل في خلاصة Merchant Center التي تحتوي على المنتج. استخدِم رمز ISO 3166 لتحديد البلد.
conversion[].productGroupId	long	رقم تعريف مجموعة المنتجات في DS.
conversion[].productId	string	تمثّل هذه السمة معرّف المنتج (SKU).
conversion[].productLanguage	string	اللغة المسجّلة في خلاصة Merchant Center التي تحتوي على المنتج. استخدِم رمز ISO 639 لتحديد اللغة.
conversion[].quantityMillis	long	مقدار هذه الإحالة الناجحة بالمللي ثانية	قابل للكتابة
conversion[].revenueMicros	long	مبلغ أرباح هذه الإحالة الناجحة البالغ عددها TRANSACTION بالمايكرو (القيمة مضروبة في 1000000، بدون علامة عشرية). على سبيل المثال، لتحديد قيمة أرباح "10" أدخِل "10000000". (10 ملايين) في طلبك.	قابل للكتابة
conversion[].segmentationId	long	معرّف التصنيف الرقمي (على سبيل المثال، رقم تعريف نشاط DoubleClick Search Floodlight).
conversion[].segmentationName	string	معرّف تصنيف متوافق (مثل اسم نشاط DoubleClick Search Floodlight).
conversion[].segmentationType	string	نوع التصنيف لهذه الإحالة الناجحة (مثل FLOODLIGHT). القيم المقبولة هي: "FLOODLIGHT"
conversion[].state	string	حالة الإحالة الناجحة، وهي إما ACTIVE أو REMOVED. ملاحظة: تم إيقاف الحالة "DELETED" نهائيًا. في ما يلي القيم المقبولة: "ACTIVE" "DELETED":  (متوقّفة نهائيًا) "REMOVED"	قابل للكتابة
conversion[].storeId	string	معرّف المتجر المحلي الذي تم الإعلان عن المنتج له. سارٍ فقط عندما تكون القناة هي "local".
conversion[].type	string	نوع الإحالة الناجحة، أي ACTION أو TRANSACTION. الإحالة الناجحة ACTION هي إجراء ينفّذه المستخدم بدون قيمة قابلة للقياس الكمي، بينما الإحالة الناجحة TRANSACTION هي إجراء له قيمة قابلة للقياس الكمي. تشمل الأمثلة عمليات الاشتراك في قوائم عناوين البريد الإلكتروني (ACTION) مقابل عمليات الشراء في التجارة الإلكترونية (TRANSACTION). في ما يلي القيم المقبولة: "ACTION" "TRANSACTION"
kind	string	يصنّف هذا العنصر على أنّه مورد في "قائمة الإحالات الناجحة". القيمة: السلسلة الثابتة doubleclicksearch#conversionList

الطُرق

الحصول على

استرداد قائمة بالإحالات الناجحة من حساب محرك بحث DoubleClick.

getByCustomerId

استرداد قائمة بالإحالات الناجحة من حساب محرك بحث DoubleClick باستخدام رقم تعريف عميل جديد في "إعلانات شبكة البحث 360".

إدراج

إدراج مجموعة من الإحالات الناجحة الجديدة في DoubleClick Search.

تعديل

تحديث مجموعة من الإحالات الناجحة في DoubleClick Search.

updateAvailability

تحديث مدى توفّر مجموعة من أنشطة Floodlight في DoubleClick Search.