একটি ফ্লটার অ্যাপে ডায়নামিক লিঙ্ক তৈরি করুন

আপনি Firebase Dynamic Links Builder API ব্যবহার করে ছোট বা দীর্ঘ Dynamic Links তৈরি করতে পারেন। এই API হয় একটি দীর্ঘ Dynamic Link অথবা Dynamic Link প্যারামিটার ধারণকারী একটি অবজেক্ট গ্রহণ করে এবং নিম্নলিখিত উদাহরণগুলির মতো URL গুলি ফেরত দেয়:

https://example.com/link/WXYZ
https://example.page.link/WXYZ

আপনার অ্যান্ড্রয়েড অ্যাপে ডাইনামিক লিঙ্ক তৈরি করার আগে, আপনাকে অবশ্যই Firebase SDK অন্তর্ভুক্ত করতে হবে। যদি আপনার অ্যাপটি ডাইনামিক লিঙ্ক পাওয়ার জন্য সেট আপ করা থাকে, তাহলে আপনি ইতিমধ্যেই এই পদক্ষেপগুলি সম্পন্ন করেছেন এবং আপনি এই বিভাগটি এড়িয়ে যেতে পারেন।

  1. যদি আপনি ইতিমধ্যেই Flutter-এর জন্য Firebase SDK গুলি ইনস্টল এবং আরম্ভ না করে থাকেন, তাহলে তা শুরু করুন।

  2. আপনার Flutter প্রকল্পের রুট ডিরেক্টরি থেকে, Dynamic Links প্লাগইন ইনস্টল করতে নিম্নলিখিত কমান্ডটি চালান:

    flutter pub add firebase_dynamic_links
    
  3. যদি আপনি একটি অ্যান্ড্রয়েড অ্যাপ তৈরি করেন, তাহলে Firebase কনসোলের প্রজেক্ট সেটিংস পৃষ্ঠাটি খুলুন এবং নিশ্চিত করুন যে আপনি আপনার SHA-1 সাইনিং কী নির্দিষ্ট করেছেন। যদি আপনি অ্যাপ লিঙ্ক ব্যবহার করেন, তাহলে আপনার SHA-256 কীটিও নির্দিষ্ট করুন।

  4. ফায়ারবেস কনসোলে, ডায়নামিক লিংক বিভাগটি খুলুন।

    1. যদি আপনি ইতিমধ্যেই আপনার Dynamic Links এর জন্য একটি ডোমেইন সেট আপ না করে থাকেন, তাহলে Get Started বোতামে ক্লিক করুন এবং প্রম্পটগুলি অনুসরণ করুন।

      যদি আপনার ইতিমধ্যেই একটি Dynamic Links ডোমেইন থাকে, তাহলে এটি মনে রাখবেন। প্রোগ্রাম্যাটিকভাবে Dynamic Links তৈরি করার সময় আপনাকে একটি Dynamic Links ডোমেইন প্রদান করতে হবে।

    2. প্রস্তাবিত : "আরও" (⋮) মেনু থেকে, আপনার ডিপ লিঙ্ক এবং ফলব্যাক লিঙ্কগুলিতে অনুমোদিত URL প্যাটার্নগুলি নির্দিষ্ট করুন। এটি করার মাধ্যমে, আপনি অননুমোদিত পক্ষগুলিকে ডায়নামিক লিঙ্ক তৈরি করতে বাধা দেবেন যা আপনার ডোমেন থেকে আপনার নিয়ন্ত্রণে নেই এমন সাইটগুলিতে পুনঃনির্দেশিত করে।

      নির্দিষ্ট URL প্যাটার্নগুলিকে অনুমতি দিন দেখুন।

একটি Dynamic Link তৈরি করতে, একটি নতুন DynamicLinkParameters অবজেক্ট তৈরি করুন এবং এটি buildLink() অথবা buildShortLink() এ পাস করুন।

নিচের ন্যূনতম উদাহরণটি https://www.example.com/ এ একটি দীর্ঘ ডায়নামিক লিঙ্ক তৈরি করে যা অ্যান্ড্রয়েডে com.example.app.android এবং iOS এ com.example.app.ios অ্যাপ দিয়ে খোলে:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildLink(dynamicLinkParams);

একটি ছোট Dynamic Link তৈরি করতে, DynamicLinkParameters অবজেক্টটি buildShortLink() এ পাস করুন। ছোট লিঙ্ক তৈরি করতে একটি নেটওয়ার্ক কল প্রয়োজন। উদাহরণস্বরূপ:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

ডিফল্টরূপে, ছোট ডায়নামিক লিঙ্কগুলি মাত্র কয়েকটি অক্ষর দীর্ঘ প্রত্যয় দিয়ে তৈরি হয়। যদিও এটি লিঙ্কগুলিকে আরও সংক্ষিপ্ত করে তোলে, এটি এমন সম্ভাবনাও তৈরি করে যে কেউ একটি বৈধ ছোট লিঙ্ক অনুমান করতে পারে। প্রায়শই, কেউ যদি এটি করে তবে কোনও ক্ষতি নেই, কারণ লিঙ্কটি জনসাধারণের তথ্যের দিকে নিয়ে যায়।

