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.