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

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

حقول الطلب

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

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

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 بالمايكرو ثانية منذ بداية حقبة Unix.
  • في حال استخدام مخازن البروتوكول، استخدِم 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 على معرّف فريد لكل حدث.

هذا الحقل اختياري عند إرسال الإحالات الناجحة غير الإلكترونية في 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. يختلف ذلك عن 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 بدون مكافئ غير متاح في الإصدار الحالي من 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 مطلوب.
السابق
خطوات الترقية