মেটা বিজ্ঞাপন ইন্টিগ্রেশন

ডেভেলপারের সহায়তা প্রয়োজন

ইন্টিগ্রেশন সেট আপ করার জন্য আপনার ডেভেলপমেন্ট টিমের সাহায্যের প্রয়োজন হবে। অনুগ্রহ করে এই গাইডটি তাদের সাথে শেয়ার করুন।

মেটা বিজ্ঞাপন ইন্টিগ্রেশন আপনাকে Pushwoosh অডিয়েন্সকে আপনার মেটা বিজ্ঞাপন অ্যাকাউন্টের সাথে সিঙ্ক করতে দেয়। বিজ্ঞাপন প্রচারাভিযানে ব্যবহারকারীদের টার্গেট বা বাদ দিতে এবং আপনার কাস্টমার জার্নিতে পেইড বিজ্ঞাপনকে আরেকটি চ্যানেল হিসেবে যুক্ত করতে এটি ব্যবহার করুন।

ব্যবহারের ক্ষেত্র

এই ইন্টিগ্রেশনটি ব্যবহার করুন:

• কেনাকাটা বা এনগেজমেন্ট বাড়ানোর জন্য একাধিক চ্যানেলে উচ্চ-মূল্যের ব্যবহারকারীদের টার্গেট করতে
• যারা অন্য চ্যানেলে কম প্রতিক্রিয়াশীল, তাদের রি-টার্গেট করতে
• সাপ্রেশন অডিয়েন্স তৈরি করতে যাতে বিশ্বস্ত গ্রাহকরা অপ্রয়োজনীয় বিজ্ঞাপন না পান

পূর্বশর্ত

মেটা বিজ্ঞাপন সংযোগ করার আগে, নিশ্চিত করুন:

• আপনার Pushwoosh অ্যাকাউন্টে অ্যাডমিন ভূমিকা আছে। ভূমিকা এবং অনুমতি কীভাবে কাজ করে তা জানতে ব্যবহারকারীর অ্যাক্সেস এবং অনুমতি পরিচালনা করুন দেখুন।
• আপনার ব্র্যান্ডের ফেসবুক অ্যাসেট, যেমন বিজ্ঞাপন অ্যাকাউন্ট, পেজ এবং অ্যাপ পরিচালনা করার জন্য একটি ফেসবুক বিজনেস ম্যানেজার সেট আপ করা আছে।
• আপনার বিজনেস ম্যানেজারের সাথে সংযুক্ত একটি সক্রিয় ফেসবুক বিজ্ঞাপন অ্যাকাউন্ট আছে।
• আপনার ফেসবুক বিজনেস ম্যানেজার অ্যাডমিন আপনাকে Pushwoosh-এর সাথে ব্যবহার করার পরিকল্পনা করা বিজ্ঞাপন অ্যাকাউন্টগুলির জন্য ক্যাম্পেইন পরিচালনা বা বিজ্ঞাপন অ্যাকাউন্ট পরিচালনা করার অনুমতি দিয়েছে।
• আপনি সেই অ্যাকাউন্টগুলির জন্য বিজ্ঞাপন অ্যাকাউন্টের শর্তাবলী গ্রহণ করেছেন।
• আপনি Pushwoosh-এর সাথে ব্যবহার করার পরিকল্পনা করা ফেসবুক বিজ্ঞাপন অ্যাকাউন্টগুলির জন্য ফেসবুকের কাস্টম অডিয়েন্সের শর্তাবলী গ্রহণ করেছেন।

Pushwoosh-এ মেটা বিজ্ঞাপন সেট আপ করুন

1. Pushwoosh-এ, Settings > 3rd party integrations-এ যান।

2. মেটা বিজ্ঞাপন কার্ডে, Login page-এ ক্লিক করুন।

3. আপনার মেটা অ্যাকাউন্টে সাইন ইন করুন, তারপর Continue-এ ক্লিক করুন।

4. আপনি যে বিজ্ঞাপন অ্যাকাউন্টগুলি সংযোগ করতে চান তা নির্বাচন করুন।

5. বিজ্ঞাপন অ্যাকাউন্ট এবং ব্যবসার অ্যাক্সেসের জন্য অনুরোধ করা অনুমতিগুলি পর্যালোচনা করুন।

