تعيينات الحقول

استخدِم عمليات الربط في الجداول لربط conversions.batchinsert في Campaign Manager 360 API بمكافئها IngestEventsRequest في Data Manager API.

حقول الطلب

conversions.batchinsert (Campaign Manager 360 API) IngestEventsRequest (Data Manager API) ملاحظات
profileId مَعلمة مسار عنوان URL بدون مكافئ
kind بدون مكافئ حقل البيانات الوصفية، ولا تستخدمه Data Manager API.
conversions events مطلوبة قائمة الإحالات الناجحة أو الأحداث راجِع قسم حقول الإحالات الناجحة لمعرفة التفاصيل.
encryptionInfo تم النقل إلى events.adIdentifiers.encryptedUserIds يتم تحديدها على مستوى الحدث. يتم الآن تحديد معلومات التشفير في "مدير الحملة 360" في كلّ رقم تعريف مستخدم مشفَّر. اطّلِع على قسم حقول الإحالات الناجحة.
بدون مكافئ encryptionInfo encryptionInfo على مستوى الطلب هي معلومات التشفير لمعرّفات المستخدمين UserData المشفّرة. لمزيد من التفاصيل، يُرجى الاطّلاع على التشفير.
بدون مكافئ destinations مطلوبة قائمة بعناصر Destination التي تحدّد الحساب المستهدف ونشاط Floodlight للأحداث. راجِع دليل الوجهات للاطّلاع على التفاصيل. اربط الحقول الفردية كما هو موضّح في قسم حقول الإحالات الناجحة.
بدون مكافئ consent إعدادات الموافقة التلقائية الاختيارية للأحداث في الطلب. يمكنك إلغاء هذه القيمة لحدث فردي من خلال ضبط الحقل consent الخاص بـ Event.
بدون مكافئ encoding مطلوبة في حال إرسال معرّفات المستخدمين: اضبطها على Encoding المستخدَمة لقيم UserIdentifier. في حال عدم استخدام معرّفات المستخدمين، يتم تجاهل هذا الحقل.
بدون مكافئ validateOnly إذا كانت القيمة صحيحة، يتم التحقّق من صحة الطلب، ولكن لا يتم تنفيذه.

حقول الإحالات الناجحة

Conversion (Campaign Manager 360 API) Event (Data Manager API) ملاحظات
floodlightConfigurationId destinations[].operatingAccount.accountId يتم تحديدها على مستوى الطلب. اضبط القيمة على رقم تعريف إعدادات Floodlight.
بدون مكافئ destinations[].operatingAccount.accountType يتم تحديدها على مستوى الطلب. اضبط السمة على FLOODLIGHT_CONFIG.
floodlightActivityId destinations[].productDestinationId يتم تحديدها على مستوى الطلب. يجب ضبطه على رقم تعريف نشاط Floodlight (المعروف سابقًا باسم رقم تعريف نشاط Floodlight).
kind بدون مكافئ حقل البيانات الوصفية، ولا تستخدمه Data Manager API.
بدون مكافئ destinations[].reference يتم تحديدها على مستوى الطلب. معرّف يحدّده المستخدِم للوجهة. اضبط هذا الحقل إذا كنت ترسل أحداثًا إلى وجهات متعددة في طلب واحد.
adUserDataConsent consent.adUserData لمزيد من التفاصيل، يُرجى الاطّلاع على Consent.
nonPersonalizedAd consent.adPersonalization لمزيد من التفاصيل، يُرجى الاطّلاع على Consent.
بدون مكافئ destinationReferences في حال إرسال الأحداث إلى وجهات متعدّدة في طلب واحد، اضبط هذا الحقل على reference الوجهة المناسبة في الوجهة.
timestampMicros eventTimestamp
  • في حال استخدام تنسيق JSON، اضبط القيمة على تنسيق RFC 3339، الذي يختلف قليلاً عن Campaign Manager 360 API، الذي كان يتوقّع timestampMicros بالميكرو ثانية منذ بداية فترة الطابع الزمني بتنسيق Unix.
  • في حال استخدام بروتوكولات المخزن المؤقت، استخدِم Timestamp واضبط الحقلَين seconds وnanoseconds (اختياريًا).

لمزيد من التفاصيل، يُرجى الاطّلاع على تنسيق الطابع الزمني.
value conversionValue
quantity conversionCount
ordinal بدون مكافئ لا يتوفّر الحقل ordinal من Campaign Manager 360 API في Data Manager API. بدلاً من ذلك، يمكن استخدام transactionId للتحكّم في كيفية إزالة التكرار من الإحالات الناجحة من المستخدِم نفسه وفي اليوم نفسه.

في Campaign Manager 360 API، يمكنك التأكّد من إزالة تكرار الأحداث من خلال ضبط ordinal على قيمة ثابتة، مثل 1. في Data Manager API، يجب ضبط transactionId على معرّف فريد لكل حدث.
بدون مكافئ transactionId في Data Manager API، يتم استخدام transactionId للتحكّم في كيفية إزالة التكرار من الإحالات الناجحة من المستخدِم نفسه وفي اليوم نفسه. يجب ضبط قيمة هذا الحقل على معرّف فريد لكل حدث.

