গুগল অ্যাডস এপিআই অন্যান্য প্রোডাক্ট অ্যাকাউন্টের সাথে গুগল অ্যাডস অ্যাকাউন্ট লিঙ্ক করা সমর্থন করে। এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে এপিআই ব্যবহার করে আপনার অ্যাকাউন্টগুলি লিঙ্ক করতে হয়।
অ্যাকাউন্ট লিঙ্ক করার উপায়
একটি গুগল অ্যাডস অ্যাকাউন্টকে অন্য একটি প্রোডাক্ট অ্যাকাউন্টের সাথে লিঙ্ক করার ক্ষেত্রে, দুটি ভিন্ন উপায়ে এই সংযোগটি করা যেতে পারে।
আমন্ত্রণ প্রবাহ
ইনভাইটেশন ফ্লো তখন ব্যবহৃত হয় যখন আপনার গুগল অ্যাডস অ্যাকাউন্টে অ্যাডমিনিস্ট্রেটর অ্যাক্সেস থাকে, কিন্তু প্রোডাক্ট অ্যাকাউন্টে থাকে না। এই ফ্লো দুটি পরিস্থিতিতে কাজ করে:
- আপনি দুটি অ্যাকাউন্ট লিঙ্ক করতে এবং প্রোডাক্ট অ্যাকাউন্টের একজন অ্যাডমিনিস্ট্রেটরের জন্য একটি আমন্ত্রণ তৈরি করতে চান। অ্যাকাউন্ট লিঙ্ক করার প্রক্রিয়াটি সম্পন্ন করতে প্রোডাক্ট অ্যাকাউন্টের অ্যাডমিনিস্ট্রেটর আমন্ত্রণটি গ্রহণ করেন।
- প্রোডাক্ট অ্যাকাউন্ট অ্যাডমিনিস্ট্রেটর দুটি অ্যাকাউন্ট লিঙ্ক করতে চান, কিন্তু তার গুগল অ্যাডস অ্যাকাউন্টে অ্যাক্সেস নেই। প্রোডাক্ট অ্যাকাউন্ট অ্যাডমিনিস্ট্রেটর একটি আমন্ত্রণ তৈরি করেন, এবং আপনি আমন্ত্রণটি গ্রহণ করে লিঙ্কিং প্রক্রিয়াটি সম্পন্ন করেন।
এই পরিস্থিতিতে নিম্নলিখিত পদ্ধতিগুলো ব্যবহার করা হয়:
| দৃশ্যকল্প | পদক্ষেপ | মন্তব্য |
|---|---|---|
| দৃশ্যকল্প ১ | একটি আমন্ত্রণ তৈরি করুন | একটি আমন্ত্রণ তৈরি করতে ProductLinkInvitationService.CreateProductLinkInvitation মেথডটি ব্যবহার করুন। ProductLinkInvitation এর status সেট করা উচিত নয়; এপিআই কলটি সফলভাবে সম্পন্ন হলে গুগল অ্যাডস এপিআই সার্ভার এটিকে REQUESTED এ সেট করে দেবে। |
| একটি আমন্ত্রণের অবস্থা যাচাই করুন। | product_link_invitation রিসোর্সটি কোয়েরি করতে এবং এর স্ট্যাটাস পরীক্ষা করতে GoogleAdsService.Search অথবা GoogleAdsService.SearchStream ব্যবহার করুন। | |
| দৃশ্যকল্প ২ | একটি আমন্ত্রণ পুনরুদ্ধার করুন | product_link_invitation রিসোর্সটি কোয়েরি করতে GoogleAdsService.Search অথবা GoogleAdsService.SearchStream ব্যবহার করুন। অপেক্ষাধীন কোনো আমন্ত্রণ গ্রহণ বা প্রত্যাখ্যান করতে status = PENDING_APPROVAL দিয়ে ফিল্টার করুন। |
| আমন্ত্রণ গ্রহণ বা প্রত্যাখ্যান করুন | ProductLinkInvitation এর স্ট্যাটাস ACCEPTED বা REJECTED এ আপডেট করতে ProductLinkInvitationService.UpdateProductLinkInvitation মেথডটি ব্যবহার করুন। | |
| আমন্ত্রণ প্রত্যাহার করুন | বিদ্যমান ProductLinkInvitation বাতিল করতে ProductLinkInvitationService.RemoveProductLinkInvitation মেথডটি ব্যবহার করুন। |
এই ওয়ার্কফ্লোতে নিম্নলিখিত সাধারণ ত্রুটিগুলো দেখা দিতে পারে:
| ত্রুটি কোড | ব্যাখ্যা |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED | গ্রাহকের এই কাজটি করার অনুমতি নেই। |
ProductLinkError.NO_INVITATION_REQUIRED | একটি আমন্ত্রণ তৈরি করা যায়নি, কারণ আমন্ত্রিত অ্যাকাউন্টটিতে ব্যবহারকারীর ইতিমধ্যেই অ্যাডমিনিস্ট্রেটর অ্যাক্সেস রয়েছে। ব্যবহারকারীর সরাসরি একটি সক্রিয় লিঙ্ক তৈরি করার জন্য ProductLinkService ব্যবহার করা উচিত। |
সরাসরি সংযোগ প্রবাহ
ডাইরেক্ট লিঙ্কিং ফ্লো তখন ব্যবহার করা হয় যখন আপনার গুগল অ্যাডস অ্যাকাউন্ট এবং প্রোডাক্ট অ্যাকাউন্ট উভয়টিতেই অ্যাডমিনিস্ট্রেটর অ্যাক্সেস থাকে। এক্ষেত্রে, আপনি আমন্ত্রণ পাঠানোর পরিবর্তে সরাসরি গুগল অ্যাডস অ্যাকাউন্টটিকে প্রোডাক্ট অ্যাকাউন্টের সাথে লিঙ্ক করেন।
এই পরিস্থিতিতে নিম্নলিখিত পদ্ধতিগুলো ব্যবহার করা হয়:
| পদক্ষেপ | মন্তব্য |
|---|---|
| একটি সক্রিয় লিঙ্ক তৈরি করুন | একটি ProductLink তৈরি করতে ProductLinkService.createProductLink ব্যবহার করুন। |
| একটি সক্রিয় লিঙ্ক নিষ্ক্রিয় করুন | একটি সক্রিয় ProductLink অপসারণ করতে ProductLinkService.removeProductLink ব্যবহার করুন। |
| সক্রিয় লিঙ্কগুলি পুনরুদ্ধার করুন | product_link রিসোর্সটি কোয়েরি করতে GoogleAdsService.Search অথবা GoogleAdsService.SearchStream ব্যবহার করুন। |
এই ওয়ার্কফ্লোতে নিম্নলিখিত সাধারণ ত্রুটিগুলি দেখা দিতে পারে:
| ত্রুটি কোড | ব্যাখ্যা |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED | সরাসরি লিঙ্ক ফ্লো ব্যবহার করে একটি অ্যাকাউন্ট লিঙ্ক করার চেষ্টা করা হয়েছিল, কিন্তু অনুমতির অভাবে এটি সমর্থিত নয়। এর পরিবর্তে, ব্যবহারকারীর আমন্ত্রণ ফ্লোটি সম্পন্ন করার জন্য ProductLinkInvitationService ব্যবহার করা উচিত। |
ProductLinkError.INVITATION_EXISTS | একটি অপেক্ষমান আমন্ত্রণ আগে থেকেই বিদ্যমান থাকায় কোনো লিঙ্ক তৈরি করা যাচ্ছে না। |
বিদ্যমান পণ্যের লিঙ্কগুলি পুনরুদ্ধার করুন
আপনি product_link রিসোর্সের বিপরীতে একটি GAQL কোয়েরি ব্যবহার করে আপনার Google Ads অ্যাকাউন্টের সাথে যুক্ত সমস্ত প্রোডাক্ট লিঙ্ক পুনরুদ্ধার করতে পারেন।
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
product_link.type ফিল্ডটি লিঙ্ক করা পণ্য বা পরিষেবার ধরন নির্দেশ করে। type উপর নির্ভর করে, product_link রিসোর্সের মধ্যে থাকা অন্যান্য ফিল্ডগুলো পূরণ হয়ে যাবে, যা লিঙ্কটি সম্পর্কে আরও বিস্তারিত তথ্য প্রদান করবে। উদাহরণস্বরূপ, যদি ধরনটি THIRD_PARTY_APP_ANALYTICS হয়, তাহলে third_party_app_analytics ফিল্ডটিতে অ্যানালিটিক্স প্রদানকারী সম্পর্কে তথ্য থাকবে।
এর মাধ্যমে আপনি আপনার গুগল অ্যাডস অ্যাকাউন্টের সাথে সরাসরি সংযুক্ত বাহ্যিক পরিষেবা এবং অ্যাপ্লিকেশনগুলির একটি তালিকা পেতে পারেন, যেমন গুগল প্লে, ডেটা পার্টনার বা তৃতীয় পক্ষের অ্যাপ অ্যানালিটিক্স প্ল্যাটফর্ম।
AccountLinkService এ পরিবর্তন
যদি আপনি একটি গুগল অ্যাডস অ্যাকাউন্টকে অন্য কোনো প্রোডাক্ট অ্যাকাউন্টের সাথে লিঙ্ক করতে AccountLinkService ব্যবহার করেন, তাহলে আপনাকে অবশ্যই আপনার বিদ্যমান অ্যাপ্লিকেশনটিকে পূর্বে তালিকাভুক্ত ওয়ার্কফ্লোগুলোর মধ্যে একটিতে মাইগ্রেট করতে হবে। নিম্নলিখিত লিঙ্ক টাইপগুলোর জন্য, AccountLinkService থেকে সরে এসে ProductLinkService ব্যবহার করুন:
-
GoogleAdsIdentifier -
MerchantCenterIdentifier -
AdvertisingPartnerIdentifier
ThirdPartyAppAnalyticsLinkIdentifier এর জন্য AccountLinkService ব্যবহার করা চালিয়ে যান।