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

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

যাচাইকরণ

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

অনুরোধের ফিল্ড

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

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

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

মাল্টি-সোর্স কনভার্সনের জন্য ইভেন্ট পাঠালে প্রয়োজন। আরও বিবরণের জন্য ডেটা Event অবজেক্টে কনভার্ট করুন দেখুন।
customVariables customVariables CustomVariableটি অবজেক্টের তালিকা। ডেটা ম্যানেজার API, enum-এর পরিবর্তে স্ট্রিংকে 'কী' হিসেবে ব্যবহার করে। 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 ডেটা ম্যানেজার 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-তে, ব্যবহারকারীর শনাক্তকারীকে Event-এর userData ফিল্ডের অধীনে UserData অবজেক্টের মধ্যে গ্রুপ করা হয়। এটি Campaign Manager 360 API-এর থেকে আলাদা, যেখানে শনাক্তকারী সরাসরি Conversion অবজেক্টের সাথে অ্যাটাচ করা থাকে।

UserIdentifier (Campaign Manager 360 API) UserIdentifier (ডেটা ম্যানেজার 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 (ডেটা ম্যানেজার API) নোট
kind সমতুল্য কিছু নেই মেটাডেটা ফিল্ড; ডেটা ম্যানেজার API-এর মাধ্যমে ব্যবহার করা হয় না।
merchantId merchantId
merchantFeedLabel merchantFeedLabel
merchantFeedLanguage merchantFeedLanguageCode
items items Itemটি অবজেক্টের তালিকা। আরও বিবরণের জন্য আইটেম ফিল্ড দেখুন..

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

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