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,
      "sessionAttributesEncoded": bytes
    }
  ]
}

اسم السمة	القيمة	الوصف	ملاحظات
conversion[]	list	الإحالات الناجحة المطلوبة
conversion[].adGroupId	long	رقم تعريف المجموعة الإعلانية في "شبكة البحث"
conversion[].adId	long	رقم تعريف الإعلان في DS.
conversion[].adUserDataConsent	string	تمثّل الموافقة على الإعدادات المفضّلة لخدمات المنصّات الأساسية في الإعدادات. لا تتوفّر قيمة تلقائية. القيم المقبولة هي: تمّ منح الموافقة: حالة الموافقة المطلوبة هي المنح. قراءة الإعدادات المفضّلة لنظام CPS من إعدادات GTE مرفوضة: حالة الموافقة المطلوبة هي الرفض، وقائمة خدمات المنصات الأساسية فارغة. القِيَم المقبولة هي: "DENIED" "GRANTED" "UNKNOWN"
conversion[].advertiserId	long	رقم تعريف المعلِن في "مساحة العرض والفيديو 360"
conversion[].agencyId	long	رقم تعريف الوكالة في DS
conversion[].attributionModel	string	لا تتوفّر هذه الميزة للمعلِنين إلا بعد التواصل مع فريق دعم عملاء DoubleClick Search.
conversion[].campaignId	long	رقم تعريف حملة "إعلانات شبكة البحث".
conversion[].channel	string	قناة البيع للمنتج. القيم المقبولة هي: "local": متجر "online": متجر على الإنترنت
conversion[].clickId	string	معرّف النقرة على شبكة البحث للإحالة الناجحة.
conversion[].conversionId	string	بالنسبة إلى الإحالات الناجحة بلا إنترنت، يقدّم المعلِنون هذا المعرّف. يمكن للمعلِنين تحديد أيّ معرّف يهمّهم. يجب أن تحدِّد كل إحالة ناجحة في الطلب رقم تعريف فريدًا، ويجب أن يكون الجمع بين رقم التعريف والطابع الزمني فريدًا بين جميع الإحالات الناجحة للمعلِن. بالنسبة إلى الإحالات الناجحة على الإنترنت، تنسخ "إحصاءات Google‏ 4" dsConversionId أو floodlightOrderId إلى هذا الموقع الإلكتروني استنادًا إلى تعليمات Floodlight الخاصة بالمعلِن.
conversion[].conversionModifiedTimestamp	unsigned long	الوقت الذي تم فيه إجراء آخر تعديل على الإحالة الناجحة، بالمللي ثانية حسب التوقيت العالمي المنسَّق
conversion[].conversionTimestamp	unsigned long	الوقت الذي حدثت فيه عملية التحويل، بالمللي ثانية من الحقبة بالتوقيت العالمي المنسّق
conversion[].countMillis	long	لا تتوفّر هذه الميزة للمعلِنين إلا بعد التواصل مع فريق دعم عملاء DoubleClick Search.
conversion[].criterionId	long	رقم تعريف معيار (كلمة رئيسية) "إعلانات شبكة البحث".
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	رقم تعريف حساب محرّك "إعلانات شبكة البحث"
conversion[].floodlightOrderId	string	رقم تعريف طلب Floodlight الذي قدّمه المعلِن للإحالة الناجحة.
conversion[].inventoryAccountId	long	رقم التعريف الذي ينشئه "نظام إدارة المستودع" ويستخدمه لتحديد حساب المستودع الذي يحتوي على المنتج بشكل فريد.
conversion[].productCountry	string	البلد المسجَّل لخلاصة Merchant Center التي تحتوي على المنتج. استخدِم رمز ISO 3166 لتحديد بلد.
conversion[].productGroupId	long	معرّف مجموعة المنتجات في "إعلانات شبكة البحث"
conversion[].productId	string	رقم تعريف المنتج (رمز التخزين التعريفي)
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[].sessionAttributesEncoded	bytes	سمات الجلسة للحدث، يتم تمثيلها كسلسلة JSON بترميز base64. يجب أن يتم إنشاء المحتوى من خلال مكتبة تقدّمها Google.
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	يحدِّد هذا المَعلمة كمورد ConversionList. القيمة: السلسلة الثابتة doubleclicksearch#conversionList.

الطُرق

الحصول

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

getByCustomerId

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

إدراج

تُستخدَم هذه السمة لإدراج مجموعة من الإحالات الناجحة الجديدة في DoubleClick Search.

تعديل

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

updateAvailability

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