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

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

المصادقة

تتطلّب Data Manager API بيانات اعتماد بنطاق مختلف عن نطاق Campaign Manager 360 API. اتّبِع الخطوات الواردة في إعداد إذن الوصول إلى واجهة برمجة التطبيقات لإنشاء بيانات اعتماد جديدة تتضمّن نطاق Data Manager API.

حقول الطلب

conversions.batchinsert (واجهة برمجة التطبيقات "مدير الحملة 360") 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 (واجهة برمجة التطبيقات "مدير الحملة 360") 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 الوجهة destination المناسبة.
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 على معرّف فريد لكل حدث.

مطلوبة في حال إرسال أحداث الإحالات الناجحة المتعددة المصادر. لمزيد من التفاصيل، يُرجى الاطّلاع على تحويل البيانات إلى عناصر 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 (واجهة برمجة التطبيقات "مدير الحملة 360") 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 (واجهة برمجة التطبيقات "مدير الحملة 360") CartData (Data Manager API) ملاحظات
kind بدون مكافئ حقل البيانات الوصفية، ولا تستخدمه واجهة Data Manager API.
merchantId merchantId
merchantFeedLabel merchantFeedLabel
merchantFeedLanguage merchantFeedLanguageCode
items items قائمة بعناصر Item يُرجى الاطّلاع على حقول السلع لمزيد من التفاصيل.

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

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