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

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

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

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