هذا الحقل اختياري عند إرسال الإحالات الناجحة غير الإلكترونية في Floodlight. اطّلِع على تحويل البيانات إلى عناصر Event للحصول على مزيد من التفاصيل.
customVariables customVariables قائمة بعناصر CustomVariable تستخدم Data Manager API السلاسل كمفاتيح بدلاً من التعدادات. استخدِم مفاتيح مثل U1 وU2 للحقل variable.
limitAdTracking consent.adPersonalization لمزيد من التفاصيل، يُرجى الاطّلاع على Consent.
childDirectedTreatment consent.adPersonalization لمزيد من التفاصيل، يُرجى الاطّلاع على Consent.
treatmentForUnderage consent.adPersonalization لمزيد من التفاصيل، يُرجى الاطّلاع على Consent.
gclid adIdentifiers.gclid لمزيد من التفاصيل، يُرجى الاطّلاع على AdIdentifiers.
dclid adIdentifiers.dclid لمزيد من التفاصيل، يُرجى الاطّلاع على AdIdentifiers.
matchId adIdentifiers.matchId لمزيد من التفاصيل، يُرجى الاطّلاع على AdIdentifiers.
mobileDeviceId adIdentifiers.mobileId لمزيد من التفاصيل، يُرجى الاطّلاع على AdIdentifiers.
impressionId adIdentifiers.impressionId لمزيد من التفاصيل، يُرجى الاطّلاع على AdIdentifiers.
encryptedUserId adIdentifiers.encryptedUserIds تتيح Data Manager API استخدام أرقام تعريف مستخدمين متعدّدة ومشفّرة. لمزيد من التفاصيل، يُرجى الاطّلاع على AdIdentifiers.
encryptedUserIdCandidates adIdentifiers.encryptedUserIds يرتبط كل رقم تعريف مرشّح بكائن EncryptedUserId في القائمة.
encryptionInfo.kind بدون مكافئ حقل البيانات الوصفية، ولا تستخدمه Data Manager API.
encryptionInfo.encryptionEntityType adIdentifiers.encryptedUserIds[].entityType بدلاً من تحديد معلومات التشفير مرة واحدة لكل طلب، يتم تحديدها لكل معرّف مستخدم مشفّر.
encryptionInfo.encryptionEntityId adIdentifiers.encryptedUserIds[].entityId بدلاً من تحديد معلومات التشفير مرة واحدة لكل طلب، يتم تحديدها لكل معرّف مستخدم مشفّر.
encryptionInfo.encryptionSource adIdentifiers.encryptedUserIds[].source بدلاً من تحديد معلومات التشفير مرة واحدة لكل طلب، يتم تحديدها لكل معرّف مستخدم مشفّر.
sessionAttributesEncoded adIdentifiers.sessionAttributes لمزيد من التفاصيل، يُرجى الاطّلاع على AdIdentifiers.
cartData cartData يمكنك الاطّلاع على حقول بيانات سلّة التسوّق لمعرفة التفاصيل.
userIdentifiers userData.userIdentifiers راجِع حقول معرّفات المستخدمين لمعرفة التفاصيل.

حقول معرّفات المستخدمين

في Data Manager API، يتم تجميع معرّفات المستخدمين ضمن العنصر UserData ضمن الحقل userData الخاص بـ Event. يختلف ذلك عن واجهة برمجة التطبيقات في "مدير الحملة 360"، حيث يتم ربط المعرّفات مباشرةً بالكائن Conversion.

UserIdentifier (Campaign Manager 360 API) UserIdentifier (Data Manager API) ملاحظات
hashedEmail emailAddress يجب ضبطه على عنوان البريد الإلكتروني المنسَّق والمجزَّأ. يمكنك أيضًا تشفير عنوان البريد الإلكتروني المجزّأ.
hashedPhoneNumber phoneNumber يتم ضبطه على رقم الهاتف المنسَّق والمشفَّر. يمكنك أيضًا تشفير رقم الهاتف المجزّأ.
addressInfo address يجب ضبطها على عنصر AddressInfo. اتّبِع إرشادات التنسيق والتجزئة. يمكنك أيضًا تشفير السمات المجزّأة لعنوان.
addressInfo.hashedFirstName address.givenName
addressInfo.hashedLastName address.familyName
addressInfo.countryCode address.regionCode
addressInfo.postalCode address.postalCode
addressInfo.city بدون مكافئ غير متاح في الإصدار الحالي من Data Manager API.
addressInfo.state بدون مكافئ غير متاح في الإصدار الحالي من Data Manager API.
addressInfo.hashedStreetAddress بدون مكافئ غير متاح في الإصدار الحالي من Data Manager API.

حقول بيانات سلة التسوّق

CartData (Campaign Manager 360 API) CartData (Data Manager API) ملاحظات
kind بدون مكافئ حقل البيانات الوصفية، ولا تستخدمه Data Manager API.
merchantId merchantId
merchantFeedLabel merchantFeedLabel
merchantFeedLanguage merchantFeedLanguageCode
items items قائمة بعناصر Item يُرجى الاطّلاع على حقول العناصر لمزيد من التفاصيل.

حقول السلع لبيانات سلة التسوّق

Item (Campaign Manager 360 API) Item (Data Manager API) ملاحظات
kind بدون مكافئ حقل البيانات الوصفية، ولا تستخدمه Data Manager API.
بدون مكافئ itemId اختياريّ. تمثّل هذه السمة معرّفًا فريدًا للسلعة.
itemId merchantProductId مطلوبة يجب ضبطه على معرّف المنتج في Merchant Center الخاص بالسلعة.
quantity quantity مطلوبة
unitPrice unitPrice مطلوبة
السابق
خطوات الترقية