يحتوي مورد الإحالات الناجحة على طرق تسمح للمستخدمين بإنشاء الإحالات الناجحة في 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 |
قناة بيع المنتج. القيم المقبولة هي:
|
|
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 |
نوع الجهاز الذي حدثت عليه الإحالة الناجحة.
القيم المقبولة هي:
|
|
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 ).
القيم المقبولة هي:
|
|
conversion[].state |
string |
حالة الإحالة الناجحة، أي ACTIVE أو REMOVED . ملاحظة: تم إيقاف الحالة DELETED نهائيًا.
القيم المقبولة هي:
|
قابل للكتابة |
conversion[].storeId |
string |
رقم تعريف المتجر المحلي الذي تم الإعلان عن المنتج له. لا يسري هذا العرض إلا عندما تكون القناة "local ". |
|
conversion[].type |
string |
نوع الإحالة الناجحة، أي ACTION أو TRANSACTION . الإحالة الناجحة "ACTION " هي إجراء يتّخذه المستخدم بدون قيمة قابلة للقياس الكمي، في حين أنّ الإحالة الناجحة "TRANSACTION " هي إجراء له قيمة قابلة للقياس الكمي. من الأمثلة على ذلك عمليات الاشتراك في قوائم عناوين البريد الإلكتروني (ACTION ) في مقابل عمليات الشراء من خلال التجارة الإلكترونية (TRANSACTION ).
القيم المقبولة هي:
|
|
kind |
string |
يتم تحديد هذا العنصر على أنّه مورد قائمة الإحالات الناجحة. القيمة: السلسلة الثابتة doubleclicksearch#conversionList . |
الطُرق
- الحصول على
- استرداد قائمة بالإحالات الناجحة من حساب محرك بحث DoubleClick.
- getByCustomerId
- استرداد قائمة الإحالات الناجحة من حساب محرّك بحث DoubleClick Search باستخدام رقم تعريف عميل جديد في "إعلانات شبكة البحث 360".
- إدراج
- لإدراج مجموعة من الإحالات الناجحة الجديدة في DoubleClick Search.
- تعديل
- يعمل على تعديل مجموعة من الإحالات الناجحة في DoubleClick Search.
- updateAvailability
- تعديل توفير مجموعة من أنشطة Floodlight في "بحث DoubleClick"