يتضمّن مورد الإحالات الناجحة طرقًا تتيح للمستخدمين إنشاء الإحالات الناجحة في 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 |
قناة بيع المنتج. القيم المقبولة هي:
|
|
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 باستخدام رقم تعريف عميل جديد في "إعلانات شبكة البحث 360".
- إدراج
- إدراج مجموعة من الإحالات الناجحة الجديدة في DoubleClick Search.
- تعديل
- تحديث مجموعة من الإحالات الناجحة في DoubleClick Search.
- updateAvailability
- تحديث مدى توفّر مجموعة من أنشطة Floodlight في DoubleClick Search.