ফিল্ড ম্যাপিং

টেবিলগুলিতে থাকা ম্যাপিংগুলি ব্যবহার করে Campaign Manager 360 API-এর conversions.batchinsert কে Data Manager API-এর IngestEventsRequest সমতুল্যটির সাথে ম্যাপ করুন।

অনুরোধ ক্ষেত্র

conversions.batchinsert (ক্যাম্পেইন ম্যানেজার 360 API) IngestEventsRequest (ডেটা ম্যানেজার এপিআই) নোট
profileId ইউআরএল পাথ প্যারামিটার কোনো সমতুল্য নেই
kind কোনো সমতুল্য নেই মেটাডেটা ফিল্ড; ডেটা ম্যানেজার এপিআই দ্বারা ব্যবহৃত হয় না।
conversions events আবশ্যক। রূপান্তর বা ইভেন্টের তালিকা। বিস্তারিত জানার জন্য রূপান্তর ক্ষেত্র বিভাগটি দেখুন।
encryptionInfo events.adIdentifiers.encryptedUserIds এ স্থানান্তরিত হয়েছে ইভেন্ট পর্যায়ে সংজ্ঞায়িত। ক্যাম্পেইন ম্যানেজার ৩৬০ এনক্রিপশন তথ্য এখন প্রতিটি এনক্রিপ্টেড ইউজার আইডিতে নির্দিষ্ট করা আছে। কনভার্সন ফিল্ডস বিভাগটি দেখুন।
কোনো সমতুল্য নেই encryptionInfo অনুরোধ-স্তরের encryptionInfo হলো এনক্রিপ্টেড UserData ব্যবহারকারী শনাক্তকারীগুলির জন্য এনক্রিপশন তথ্য। বিস্তারিত জানতে এনক্রিপশন দেখুন।
কোনো সমতুল্য নেই destinations প্রয়োজনীয়। Destination অবজেক্টগুলোর একটি তালিকা, যা ইভেন্টগুলোর জন্য টার্গেট অ্যাকাউন্ট এবং ফ্ল্যাডলাইট অ্যাক্টিভিটি নির্ধারণ করে। বিস্তারিত জানতে ডেস্টিনেশন গাইড দেখুন। কনভার্সন ফিল্ডস সেকশনে দেখানো অনুযায়ী প্রতিটি ফিল্ড ম্যাপ করুন।
কোনো সমতুল্য নেই consent অনুরোধের ইভেন্টগুলির জন্য ঐচ্ছিক ডিফল্ট সম্মতি সেটিংস। আপনি Event এর consent ফিল্ড সেট করে একটি নির্দিষ্ট ইভেন্টের জন্য এই মানটি পরিবর্তন করতে পারেন।
কোনো সমতুল্য নেই encoding ব্যবহারকারী শনাক্তকারী পাঠানোর ক্ষেত্রে আবশ্যক: UserIdentifier ভ্যালুগুলোর জন্য ব্যবহৃত Encoding এ সেট করুন। ব্যবহারকারী শনাক্তকারী ব্যবহার না করলে, এই ফিল্ডটি উপেক্ষা করা হয়।
কোনো সমতুল্য নেই validateOnly যদি সত্য হয়, তাহলে অনুরোধটি যাচাই করা হয়, কিন্তু কার্যকর করা হয় না।

রূপান্তর ক্ষেত্র