6. Save-এ ক্লিক করুন। এরপর মেটা একটি নিশ্চিতকরণ দেখাবে যে আপনার অ্যাকাউন্ট সংযুক্ত হয়েছে।

সংযোগের স্থিতি পর্যালোচনা করুন

সেটআপের পরে, আপনাকে Pushwoosh-এর Meta Ads পেজে রিডাইরেক্ট করা হবে।

বিজ্ঞাপন অ্যাকাউন্টের টেবিলে প্রতিটি সংযুক্ত অ্যাকাউন্টের তালিকা থাকে:

• বিজ্ঞাপন অ্যাকাউন্টের নাম
• বিজনেস অ্যাকাউন্ট
• আইডি

একটি সারির শেষে তিনটি ডটে ক্লিক করুন এবং Pushwoosh-এর তালিকা থেকে সেই বিজ্ঞাপন অ্যাকাউন্টটি মুছে ফেলতে Remove ad account বেছে নিন।

সংযুক্ত বিজ্ঞাপন অ্যাকাউন্ট পরিচালনা করুন

Meta Ads পেজে, ডায়ালগ খুলতে Manage accounts-এ ক্লিক করুন। ইন্টিগ্রেশন থেকে সেই বিজ্ঞাপন অ্যাকাউন্টটি অন্তর্ভুক্ত বা বাদ দিতে প্রতিটি সারিতে টগল ব্যবহার করুন। পরিবর্তনগুলি সংরক্ষণ করতে Apply-এ ক্লিক করুন বা সংরক্ষণ না করে বন্ধ করতে Cancel-এ ক্লিক করুন।

তালিকার ভিউ সামঞ্জস্য করতে:

• কোন সারিগুলি প্রদর্শিত হবে তা সীমিত করতে Show only connected চালু বা বন্ধ করুন।
• তালিকায় অ্যাকাউন্টগুলি খুঁজে পেতে Search by name or id…-তে টাইপ করুন।

মেটা ফিল্ডে প্রজেক্ট ট্যাগ ম্যাপ করুন

ব্যবহারকারীর বৈশিষ্ট্য ম্যাপ করা আপনাকে Pushwoosh-কে বলতে দেয় যে কোন মেটা ব্যবহারকারীর অ্যাট্রিবিউটগুলি আপনার প্রজেক্টের কোন ট্যাগ নাম ফিল্ড আপডেট করবে। এইভাবে, যখন মেটা থেকে ডেটা আসে, তখন তা আপনার প্রত্যাশিত জায়গায় সংরক্ষিত হয়।

নোট

অডিয়েন্স সিঙ্কের জন্য, Pushwoosh সবসময় ইমেল, ফোন নম্বর, বা MADID থেকে প্রতি ব্যবহারকারীর জন্য একটি শনাক্তকারী পাঠায়, প্রোফাইলে যা বিদ্যমান থাকে তার উপর নির্ভর করে। যখন আপনি চান যে মেটা উপরের শনাক্তকারীগুলির বাইরে অতিরিক্ত ব্যবহারকারীর অ্যাট্রিবিউট গ্রহণ করুক, তখন ম্যাপিং কনফিগার করুন।

1. Meta Ads পেজে, Map user data-এ ক্লিক করুন।

2. বাম কলামের প্রতিটি Facebook field-এর জন্য, ডানদিকের কন্ট্রোল থেকে আপনার প্রজেক্টের একটি Tag name বেছে নিন। শুধুমাত্র আপনার প্রয়োজনীয় সারিগুলি ম্যাপ করুন।

স্বয়ংক্রিয়ভাবে ম্যাপ করা ফিল্ড

Pushwoosh এই ফিল্ডগুলি স্বয়ংক্রিয়ভাবে ম্যাপ করে। আপনি এগুলি Map project tags to Meta fields-এ সেট করবেন না:

• ইমেল
• ফোন নম্বর
• MADID

3. ম্যাপিং প্রয়োগ করতে Save-এ ক্লিক করুন বা সংরক্ষণ না করে বন্ধ করতে Cancel-এ ক্লিক করুন।

SDK-তে MADID সংগ্রহ সক্ষম করুন

