গ্রাহক তালিকা সংক্রান্ত সমস্যা সমাধান করুন

আপনার কাস্টমার ম্যাচ ইন্টিগ্রেশনে কম ম্যাচ রেট এবং উদ্ভূত সাধারণ ত্রুটিগুলো সমাধান করতে এই নির্দেশিকাটি ব্যবহার করুন।

ম্যাচ রেট যাচাই করুন

আপনার ম্যাচ রেট যাচাই করার চেষ্টা করার আগে নিশ্চিত করুন যে আপনার আপলোড কাজটি সম্পন্ন হয়েছে।

বিভিন্ন কারণে আপনার ম্যাচ রেট প্রত্যাশার চেয়ে কম হতে পারে, যার মধ্যে রয়েছে:

• আপলোড করার আগে ডেটাটি হ্যাশ করা হয়নি।
• হ্যাশ করার আগে ডেটাটি সঠিকভাবে ফরম্যাট করা হয়নি।
• আপনি ভিন্ন একটি সিস্টেমের ম্যাচ রেটের সাথে তুলনা করছেন।
• আপনি একটিমাত্র UserIdentifier অবজেক্টে একাধিক ইউজার আইডেন্টিফায়ার যোগ করার চেষ্টা করছেন। এর পরিবর্তে, এই কোড উদাহরণে দেখানো অনুযায়ী একাধিক UserIdentifier অবজেক্টকে একটিমাত্র UserData অবজেক্টে যোগ করুন।

গুগল সার্চ, জিমেইল বা ইউটিউবে ব্যবহারকারীরা কতটা সক্রিয়, তার উপর ভিত্তি করে একজন বিজ্ঞাপনদাতা তার তালিকার ১% থেকে ৯৯% পর্যন্ত ব্যবহারকারীর কাছে পৌঁছাতে পারেন। কম ম্যাচ রেটের সমস্যা সমাধানের জন্য আরও বিস্তারিত নির্দেশিকার জন্য হেল্প সেন্টার দেখুন।

ম্যাচ রেট এবং তালিকার আকারের মধ্যে পার্থক্য

লিস্ট সাইজ এবং ম্যাচ রেট ভিন্ন ভিন্ন মান নির্দেশ করে। ম্যাচ রেট সেই সমস্ত ব্যবহারকারীকে গণনা করে যাদের একটি গুগল অ্যাকাউন্ট আছে, এমনকি যদি কাস্টমার ম্যাচ লিস্টের মাধ্যমে তাদের কাছে পৌঁছানো সম্ভব নাও হয়। লিস্ট সাইজ সেই সমস্ত সক্রিয় ব্যবহারকারীদের গণনা করে যারা একটি গুগল অ্যাকাউন্টের সাথে মিলেছে এবং যাদের কাছে বিজ্ঞাপন পার্সোনালাইজেশনের মাধ্যমে পৌঁছানো সম্ভব।

সাধারণ ত্রুটিগুলি ডিবাগ করুন

ত্রুটি
USER_PERMISSION_DENIED	অন্য কোনো অ্যাকাউন্ট দ্বারা তৈরি করা তালিকা পরিবর্তন করার চেষ্টা করলে আপনি অনুমতি সংক্রান্ত ত্রুটির সম্মুখীন হতে পারেন। আপনি শুধুমাত্র আপনার নিজের অ্যাকাউন্ট দ্বারা তৈরি করা তালিকাই সম্পাদনা করতে পারবেন।
EXTERNAL_UPDATE_ID_ALREADY_EXISTS	একই external_id ব্যবহার করে একাধিক জব তৈরি করার চেষ্টা করলে এই ত্রুটিটি ঘটতে পারে।
CONFLICTING_OPERATION	একই জবে remove অপারেশনের সাথে create অপারেশন একসাথে করা হলে এই ত্রুটিটি ঘটতে পারে।
TOO_MANY_USER_IDENTIFIERS	একটি একক জবের create অপারেশনগুলিতে মোট ১০০,০০০-এর বেশি user_identifiers রয়েছে। অনুরোধটিকে একাধিক অনুরোধে বিভক্ত করুন যা এই সীমা অতিক্রম করবে না।
CONCURRENT_MODIFICATION	একই সময়ে একই তালিকার উপর কাজ করার চেষ্টা করলে এই ত্রুটি ঘটতে পারে।
RESOURCE_EXHAUSTED	অতিরিক্ত অনুরোধ পাঠানোর চেষ্টা করলে এই ত্রুটি দেখা দিতে পারে। প্রস্তাবিত ব্যবহার পদ্ধতি অনুযায়ী আপনার অপারেশনগুলো ব্যাচিং করার মাধ্যমে আপনি এটি সমাধান করতে পারেন। এছাড়া, এপিআই লিমিট এবং কোটা সংক্রান্ত সেরা অনুশীলন নির্দেশিকাটিও দেখতে পারেন।
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE	এই ত্রুটিটি ঘটে যদি আপনার গুগল ক্লাউড প্রজেক্টে (অথবা লিগ্যাসি ডেভেলপার টোকেন, যা ৯ সেপ্টেম্বর, ২০২৬-এ বাতিল হয়ে যাবে) ১ অক্টোবর, ২০২৫ থেকে ৩১ মার্চ, ২০২৬-এর মধ্যে কোনো কাস্টমার ম্যাচ রিকোয়েস্ট না থাকে। এর পরিবর্তে আপনাকে কাস্টমার ম্যাচ ওয়ার্কফ্লো-এর জন্য ডেটা ম্যানেজার এপিআই ব্যবহার করতে হবে।

অতিরিক্ত সমস্যা সমাধান সহায়তা

এরপরও যদি আপনার কোনো সমস্যা হয়, তাহলে কাস্টমার ম্যাচ ট্রাবলশুটারের মাধ্যমে আমাদের সাথে যোগাযোগ করুন।