از نگاشتهای موجود در جداول برای نگاشت conversions.batchinsert در API مربوط به Campaign Manager 360 به معادل آن در IngestEventsRequest در API مربوط به Data Manager استفاده کنید.
فیلدهای درخواست
conversions.batchinsert (API مدیر کمپین ۳۶۰) | IngestEventsRequest (رابط برنامهنویسی کاربردی مدیریت داده) | یادداشتها |
|---|---|---|
پارامتر مسیر URL profileId | معادلی وجود ندارد | |
kind | معادلی وجود ندارد | فیلد فراداده؛ توسط رابط برنامهنویسی کاربردی مدیریت داده استفاده نمیشود. |
conversions | events | الزامی. فهرست تبدیلها یا رویدادها. برای جزئیات بیشتر به بخش فیلدهای تبدیل مراجعه کنید. |
encryptionInfo | به events.adIdentifiers.encryptedUserIds منتقل شد | در سطح رویداد تعریف شده است. اطلاعات رمزگذاری Campaign Manager 360 اکنون در هر شناسه کاربری رمزگذاری شده مشخص شده است. به بخش فیلدهای تبدیل مراجعه کنید. |
| معادلی وجود ندارد | encryptionInfo | encryptionInfo سطح درخواست (request-level encryptionInfo) اطلاعات رمزگذاری برای شناسههای کاربر UserData رمزگذاری شده است. برای جزئیات بیشتر به رمزگذاری مراجعه کنید. |
| معادلی وجود ندارد | destinations | الزامی. فهرستی از اشیاء Destination که حساب هدف و فعالیت Floodlight را برای رویدادها تعریف میکنند. برای جزئیات بیشتر به راهنمای Destinations مراجعه کنید. فیلدهای جداگانه را همانطور که در بخش فیلدهای تبدیل نشان داده شده است، نگاشت کنید. |
| معادلی وجود ندارد | consent | تنظیمات رضایت پیشفرض اختیاری برای رویدادهای موجود در درخواست. میتوانید با تنظیم فیلد consent Event ، این مقدار را برای یک رویداد خاص لغو کنید. |
| معادلی وجود ندارد | encoding | در صورت ارسال شناسههای کاربر الزامی است: روی Encoding مورد استفاده برای مقادیر UserIdentifier تنظیم شود. در صورت عدم استفاده از شناسههای کاربر، این فیلد نادیده گرفته میشود. |
| معادلی وجود ندارد | validateOnly | اگر درست باشد، درخواست اعتبارسنجی میشود، اما اجرا نمیشود. |
فیلدهای تبدیل
Conversion (API مدیر کمپین ۳۶۰) | Event (رابط برنامهنویسی کاربردی مدیریت داده) | یادداشتها |
|---|---|---|
floodlightConfigurationId | destinations[].operatingAccount.accountId | در سطح درخواست تعریف شده است. روی شناسه پیکربندی Floodlight تنظیم شده است. |
| معادلی وجود ندارد | destinations[].operatingAccount.accountType | در سطح درخواست تعریف شده است. روی FLOODLIGHT_CONFIG تنظیم شده است. |
floodlightActivityId | destinations[].productDestinationId | در سطح درخواست تعریف میشود. روی شناسه فعالیت Floodlight (که قبلاً با نام شناسه فعالیت Floodlight شناخته میشد) تنظیم شود. |
kind | معادلی وجود ندارد | فیلد فراداده؛ توسط رابط برنامهنویسی کاربردی مدیریت داده استفاده نمیشود. |
| معادلی وجود ندارد | destinations[].reference | در سطح درخواست تعریف میشود. یک شناسه تعریفشده توسط کاربر برای مقصد. اگر رویدادها را به چندین مقصد در یک درخواست واحد ارسال میکنید، این فیلد را تنظیم کنید. |
adUserDataConsent | consent.adUserData | برای جزئیات بیشتر به Consent مراجعه کنید. |
nonPersonalizedAd | consent.adPersonalization | برای جزئیات بیشتر به Consent مراجعه کنید. |
| معادلی وجود ندارد | destinationReferences | اگر رویدادها را در یک درخواست واحد به چندین مقصد ارسال میکنید ، این فیلد را روی reference مربوطه به مقصد تنظیم کنید. |
timestampMicros | eventTimestamp |
برای جزئیات بیشتر به قالب مهر زمانی مراجعه کنید. |
value | conversionValue | |
quantity | conversionCount | |
ordinal | معادلی وجود ندارد | فیلد ordinal از API مربوط به Campaign Manager 360 در API مربوط به Data Manager وجود ندارد. در عوض، میتوان از transactionId برای کنترل نحوهی حذف تبدیلها از یک کاربر و یک روز استفاده کرد.در API مربوط به Campaign Manager 360، میتوانید با تنظیم مقدار ثابتی مانند 1 برای متغیر ordinal ، از حذف دادههای تکراری در رویدادها اطمینان حاصل کنید. در API مربوط به Data Manager، باید برای هر رویداد، transactionId روی یک شناسه منحصر به فرد تنظیم کنید. |
| معادلی وجود ندارد | transactionId | در رابط برنامهنویسی کاربردی مدیریت داده (Data Manager API)، از transactionId برای کنترل چگونگی حذف دادههای تکراری از تبدیلهای یک کاربر و یک روز استفاده میشود. این فیلد باید برای هر رویداد روی یک شناسه منحصر به فرد تنظیم شود.این فیلد هنگام ارسال تبدیلهای آفلاین Floodlight اختیاری است. برای جزئیات بیشتر به بخش تبدیل دادهها به اشیاء Event مراجعه کنید. |
customVariables | customVariables | فهرستی از اشیاء CustomVariable . رابط برنامهنویسی کاربردی مدیریت داده (Data Manager API) به جای enums از رشتهها به عنوان کلید استفاده میکند. برای فیلد 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 | رابط برنامهنویسی کاربردی مدیریت داده از چندین شناسه کاربری رمزگذاریشده پشتیبانی میکند. برای جزئیات بیشتر به 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 (API مدیر کمپین ۳۶۰) | UserIdentifier (رابط برنامهنویسی کاربردی مدیریت داده) | یادداشتها |
|---|---|---|
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 | معادلی وجود ندارد | در نسخه فعلی رابط برنامهنویسی کاربردی مدیریت داده پشتیبانی نمیشود. |
addressInfo.state | معادلی وجود ندارد | در نسخه فعلی رابط برنامهنویسی کاربردی مدیریت داده پشتیبانی نمیشود. |
addressInfo.hashedStreetAddress | معادلی وجود ندارد | در نسخه فعلی رابط برنامهنویسی کاربردی مدیریت داده پشتیبانی نمیشود. |
فیلدهای داده سبد خرید
CartData (API مدیر کمپین ۳۶۰) | CartData (رابط برنامهنویسی کاربردی مدیریت داده) | یادداشتها |
|---|---|---|
kind | معادلی وجود ندارد | فیلد فراداده؛ توسط رابط برنامهنویسی کاربردی مدیریت داده استفاده نمیشود. |
merchantId | merchantId | |
merchantFeedLabel | merchantFeedLabel | |
merchantFeedLanguage | merchantFeedLanguageCode | |
items | items | فهرستی از اشیاء Item . برای جزئیات بیشتر به فیلدهای آیتم مراجعه کنید. |
فیلدهای کالا برای دادههای سبد خرید
Item (API مدیر کمپین ۳۶۰) | Item (API مدیریت داده) | یادداشتها |
|---|---|---|
kind | معادلی وجود ندارد | فیلد فراداده؛ توسط رابط برنامهنویسی کاربردی مدیریت داده استفاده نمیشود. |
| معادلی وجود ندارد | itemId | اختیاری. یک شناسه منحصر به فرد برای کالا. |
itemId | merchantProductId | الزامی. شناسه محصول مرکز فروشندگان را برای کالا تنظیم کنید. |
quantity | quantity | الزامی است. |
unitPrice | unitPrice | الزامی است. |