মেটা বিজ্ঞাপন মোবাইল SDK-এর মাধ্যমে সংগৃহীত ডিভাইস শনাক্তকারী (MADID) ব্যবহার করে ব্যবহারকারীদের ম্যাচ করে। Pushwoosh SDK স্বয়ংক্রিয়ভাবে বিজ্ঞাপনের শনাক্তকারী (অ্যান্ড্রয়েডে GAID, iOS-এ IDFA) সংগ্রহ করে না। উভয় প্ল্যাটফর্মেই শনাক্তকারী পড়ার আগে ব্যবহারকারীর সুস্পষ্ট সম্মতি প্রয়োজন। আপনার অ্যাপ্লিকেশনে, ব্যবহারকারীর সম্মতি অনুরোধ করুন, অনুমতি পেলে শনাক্তকারী পড়ুন এবং মানটি SDK-তে পাস করুন।

Android

1. ডিপেন্ডেন্সি যোগ করুন

implementation 'com.google.android.gms:play-services-ads-identifier:...'

2. AD_ID অনুমতি ঘোষণা করুন (targetSdk ≥ 33 এর জন্য প্রয়োজন)

এটি আপনার AndroidManifest.xml-এ যোগ করুন:

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

সতর্কতা

অ্যান্ড্রয়েড ১৩+ এ এই অনুমতি ছাড়া, AdvertisingIdClient.getAdvertisingIdInfo() নিঃশব্দে একটি শূন্য UUID (00000000-0000-0000-0000-000000000000) ফেরত দেয়। Pushwoosh SDK এটিকে null-এ স্বাভাবিক করে, তাই সার্ভারে কোনো MADID পাঠানো হয় না এবং মেটা অডিয়েন্স ম্যাচিং কাজ করবে না।

3. GAID পুনরুদ্ধার করুন এবং এটি SDK-তে পাস করুন

getAdvertisingIdInfo একটি ব্যাকগ্রাউন্ড থ্রেডে কল করতে হবে:

String gaid = AdvertisingIdClient.getAdvertisingIdInfo(context).getId();

Pushwoosh.getInstance().setAdvertisingId(gaid);

ব্যাকএন্ডে সংরক্ষিত মান সাফ করতে, null বা একটি খালি স্ট্রিং পাস করুন:

Pushwoosh.getInstance().setAdvertisingId(null);

আচরণের নোট:

• যদি শেষ সফল কলের পর থেকে মান পরিবর্তন না হয়, তবে কোনো নেটওয়ার্ক অনুরোধ করা হয় না।
• যদি নেটওয়ার্ক অনুরোধ ব্যর্থ হয়, পরবর্তী অ্যাপ লঞ্চে আবার চেষ্টা করুন।
• যখন Pushwoosh.stopCommunication() সক্রিয় থাকে তখন কলটি উপেক্ষা করা হয়।
• শূন্য UUID (00000000-0000-0000-0000-000000000000) null-এর মতোই বিবেচিত হয় — ব্যাকএন্ডে সংরক্ষিত MADID সাফ করা হয়।

iOS

1. Info.plist-এ ব্যবহারের বিবরণ যোগ করুন

ATT অনুমতি ডায়ালগ দেখানোর আগে Apple-এর এই কী প্রয়োজন:

<key>NSUserTrackingUsageDescription</key>
<string>We use your advertising identifier to show you relevant ads.</string>

2. আপনার প্রাইভেসি ম্যানিফেস্টে ট্র্যাকিং ডোমেন ঘোষণা করুন

যদি আপনার অ্যাপ ট্র্যাকিংয়ের জন্য IDFA ব্যবহার করে, Apple-এর প্রয়োজন যে আপনি আপনার প্রাইভেসি ম্যানিফেস্টে (PrivacyInfo.xcprivacy) ট্র্যাকিং ডেটা গ্রহণকারী ডোমেনগুলির তালিকা করুন। সম্পূর্ণ প্রয়োজনীয়তার জন্য TN3182 দেখুন।

NSPrivacyTracking-কে true-তে সেট করুন এবং Pushwoosh ট্র্যাকিং ডোমেনটি NSPrivacyTrackingDomains-এ যোগ করুন:

<key>NSPrivacyTracking</key>
<true/>
<key>NSPrivacyTrackingDomains</key>
<array>
    <string>tracking.svc-nue.pushwoosh.com</string>
</array>

নোট

যদি ব্যবহারকারী ATT অনুমতি না দেয়, iOS NSPrivacyTrackingDomains-এ তালিকাভুক্ত সমস্ত ডোমেনে নেটওয়ার্ক অনুরোধ ব্লক করে। আপনার কোড যাই করুক না কেন, MADID পাঠানো হবে না।

