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

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

যাচাইকরণ

ডেটা ম্যানেজার API-এর জন্য Campaign Manager 360 API-এর থেকে আলাদা স্কোপ সহ ক্রেডেনশিয়াল প্রয়োজন। ডেটা ম্যানেজার API স্কোপ সহ নতুন ক্রেডেনশিয়াল তৈরি করতে, API অ্যাক্সেস সেট-আপ করুন লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করুন।

অনুরোধ ফিল্ড

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

কনভার্সন ফিল্ড

Conversion (Campaign Manager 360 API) Event (Data Manager API) নোট
floodlightConfigurationId destinations[].operatingAccount.accountId অনুরোধ লেভেলে সংজ্ঞায়িত করা হয়। Floodlight কনফিগারেশন আইডিতে সেট করা আছে।
সমতুল্য কিছু নেই destinations[].operatingAccount.accountType অনুরোধ লেভেলে সংজ্ঞায়িত করা হয়। FLOODLIGHT_CONFIG-এ সেট করা আছে।
floodlightActivityId destinations[].productDestinationId অনুরোধ লেভেলে সংজ্ঞায়িত করা হয়। Floodlight অ্যাক্টিভিটি আইডিতে সেট করা আছে।
kind সমতুল্য কিছু নেই মেটাডেটা ফিল্ড; ডেটা ম্যানেজার API ব্যবহার করে না।
সমতুল্য কিছু নেই destinations[].reference অনুরোধ লেভেলে সংজ্ঞায়িত করা হয়। গন্তব্যের জন্য ব্যবহারকারীর সংজ্ঞায়িত শনাক্তকারী। আপনি একটি অনুরোধে একাধিক গন্তব্যে ইভেন্ট পাঠালে এই ফিল্ড সেট করুন।
adUserDataConsent consent.adUserData আরও বিবরণের জন্য Consent দেখুন।
nonPersonalizedAd consent.adPersonalization আরও বিবরণের জন্য Consent দেখুন।
সমতুল্য কিছু নেই destinationReferences একটি অনুরোধে একাধিক ডেস্টিনেশনে ইভেন্ট পাঠানো হলে, এই ফিল্ডটিকে সংশ্লিষ্ট ডেস্টিনেশনের reference হিসেবে সেট করুন।
timestampMicros eventTimestamp
  • JSON ফর্ম্যাট ব্যবহার করলে, RFC 3339 ফর্ম্যাটে একটি ভ্যালু সেট করুন, যা Campaign Manager 360 API থেকে সামান্য আলাদা, কারণ এটি timestampMicros Unix epoch থেকে মাইক্রোসেকেন্ডে প্রত্যাশিত।
  • প্রোটোকল বাফার ব্যবহার করলে, Timestamp ব্যবহার করুন এবং seconds ও (ঐচ্ছিকভাবে) nanoseconds ফিল্ড সেট করুন।

আরও বিবরণের জন্য টাইমস্ট্যাম্প ফর্ম্যাট দেখুন।
value conversionValue
quantity conversionCount
ordinal সমতুল্য কিছু নেই Campaign Manager 360 API-এর ordinal ফিল্ডটি Data Manager API-তে নেই। এর পরিবর্তে, একই ফ্লাডলাইট অ্যাক্টিভিটি আইডিতে পাঠানো ইভেন্টকে ডুপ্লিকেট করার জন্য Data Manager API transactionId ব্যবহার করে।

Campaign Manager 360 API-তে, আপনি ordinal-এর মান 1-এর মতো কোনও নির্দিষ্ট, ধ্রুবক ভ্যালু সেট করে ইভেন্ট যাতে ডুপ্লিকেট না হয় তা নিশ্চিত করতে পারেন। Data Manager API-তে, transactionId প্রতিটি ইভেন্টের জন্য অনন্য শনাক্তকারী হিসেবে সেট করতে হবে।
সমতুল্য কিছু নেই transactionId ডেটা ম্যানেজার API, ইভেন্টকে ডুপ্লিকেট হওয়া থেকে বাঁচাতে, Floodlight অ্যাক্টিভিটি আইডি ও transactionId-এর কম্বিনেশন ব্যবহার করে। transactionId ফিল্ডে প্রতিটি ইভেন্টের জন্য অনন্য শনাক্তকারী সেট করতে হবে।

একাধিক সোর্স থেকে হওয়া কনভার্সনের জন্য ইভেন্ট পাঠালে প্রয়োজনীয়। আরও বিবরণের জন্য ডেটাকে Event অবজেক্টে কনভার্ট করুন দেখুন।
customVariables customVariables CustomVariable অবজেক্টের তালিকা। ডেটা ম্যানেজার API, এনুমের পরিবর্তে কী হিসেবে স্ট্রিং ব্যবহার করে। 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 সমতুল্য কিছু নেই মেটাডেটা ফিল্ড; ডেটা ম্যানেজার 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 সমতুল্য কিছু নেই মেটাডেটা ফিল্ড; ডেটা ম্যানেজার API ব্যবহার করে না।
merchantId merchantId
merchantFeedLabel merchantFeedLabel
merchantFeedLanguage merchantFeedLanguageCode
items items Item অবজেক্টের তালিকা। আরও বিবরণের জন্য আইটেম ফিল্ড দেখুন।

কার্ট ডেটার জন্য আইটেম ফিল্ড

Item (Campaign Manager 360 API) Item (Data Manager API) নোট
kind সমতুল্য কিছু নেই মেটাডেটা ফিল্ড; ডেটা ম্যানেজার API ব্যবহার করে না।
সমতুল্য কিছু নেই itemId ঐচ্ছিক। আইটেমের জন্য অনন্য শনাক্তকারী।
itemId merchantProductId প্রয়োজনীয়। আইটেমের জন্য Merchant Center প্রোডাক্ট আইডি সেট করা আছে।
quantity quantity প্রয়োজনীয়।
unitPrice unitPrice প্রয়োজনীয়।
পূর্ববর্তী
আপগ্রেড করার ধাপ