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
    }
  ]
}
اسم الموقع القيمة الوصف Notes
conversion[] list الإحالات الناجحة المطلوبة.
conversion[].adGroupId long رقم تعريف المجموعة الإعلانية في DS.
conversion[].adId long رقم تعريف إعلان DS
conversion[].adUserDataConsent string يمثل هذا الخيار الموافقة على الإعدادات المفضّلة لخدمات المنصات الأساسية (CPS) في الإعدادات. ما مِن قيمة تلقائية. القيم المقبولة هي: GRANTED: حالة الموافقة المطلوبة هي منح. اقرأ إعدادات CPS المفضّلة من إعدادات GTE. DENIED: حالة الموافقة المطلوبة هي الرفض، قائمة CPS فارغة.
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 Search باستخدام رقم تعريف عميل جديد في "إعلانات شبكة البحث 360".
إدراج
لإدراج مجموعة من الإحالات الناجحة الجديدة في DoubleClick Search.
تعديل
يعمل على تعديل مجموعة من الإحالات الناجحة في DoubleClick Search.
updateAvailability
تعديل توفير مجموعة من أنشطة Floodlight في "بحث DoubleClick"