3. ট্র্যাকিং অনুমোদনের অনুরোধ করুন এবং IDFA SDK-তে পাস করুন

ATTrackingManager-এর জন্য iOS 14 বা তার পরবর্তী সংস্করণ প্রয়োজন। যদি আপনার ডেপ্লয়মেন্ট টার্গেট iOS 14-এর নিচে হয়, তবে কলটি একটি অ্যাভেইলেবিলিটি চেকে র‍্যাপ করুন।

Pushwoosh SDK ATTrackingManager কল করে না। আপনার অ্যাপ্লিকেশনে ট্র্যাকিং অনুমোদনের অনুরোধ করুন, তারপর ফলাফলটি SDK-তে পাস করুন:

import AppTrackingTransparency
import AdSupport

if #available(iOS 14, *) {
    ATTrackingManager.requestTrackingAuthorization { status in
        let idfa = status == .authorized
            ? ASIdentifierManager.shared().advertisingIdentifier.uuidString
            : nil
        Pushwoosh.configure.setAdvertisingId(idfa)
    }
}

ব্যাকএন্ডে সংরক্ষিত মান সাফ করতে, nil বা একটি খালি স্ট্রিং পাস করুন:

Pushwoosh.configure.setAdvertisingId(nil)

আচরণের নোট:

• যদি শেষ সফল কলের পর থেকে মান পরিবর্তন না হয়, তবে কোনো নেটওয়ার্ক অনুরোধ করা হয় না।
• যদি নেটওয়ার্ক অনুরোধ ব্যর্থ হয়, পরবর্তী অ্যাপ লঞ্চে আবার setAdvertisingId কল করুন।
• যখন Pushwoosh_ALLOW_SERVER_COMMUNICATION নিষ্ক্রিয় থাকে তখন কলটি উপেক্ষা করা হয়।
• শূন্য UUID (00000000-0000-0000-0000-000000000000) nil বা একটি খালি স্ট্রিংয়ের মতোই বিবেচিত হয় — ব্যাকএন্ডে সংরক্ষিত MADID সাফ করা হয়।

আপনার অ্যাপের প্রধান UI ফ্লো থেকে requestTrackingAuthorization কল করুন। Apple সুপারিশ করে যে এটি লঞ্চের সাথে সাথে না করে, আপনার নিজের ব্যাখ্যামূলক স্ক্রিন দেখানোর পরে করা উচিত।

এটি কিভাবে কাজ করে

একবার আপনি setAdvertisingId কল করলে, SDK মানটি Pushwoosh ট্র্যাকিং এন্ডপয়েন্টে madid ফিল্ড হিসেবে অ্যাপ কোড এবং ডিভাইস হার্ডওয়্যার আইডির সাথে পাঠায়। Pushwoosh এই শনাক্তকারীটি ব্যবহার করে আপনার ডিভাইস রেকর্ডগুলিকে সিঙ্ক্রোনাইজেশনের জন্য মেটা বিজ্ঞাপন অডিয়েন্সের সাথে ম্যাচ করে।

জার্নিতে অডিয়েন্স সিঙ্ক করুন

Journey Builder-এর Audience sync পয়েন্ট আপনার জার্নিকে একটি মেটা কাস্টম অডিয়েন্সের সাথে লিঙ্ক করে। প্রতিবার যখন একজন ব্যবহারকারী সেই পয়েন্টে পৌঁছায়, Pushwoosh মেটাকে অনুরোধ করে যে তাকে অডিয়েন্সে যোগ করা হোক বা সেখান থেকে সরিয়ে দেওয়া হোক।

উদাহরণস্বরূপ, আপনি এটি ব্যবহার করতে পারেন এমন ব্যবহারকারীদের একটি ওয়েবিনার বিজ্ঞাপন দেখানো বন্ধ করতে যারা ইতিমধ্যে নিবন্ধন করেছেন, যাতে আপনি এমন লোকদের উপর বিজ্ঞাপনের ব্যয় নষ্ট না করেন যাদের আর এটি দেখার প্রয়োজন নেই।

অডিয়েন্স সিঙ্ক কনফিগার করতে:

1. Journey Builder খুলুন।

