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

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

اصالت‌سنجی

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

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

conversions.batchinsert (Campaign Manager 360 API)	IngestEventsRequest (Data Manager API)	یادداشت‌ها
پارامتر مسیر نشانی وب profileId	بدون معادل
kind	بدون معادل	فیلد فراداده؛ توسط Data Manager API استفاده نمی‌شود.
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	بدون معادل	فیلد فراداده؛ توسط 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 باید برای هر رویداد روی شناسه یکتایی تنظیم شود. اگر رویدادها را برای تبدیل‌های چندمنبعی ارسال می‌کنید، الزامی است. برای جزئیات بیشتر، به تبدیل داده‌ها به اشیاء 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	بدون معادل	برای مقصدهای Campaign Manager 360 پشتیبانی نمی‌شود.
addressInfo.state	بدون معادل	برای مقصدهای Campaign Manager 360 پشتیبانی نمی‌شود.
addressInfo.hashedStreetAddress	بدون معادل	برای مقصدهای Campaign Manager 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	الزامی.