نگاشت‌های فیلد

از نگاشت‌های موجود در جدول‌ها برای نگاشتن conversions.batchinsert در Campaign Manager 360 API به IngestEventsRequest معادل آن در Data Manager API استفاده کنید.

اصالت‌سنجی

‫Data Manager API به اعتبارنامه‌هایی با دامنه‌ای متفاوت از Campaign Manager 360 API نیاز دارد. مراحل مندرج در راه‌اندازی دسترسی به API را دنبال کنید تا اطلاعات اعتباری جدیدی که شامل حوزه «میانای برنامه‌سازی کاربردی مدیر داده‌ها» است تولید کنید.

فیلدهای درخواست

conversions.batchinsert (Campaign Manager 360 API)	IngestEventsRequest (Data Manager API)	یادداشت‌ها
پارامتر مسیر نشانی وب profileId	معادل ندارد
kind	معادل ندارد	فیلد فراداده؛ توسط «میانای برنامه‌سازی کاربردی مدیر داده» استفاده نمی‌شود.
conversions	events	الزامی. فهرست تبدیل‌ها یا رویدادها. برای جزئیات، بخش فیلدهای تبدیل را ببینید.
encryptionInfo	به events.adIdentifiers.encryptedUserIds منتقل شد	در سطح رویداد تعریف شده است. اطلاعات رمزگذاری Campaign Manager 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	معادل ندارد	فیلد فراداده؛ توسط «میانای برنامه‌سازی کاربردی مدیر داده» استفاده نمی‌شود.
معادل ندارد	destinations[].reference	در سطح درخواست تعریف شده است. شناسه تعریف‌شده توسط کاربر برای مقصد. اگر رویدادها را در یک درخواست به چندین مقصد ارسال می‌کنید، این فیلد را تنظیم کنید.
adUserDataConsent	consent.adUserData	برای جزئیات بیشتر، Consent را ببینید.
nonPersonalizedAd	consent.adPersonalization	برای جزئیات بیشتر، Consent را ببینید.
معادل ندارد	destinationReferences	اگر رویدادها را در یک درخواست به چندین مقصد ارسال می‌کنید، این فیلد را روی reference مربوط به مقصد تنظیم کنید.
timestampMicros	eventTimestamp	اگر از قالب JSON استفاده می‌کنید، آن را روی مقداری در قالب RFC 3339 تنظیم کنید که کمی با Campaign Manager 360 API متفاوت است، زیرا این API انتظار داشت timestampMicros در میکروثانیه از زمان Unix epoch باشد. اگر از بافرهای پروتکل استفاده می‌کنید، از Timestamp استفاده کنید و فیلدهای seconds و (درصورت تمایل) nanoseconds را تنظیم کنید. برای جزئیات بیشتر، قالب مُهر زمان را ببینید.
value	conversionValue
quantity	conversionCount
ordinal	معادل ندارد	فیلد ordinal از Campaign Manager 360 API در Data Manager API وجود ندارد. درعوض، Data Manager API از transactionId برای حذف رویدادهای تکراری که به شناسه فعالیت Floodlight یکسان ارسال شده‌اند استفاده می‌کند. در «میانای برنامه‌سازی کاربردی Campaign Manager 360»، می‌توانید با تنظیم ordinal روی مقدار ثابت و ثابتی مثل 1، مطمئن شوید که رویدادها تکراری‌زدایی می‌شوند. در «میانای برنامه‌سازی کاربردی مدیر داده»، transactionId باید برای هر رویداد روی شناسه یکتا تنظیم شود.
معادل ندارد	transactionId	«میانای برنامه کاربردی مدیر داده» از ترکیبی از شناسه فعالیت Floodlight و transactionId برای حذف کردن رویدادهای تکراری استفاده می‌کند. فیلد transactionId باید روی شناسه یکتایی برای هر رویداد تنظیم شود. اگر رویدادهایی برای تبدیل‌های چندمنبعی ارسال می‌کنید، الزامی است. برای جزئیات بیشتر، تبدیل داده‌ها به Event شیء را ببینید.
customVariables	customVariables	فهرستی از اشیای CustomVariable. «میانای برنامه‌سازی کاربردی مدیر داده» به‌جای شمارش‌ها از رشته‌ها به‌عنوان کلید استفاده می‌کند. برای فیلد variable از کلیدهایی مثل U1، U2 استفاده کنید.
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	معادل ندارد	فیلد فراداده؛ توسط «میانای برنامه‌سازی کاربردی مدیر داده» استفاده نمی‌شود.
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	معادل ندارد	برای مقصدهای Campaign Manager 360 پشتیبانی نمی‌شود.
addressInfo.state	معادل ندارد	برای مقصدهای Campaign Manager 360 پشتیبانی نمی‌شود.
addressInfo.hashedStreetAddress	معادل ندارد	برای مقصدهای Campaign Manager 360 پشتیبانی نمی‌شود.

فیلدهای داده‌های سبد خرید

CartData (Campaign Manager 360 API)	CartData (Data Manager API)	یادداشت‌ها
kind	معادل ندارد	فیلد فراداده؛ توسط «میانای برنامه‌سازی کاربردی مدیر داده» استفاده نمی‌شود.
merchantId	merchantId
merchantFeedLabel	merchantFeedLabel
merchantFeedLanguage	merchantFeedLanguageCode
items	items	فهرستی از اشیای Item. برای جزئیات بیشتر، فیلدهای مورد را ببینید.

فیلدهای مورد برای داده‌های سبد خرید

Item (Campaign Manager 360 API)	Item (Data Manager API)	یادداشت‌ها
kind	معادل ندارد	فیلد فراداده؛ توسط «میانای برنامه‌سازی کاربردی مدیر داده» استفاده نمی‌شود.
معادل ندارد	itemId	اختیاری. شناسه یکتای مورد.
itemId	merchantProductId	الزامی. روی شناسه محصول Merchant Center برای این مورد تنظیم کنید.
quantity	quantity	الزامی.
unitPrice	unitPrice	الزامی.