2. একটি Audience-based entry যোগ করুন। Audience source-এ, একটি Pushwoosh সেগমেন্ট বা তালিকা বেছে নিন যা নির্ধারণ করে কে এই জার্নিতে প্রবেশ করবে। উদাহরণস্বরূপ, একটি সেগমেন্ট webinar_registered ট্যাগ true-তে সেট করা ব্যবহারকারী। শুধুমাত্র সেই ব্যবহারকারীরা জার্নির মধ্য দিয়ে যাবে এবং Audience sync-এ পৌঁছাবে।

3. Audience sync পয়েন্ট যোগ করুন।

4. How to sync users info to Meta audience-এর অধীনে, একটি বিকল্প বেছে নিন:

   • Add users to audience। এই ধাপে পৌঁছানো প্রতিটি ব্যবহারকারীকে আপনার নির্বাচিত মেটা অডিয়েন্সে যোগ করে। উদাহরণস্বরূপ, এটি ব্যবহার করুন এমন ব্যবহারকারীদের একটি বিজ্ঞাপন দেখানো শুরু করতে যারা সাইন আপ করেছেন কিন্তু এখনও অংশগ্রহণ করেননি।
   • Remove users from audience। এই ধাপে পৌঁছানো প্রতিটি ব্যবহারকারীকে সেই মেটা অডিয়েন্স থেকে সরিয়ে দেয়। এই উদাহরণে, যারা ইতিমধ্যে নিবন্ধন করেছেন তাদের ওয়েবিনার বিজ্ঞাপন দেখানো বন্ধ করতে এই বিকল্পটি নির্বাচন করুন।

5. Meta Ads account-এ, সংযুক্ত বিজ্ঞাপন অ্যাকাউন্টটি নির্বাচন করুন।

6. Audience-এ, মেটা অডিয়েন্স নির্বাচন করুন, উদাহরণস্বরূপ Webinar।

7. পয়েন্টটি সংরক্ষণ করতে Apply-এ ক্লিক করুন বা সংরক্ষণ না করে বন্ধ করতে Cancel-এ ক্লিক করুন।

8. জার্নি কনফিগার করা শেষ করুন, তারপর এটি চালু করুন।

যখন সেই ব্যবহারকারীরা Audience sync-এ পৌঁছায়, তখন তাদের মেটাতে Webinar অডিয়েন্স থেকে সরিয়ে দেওয়া হয়, তাই তারা আর সেখানে ওয়েবিনার বিজ্ঞাপন দেখে না।

আচরণ এবং ত্রুটি হ্যান্ডলিং

জার্নি প্রক্রিয়াকরণ মেটা অ্যাকাউন্ট এবং অডিয়েন্সের প্রাপ্যতার উপর নির্ভর করে:

• মেটা অডিয়েন্স তখনই আপডেট করে যখন এটি Pushwoosh-এর দেওয়া ডেটা থেকে ব্যবহারকারীকে ম্যাচ করতে পারে। যদি মেটা ব্যবহারকারীকে ম্যাচ করতে না পারে, তবে সেই ব্যবহারকারীর জন্য অডিয়েন্স পরিবর্তন হয় না, এবং তারা জার্নিতে চলতে থাকে।
• যদি একটি প্রোফাইল Audience sync পয়েন্টে পৌঁছায় যখন সংযুক্ত বিজ্ঞাপন অ্যাকাউন্টটি সংযোগ বিচ্ছিন্ন থাকে, তবে সেই প্রোফাইলের জন্য জার্নি থেমে যায় এবং Pushwoosh সিস্টেম এবং ইমেল বিজ্ঞপ্তি পাঠায়।
• যদি একটি নির্বাচিত অডিয়েন্স মেটাতে পাওয়া না যায় এবং API একটি ত্রুটি ফেরত দেয়, তবে সেই প্রোফাইলের জন্য জার্নি থেমে যায় এবং Pushwoosh সিস্টেম এবং ইমেল বিজ্ঞপ্তি পাঠায়।

অডিয়েন্স সিঙ্ক পরিসংখ্যান

লঞ্চের পরে, Audience sync ধাপের জন্য পরিসংখ্যান খুলুন যাতে এন্ট্রি ভলিউম, যোগ এবং অপসারণ, এবং স্কিপ করা প্রোফাইলগুলি দেখা যায়। মেট্রিক বিবরণের জন্য, কাস্টমার জার্নি পরিসংখ্যান-এ অডিয়েন্স সিঙ্ক দেখুন।