তবে, যদি আপনার ছোট লিঙ্কগুলি ব্যবহারকারী-নির্দিষ্ট তথ্যের দিকে পরিচালিত করে, তাহলে আপনার 17-অক্ষরের প্রত্যয় সহ দীর্ঘ লিঙ্ক তৈরি করা উচিত যাতে কেউ একটি বৈধ ডায়নামিক লিঙ্ক অনুমান করতে পারে এমন সম্ভাবনা খুব কম থাকে। এটি করার জন্য, ShortDynamicLinkType.unguessable buildShortLink() পদ্ধতিতে পাস করুন:

final unguessableDynamicLink = await FirebaseDynamicLinks.instance.buildShortLink(
    dynamicLinkParams,
    shortLinkType: ShortDynamicLinkType.unguessable,
);

আপনি যেকোনো সমর্থিত প্যারামিটার ব্যবহার করে ডায়নামিক লিঙ্ক তৈরি করতে ডায়নামিক লিঙ্ক বিল্ডার API ব্যবহার করতে পারেন। API রেফারেন্স দেখুন।

নিম্নলিখিত উদাহরণটি বেশ কয়েকটি সাধারণ প্যারামিটার সেট সহ একটি ডায়নামিক লিঙ্ক তৈরি করে:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(
    packageName: "com.example.app.android",
    minimumVersion: 30,
  ),
  iosParameters: const IOSParameters(
    bundleId: "com.example.app.ios",
    appStoreId: "123456789",
    minimumVersion: "1.0.1",
  ),
  googleAnalyticsParameters: const GoogleAnalyticsParameters(
    source: "twitter",
    medium: "social",
    campaign: "example-promo",
  ),
  socialMetaTagParameters: SocialMetaTagParameters(
    title: "Example of a Dynamic Link",
    imageUrl: Uri.parse("https://example.com/image.png"),
  ),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

আপনি নিম্নলিখিত পদ্ধতিগুলি ব্যবহার করে ডায়নামিক লিঙ্ক প্যারামিটার সেট করতে পারেন:

