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

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

المصادقة

تتطلّب واجهة Data Manager API بيانات اعتماد بنطاق مختلف عن واجهة Campaign Manager 360 API. اتّبِع الخطوات الواردة في مقالة إعداد إمكانية الوصول إلى واجهة برمجة التطبيقات لإنشاء بيانات اعتماد جديدة تتضمّن نطاق 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.
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 بالميكروثانية منذ حقبة يونكس.
  • في حال استخدام Protocol Buffers، استخدِم Timestamp واضبط الحقل seconds والحقل nanoseconds (اختياريًا).

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

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

مطلوبة في حال إرسال أحداث لميزة "الإحالات الناجحة المتعددة المصادر". يمكنك الاطّلاع على تحويل البيانات إلى عناصر 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. ويختلف ذلك عن Campaign Manager 360 API، حيث يتم إرفاق المعرّفات مباشرةً بعنصر 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 بدون مكافئ لا تتوفّر هذه الميزة لوجهات "مدير الحملة 360".
addressInfo.state بدون مكافئ لا تتوفّر هذه الميزة لوجهات "مدير الحملة 360".
addressInfo.hashedStreetAddress بدون مكافئ لا تتوفّر هذه الميزة لوجهات "مدير الحملة 360".

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

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 هذا العنصر مطلوب.
السابق
خطوات الترقية