Conversion (ক্যাম্পেইন ম্যানেজার 360 এপিআই) Event (ডেটা ম্যানেজার এপিআই) নোট
floodlightConfigurationId destinations[].operatingAccount.accountId অনুরোধ পর্যায়ে সংজ্ঞায়িত। ফ্ল্যাডলাইট কনফিগারেশন আইডিতে সেট করা।
কোনো সমতুল্য নেই destinations[].operatingAccount.accountType অনুরোধ পর্যায়ে সংজ্ঞায়িত। FLOODLIGHT_CONFIG এ সেট করা।
floodlightActivityId destinations[].productDestinationId অনুরোধ পর্যায়ে সংজ্ঞায়িত। ফ্ল্যাডলাইট অ্যাক্টিভিটি আইডি-তে সেট করা হয় (যা পূর্বে ফ্ল্যাডলাইট অ্যাক্টিভিটি আইডি নামে পরিচিত ছিল)।
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 ফিল্ডটি ডেটা ম্যানেজার এপিআই-তে উপস্থিত নেই। এর পরিবর্তে, একই ব্যবহারকারী ও দিনের কনভার্সনগুলো থেকে ডুপ্লিকেট বাদ দেওয়ার প্রক্রিয়া নিয়ন্ত্রণ করতে transactionId ব্যবহার করা যেতে পারে।

ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই-তে, আপনি ordinal 1 মতো একটি নির্দিষ্ট, ধ্রুবক মানে সেট করে ইভেন্টগুলোর ডুপ্লিকেট অপসারণ নিশ্চিত করতে পারেন। ডেটা ম্যানেজার এপিআই-তে, প্রতিটি ইভেন্টের জন্য transactionId অবশ্যই একটি অনন্য শনাক্তকারীতে সেট করতে হবে।
কোনো সমতুল্য নেই transactionId ডেটা ম্যানেজার এপিআই-তে, একই ব্যবহারকারী ও দিনের কনভার্সনগুলো থেকে ডুপ্লিকেটগুলো কীভাবে বাদ দেওয়া হবে, তা নিয়ন্ত্রণ করতে transactionId ব্যবহার করা হয়। প্রতিটি ইভেন্টের জন্য এই ফিল্ডটিকে অবশ্যই একটি অনন্য শনাক্তকারীতে সেট করতে হবে।

ফ্লাডলাইট অফলাইন রূপান্তর পাঠানোর সময় এই ক্ষেত্রটি ঐচ্ছিক। আরও বিস্তারিত জানার জন্য ‘ডেটা Event অবজেক্টে রূপান্তর করুন’ দেখুন।
customVariables customVariables CustomVariable অবজেক্টগুলোর একটি তালিকা। ডেটা ম্যানেজার এপিআই এনামের পরিবর্তে কী (key) হিসেবে স্ট্রিং ব্যবহার করে। 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 বিস্তারিত জানতে ব্যবহারকারী শনাক্তকারী ক্ষেত্রগুলি দেখুন।

ব্যবহারকারী শনাক্তকারী ক্ষেত্র

ডেটা ম্যানেজার এপিআই-তে, ব্যবহারকারীর শনাক্তকারীগুলোকে Event userData ফিল্ডের অধীনে একটি UserData অবজেক্টের মধ্যে দলবদ্ধ করা হয়। এটি ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই থেকে ভিন্ন, যেখানে শনাক্তকারীগুলো সরাসরি Conversion অবজেক্টের সাথে সংযুক্ত থাকে।

UserIdentifier (ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই) 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 (ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই) CartData (ডেটা ম্যানেজার এপিআই) নোট
kind কোনো সমতুল্য নেই মেটাডেটা ফিল্ড; ডেটা ম্যানেজার এপিআই দ্বারা ব্যবহৃত হয় না।
merchantId merchantId
merchantFeedLabel merchantFeedLabel
merchantFeedLanguage merchantFeedLanguageCode
items items Item অবজেক্টগুলোর একটি তালিকা। আরও বিস্তারিত জানতে আইটেম ফিল্ডগুলো দেখুন।

কার্ট ডেটার জন্য আইটেম ক্ষেত্র

Item (ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই) Item (ডেটা ম্যানেজার এপিআই) নোট
kind কোনো সমতুল্য নেই মেটাডেটা ফিল্ড; ডেটা ম্যানেজার এপিআই দ্বারা ব্যবহৃত হয় না।
কোনো সমতুল্য নেই itemId ঐচ্ছিক। আইটেমটির জন্য একটি অনন্য শনাক্তকারী।
itemId merchantProductId আবশ্যক। আইটেমটির জন্য মার্চেন্ট সেন্টার প্রোডাক্ট আইডি -তে সেট করুন।
quantity quantity প্রয়োজনীয়।
unitPrice unitPrice প্রয়োজনীয়।
পূর্ববর্তী
আপগ্রেড করার পদক্ষেপ, আপগ্রেড করার পদক্ষেপ