ডাইনামিকলিঙ্ক প্যারামিটার
সেটলিঙ্ক আপনার অ্যাপটি যে লিঙ্কটি খুলবে। এমন একটি URL নির্দিষ্ট করুন যা আপনার অ্যাপ পরিচালনা করতে পারে, সাধারণত অ্যাপের কন্টেন্ট বা পেলোড, যা অ্যাপ-নির্দিষ্ট লজিক শুরু করে (যেমন ব্যবহারকারীকে কুপন দিয়ে ক্রেডিট করা বা একটি স্বাগত স্ক্রিন প্রদর্শন করা)। এই লিঙ্কটি অবশ্যই একটি ভালভাবে ফর্ম্যাট করা URL হতে হবে, সঠিকভাবে URL-এনকোড করা থাকতে হবে, HTTP বা HTTPS ব্যবহার করতে হবে এবং অন্য কোনও ডায়নামিক লিঙ্ক হতে পারবে না।
সেটডোমেইনইউরিপ্রিফিক্স আপনার Dynamic Link URL প্রিফিক্স, যা আপনি Firebase কনসোলে খুঁজে পেতে পারেন। একটি Dynamic Link ডোমেন নিম্নলিখিত উদাহরণগুলির মতো দেখতে:
https://example.com/link
https://example.page.link
অ্যান্ড্রয়েড প্যারামিটার
সেটফলব্যাকইউআরএল অ্যাপটি ইনস্টল না থাকাকালীন খোলার লিঙ্ক। অ্যাপটি ইনস্টল না থাকাকালীন প্লে স্টোর থেকে আপনার অ্যাপটি ইনস্টল করা ছাড়া অন্য কিছু করার জন্য এটি নির্দিষ্ট করুন, যেমন কন্টেন্টের মোবাইল ওয়েব সংস্করণ খোলা, অথবা আপনার অ্যাপের জন্য একটি প্রচারমূলক পৃষ্ঠা প্রদর্শন করা।
সেট ন্যূনতম সংস্করণ আপনার অ্যাপের ন্যূনতম সংস্করণের সংস্করণ কোড যা লিঙ্কটি খুলতে পারে। যদি ইনস্টল করা অ্যাপটি একটি পুরানো সংস্করণ হয়, তাহলে ব্যবহারকারীকে অ্যাপটি আপগ্রেড করার জন্য প্লে স্টোরে নিয়ে যাওয়া হবে।
আইওএস প্যারামিটার
সেট অ্যাপস্টোরআইডি আপনার অ্যাপের অ্যাপ স্টোর আইডি, যা অ্যাপটি ইনস্টল না থাকাকালীন ব্যবহারকারীদের অ্যাপ স্টোরে পাঠাতে ব্যবহৃত হয়
সেটফলব্যাকইউআরএল অ্যাপটি ইনস্টল না থাকাকালীন খোলার লিঙ্ক। অ্যাপটি ইনস্টল না থাকাকালীন অ্যাপ স্টোর থেকে আপনার অ্যাপটি ইনস্টল করা ছাড়া অন্য কিছু করার জন্য এটি নির্দিষ্ট করুন, যেমন কন্টেন্টের মোবাইল ওয়েব সংস্করণ খোলা, অথবা আপনার অ্যাপের জন্য একটি প্রচারমূলক পৃষ্ঠা প্রদর্শন করা।
কাস্টমস্কিম সেট করুন আপনার অ্যাপের কাস্টম URL স্কিম, যদি আপনার অ্যাপের বান্ডেল আইডি ছাড়া অন্য কিছু হিসেবে সংজ্ঞায়িত করা হয়
সেটআইপ্যাডফলব্যাকইউআরএল অ্যাপটি ইনস্টল না থাকাকালীন iPads-এ খোলার লিঙ্ক। অ্যাপটি ইনস্টল না থাকাকালীন অ্যাপ স্টোর থেকে আপনার অ্যাপটি ইনস্টল করা ছাড়া অন্য কিছু করার জন্য এটি নির্দিষ্ট করুন, যেমন কন্টেন্টের ওয়েব সংস্করণ খোলা, অথবা আপনার অ্যাপের জন্য একটি প্রচারমূলক পৃষ্ঠা প্রদর্শন করা।
সেটআইপ্যাডবান্ডেলআইডি লিঙ্কটি খোলার জন্য iPads-এ ব্যবহার করার জন্য iOS অ্যাপের বান্ডেল আইডি। অ্যাপটি Firebase কনসোলের ওভারভিউ পৃষ্ঠা থেকে আপনার প্রকল্পের সাথে সংযুক্ত থাকতে হবে।
সেট ন্যূনতম সংস্করণ আপনার অ্যাপের ন্যূনতম সংস্করণের সংস্করণ নম্বর যা লিঙ্কটি খুলতে পারে। এই পতাকাটি আপনার অ্যাপটি খোলার সময় পাঠানো হয় এবং আপনার অ্যাপটিকে এটি দিয়ে কী করতে হবে তা নির্ধারণ করতে হবে।
ন্যাভিগেশন তথ্য পরামিতি
setForcedRedirectসক্রিয় যদি '1' তে সেট করা থাকে, তাহলে Dynamic Link খোলার সময় অ্যাপ প্রিভিউ পৃষ্ঠাটি এড়িয়ে যান এবং পরিবর্তে অ্যাপ বা স্টোরে পুনঃনির্দেশিত করুন। অ্যাপ প্রিভিউ পৃষ্ঠা (ডিফল্টরূপে সক্ষম) ব্যবহারকারীদের অ্যাপে Dynamic Links খোলার সময় সবচেয়ে উপযুক্ত গন্তব্যে আরও নির্ভরযোগ্যভাবে পাঠাতে পারে; তবে, যদি আপনি আশা করেন যে Dynamic Link শুধুমাত্র সেই অ্যাপগুলিতে খোলা হবে যেগুলি এই পৃষ্ঠাটি ছাড়াই নির্ভরযোগ্যভাবে Dynamic Links খুলতে পারে, তাহলে আপনি এই প্যারামিটারটি দিয়ে এটি অক্ষম করতে পারেন। এই প্যারামিটারটি শুধুমাত্র iOS-এ Dynamic Link-এর আচরণকে প্রভাবিত করবে।
সোশ্যালমেটাট্যাগপ্যারামিটার
সেটটাইটেল কোনও সোশ্যাল পোস্টে ডায়নামিক লিঙ্ক শেয়ার করার সময় যে শিরোনামটি ব্যবহার করা হবে।
সেট বর্ণনা কোনও সোশ্যাল পোস্টে ডায়নামিক লিঙ্ক শেয়ার করার সময় যে বিবরণটি ব্যবহার করতে হবে।
সেট ইমেজ ইউআরএল এই লিঙ্কের সাথে সম্পর্কিত একটি ছবির URL। ছবিটি কমপক্ষে 300x200 px এবং 300 KB এর কম হতে হবে।
গুগল অ্যানালিটিক্স প্যারামিটার
সেটসোর্স
সেটমিডিয়াম
সেট ক্যাম্পেইন
সেটটার্ম
সেটকন্টেন্ট
গুগল প্লে অ্যানালিটিক্স প্যারামিটার। এই প্যারামিটারগুলি (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`) প্লে স্টোরে পাঠানো হয় এবং লিঙ্ক পেলোডে যুক্ত করা হয়।
আইটিউনসকানেক্টঅ্যানালিটিক্সপ্যারামিটার
সেটপ্রোভাইডারটোকেন
সেটঅ্যাফিলিয়েটটোকেন
সেটক্যাম্পেইনটোকেন
আইটিউনস কানেক্ট অ্যানালিটিক্স প্যারামিটার। এই প্যারামিটারগুলি (`pt`, `at`, `ct`) অ্যাপ স্টোরে পাঠানো হয়।