# Google BigQuery ইন্টিগ্রেশন
[Google BigQuery](https://cloud.google.com/bigquery) ইন্টিগ্রেশন নির্বাচিত Pushwoosh মেসেজ ইভেন্টগুলিকে আপনার BigQuery ডেটাসেটে স্ট্রিম করে। এটি ব্যবহার করে BigQuery-তে পুশ, ইমেল এবং SMS লাইফসাইকেল ইভেন্ট বিশ্লেষণ করুন, কাস্টম রিপোর্ট তৈরি করুন, অথবা ডেটা আপনার ডাউনস্ট্রিম অ্যানালিটিক্স ওয়ার্কফ্লোর সাথে সংযুক্ত করুন।
## ইন্টিগ্রেশনের সংক্ষিপ্ত বিবরণ
### পূর্বশর্ত
ইন্টিগ্রেশন সেটআপ খোলার আগে নিম্নলিখিতগুলি প্রস্তুত করুন।
1. বিলিং সক্ষম করা একটি Google Cloud প্রজেক্ট ব্যবহার করুন। ফ্রি ট্রায়াল ক্রেডিট সমর্থিত। BigQuery স্যান্ডবক্স যথেষ্ট নয় কারণ Storage Write API-এর জন্য বিলিং প্রয়োজন।
2. নিশ্চিত করুন যে আপনার একটি পেইড Pushwoosh অ্যাকাউন্ট আছে।
### মূল্য নির্ধারণ
BigQuery ব্যবহারের জন্য আপনি সরাসরি Google-কে অর্থ প্রদান করেন। Pushwoosh ইন্টিগ্রেশনের জন্য কোনো চার্জ করে না।
বর্তমান রেট, ফ্রি টিয়ার এবং আঞ্চলিক বিবরণের জন্য, দেখুন [BigQuery pricing](https://cloud.google.com/bigquery/pricing)।
খরচের মধ্যে অন্তর্ভুক্ত থাকতে পারে:
- **ডেটা ইনজেশন:** Pushwoosh, BigQuery Storage Write API দিয়ে ইভেন্ট স্ট্রিম করে।
- **স্টোরেজ:** BigQuery আপনার ডেস্টিনেশন টেবিলে লেখা সারিগুলো সংরক্ষণ করে।
- **কোয়েরি:** BigQuery আপনার নির্বাচিত প্রাইসিং মডেলের উপর ভিত্তি করে কোয়েরির জন্য চার্জ করে।
### ইন্টিগ্রেশনের ধরন
**উৎস:** Pushwoosh থেকে আপনার BigQuery ডেটাসেটে ডেটা পাঠানো হয়।
### সমর্থিত প্ল্যাটফর্ম
Pushwoosh iOS, Android, Huawei, Chrome, Safari, Firefox, এবং Web প্ল্যাটফর্ম থেকে ইভেন্ট স্ট্রিম করে।
### সিঙ্ক্রোনাইজড এন্টিটি
নির্বাচিত পুশ, ইমেল এবং SMS লাইফসাইকেল ইভেন্টগুলি BigQuery-তে স্ট্রিম করা হয়। Pushwoosh প্রতিটি নির্বাচিত ইভেন্টের জন্য ডেস্টিনেশন টেবিলে একটি করে সারি লেখে।
### ব্যবহারের ক্ষেত্র
* **প্রায় রিয়েল-টাইম মেসেজ অ্যানালিটিক্স:** Pushwoosh-এ প্রসেস হওয়ার কিছুক্ষণ পরেই BigQuery-তে পুশ, ইমেল এবং SMS লাইফসাইকেল ইভেন্ট বিশ্লেষণ করুন।
* **কাস্টম রিপোর্টিং:** নির্বাচিত ইভেন্টের ধরন, অ্যাপ্লিকেশন, ক্যাম্পেইন এবং মেসেজ আইডেন্টিফায়ারের জন্য BigQuery রিপোর্ট তৈরি করুন।
* **ডাউনস্ট্রিম ডেটা ওয়ার্কফ্লো:** Pushwoosh ইভেন্ট ডেটা আপনার অ্যানালিটিক্স, রিপোর্টিং বা ডেটা প্রসেসিং ওয়ার্কফ্লোর সাথে সংযুক্ত করুন।
### ইন্টিগ্রেশনটি কীভাবে কাজ করে
আপনি কনফিগারেশন সেভ করার পরে, Pushwoosh প্রায় রিয়েল-টাইমে নির্বাচিত মেসেজ ইভেন্টগুলি আপনার BigQuery টেবিলে স্ট্রিম করা শুরু করে।
Pushwoosh-এর মাধ্যমে প্রবাহিত প্রতিটি মেসেজ ইভেন্টের জন্য, সিস্টেমটি পরীক্ষা করে যে আপনার কনফিগারেশনে ইভেন্টের ধরনটি নির্বাচিত কিনা।
যদি তা হয়, Pushwoosh আপনার ডেস্টিনেশন টেবিলে একটি নতুন সারি যুক্ত করে। যদি টেবিলটি এখনও বিদ্যমান না থাকে, Pushwoosh নীচে বর্ণিত স্কিমা ব্যবহার করে এটি স্বয়ংক্রিয়ভাবে তৈরি করে।
Pushwoosh-এ প্রসেস হওয়ার ৩০ সেকেন্ডের মধ্যে ইভেন্টগুলি সাধারণত BigQuery-তে প্রদর্শিত হয়।
## Google Cloud-এ ইন্টিগ্রেশন সেট আপ করুন
### একটি Google Cloud প্রজেক্ট বেছে নিন
[Google Cloud Console](https://console.cloud.google.com)-এ সাইন ইন করুন, তারপর যে প্রজেক্টটি BigQuery ডেটাসেটের মালিক হবে সেটি বেছে নিন বা তৈরি করুন।
### প্রয়োজনীয় API গুলি সক্ষম করুন
Google Cloud Console-এ, **APIs & Services** → **Library**-তে যান এবং এই API গুলি সক্ষম করুন:
- **BigQuery API**
- **BigQuery Storage API**
Pushwoosh এই API গুলি ব্যবহার করে ডেস্টিনেশন টেবিল তৈরি করে এবং BigQuery-তে ইভেন্ট স্ট্রিম করে।
### একটি সার্ভিস অ্যাকাউন্ট তৈরি করুন
Pushwoosh আপনার BigQuery ডেটাসেটে ইভেন্ট লেখার জন্য সার্ভিস অ্যাকাউন্ট ব্যবহার করে।
1. **IAM & Admin** → **Service Accounts**-এ যান।
2. **Create service account**-এ ক্লিক করুন।
3. **Service account name**-এ একটি নাম লিখুন, যেমন, `pushwoosh-bigquery`।
Google Cloud নাম থেকে স্বয়ংক্রিয়ভাবে **Service account ID** তৈরি করে।
4. **Create and continue**-এ ক্লিক করুন।
### IAM ভূমিকা প্রদান করুন
1. সার্ভিস অ্যাকাউন্টকে এই IAM ভূমিকাগুলি প্রদান করুন:
- **BigQuery Data Editor:** Pushwoosh-কে টেবিল তৈরি করতে এবং সারি যুক্ত করতে দেয়।
- **BigQuery User:** Pushwoosh-কে Storage Write API ব্যবহার করতে দেয়।
2. **Continue**-তে ক্লিক করুন।
3. **Done**-এ ক্লিক করুন।
### একটি JSON কী তৈরি করুন
Pushwoosh সার্ভিস অ্যাকাউন্ট হিসাবে প্রমাণীকরণের জন্য JSON কী ব্যবহার করে।
1. আপনার তৈরি করা সার্ভিস অ্যাকাউন্টটি খুলুন।
2. **Keys** → **Add key** → **Create new key**-তে যান।
3. **JSON** নির্বাচন করুন।
Google Cloud আপনার কম্পিউটারে JSON কী ফাইলটি ডাউনলোড করে।
### একটি ডেটাসেট তৈরি করুন
ডেটাসেট হল যেখানে Pushwoosh স্ট্রিম করা ইভেন্ট টেবিল সংরক্ষণ করে।
1. Google Cloud Console-এ, **BigQuery** খুলুন।
2. **Explorer**-এ, ইন্টিগ্রেশনের জন্য প্রস্তুত করা প্রজেক্টটি নির্বাচন করুন।
3. **Create dataset**-এ ক্লিক করুন।
4. **Dataset ID**-তে একটি ডেটাসেট আইডি লিখুন, যেমন `pushwoosh_data`।
5. **Data location**-এ, ডেটাসেট অঞ্চলটি নির্বাচন করুন।
6. **Create dataset**-এ ক্লিক করুন।
## Pushwoosh-এ ইন্টিগ্রেশন কনফিগার করুন
1. আপনার Pushwoosh অ্যাকাউন্টে, যে অ্যাপ্লিকেশনটি আপনি সংযোগ করতে চান তার জন্য **Settings** → **3rd Party Integrations**-এ যান।
2. উপলব্ধ পরিষেবাগুলির তালিকায় **Google BigQuery** খুঁজুন এবং **Configure**-এ ক্লিক করুন।
3. কনফিগারেশন ক্ষেত্রগুলি পূরণ করুন।
- **GCP Project ID:** Google Cloud থেকে প্রজেক্ট আইডি লিখুন, যেমন `my-company-12345`।
- **Service Account JSON:** Google Cloud থেকে ডাউনলোড করা JSON কী ফাইলের সম্পূর্ণ বিষয়বস্তু পেস্ট করুন।
- **Dataset ID:** একবার **GCP Project ID** এবং **Service Account JSON** পূরণ হয়ে গেলে, Pushwoosh আপনার সার্ভিস অ্যাকাউন্টের অ্যাক্সেসযোগ্য ডেটাসেটগুলি নিয়ে আসে। ডেস্টিনেশন ডেটাসেটটি নির্বাচন করুন। যদি ড্রপডাউনটি খালি থাকে, তবে পরীক্ষা করুন যে সার্ভিস অ্যাকাউন্টের অ্যাক্সেস আছে এবং ডেটাসেটটি আপনার নির্দিষ্ট করা প্রজেক্টে বিদ্যমান আছে।
- **Dataset region:** আপনার BigQuery ডেটাসেটের অঞ্চলটি নির্বাচন করুন।
- **Table name:** ডিফল্ট `pushwoosh_events` টেবিল ব্যবহার করতে খালি রাখুন। Pushwoosh নীচে বর্ণিত স্কিমা সহ টেবিলটি তৈরি করে।
- **Events:** আপনি যে ইভেন্টগুলি স্ট্রিম করতে চান তা নির্বাচন করুন। আপনি পরে এই তালিকাটি পরিবর্তন করতে পারেন।
- **Stream events to BigQuery:** এই টগলটি সক্ষম করুন। কনফিগারেশন ডিলিট না করে স্ট্রিমিং পজ করতে এটি বন্ধ করুন।
4. **Test connection**-এ ক্লিক করুন।
Pushwoosh ডেটা না লিখে BigQuery-এর বিরুদ্ধে ক্রেডেনশিয়াল যাচাই করে।
আপনি এই সংযোগ স্ট্যাটাসগুলির মধ্যে একটি দেখতে পারেন:
- **Connection successful:** ক্রেডেনশিয়াল কাজ করছে এবং সার্ভিস অ্যাকাউন্ট ডেটাসেট অ্যাক্সেস করতে পারে।
- `auth_failed`: JSON কী অবৈধ বা বাতিল করা হয়েছে।
- `dataset_not_found`: ডেটাসেট আইডি ভুল অথবা সার্ভিস অ্যাকাউন্ট এটি অ্যাক্সেস করতে পারছে না।
- `missing_permission`: সার্ভিস অ্যাকাউন্টে প্রয়োজনীয় ভূমিকাগুলির মধ্যে একটি অনুপস্থিত।
5. **Apply**-এ ক্লিক করুন।
Pushwoosh কনফিগারেশন সেভ করে এবং প্রায় ৩০ সেকেন্ডের মধ্যে এটি ব্যবহার করা শুরু করে। এর পরে, নির্বাচিত ইভেন্টগুলি BigQuery-তে স্ট্রিম করা শুরু হয়।
## ইন্টিগ্রেশন যাচাই করুন
1. একটি টেস্ট পুশ পাঠান, অথবা অন্য কোনো মেসেজ ট্রিগার করুন যা আপনার নির্বাচিত ইভেন্টের ধরনের মধ্যে একটি তৈরি করে।
2. প্রায় ৩০ সেকেন্ড অপেক্ষা করুন।
3. [BigQuery Studio](https://console.cloud.google.com/bigquery) খুলুন।
4. আপনার প্রজেক্টে যান, তারপর আপনার কনফিগার করা ডেটাসেট এবং ডেস্টিনেশন টেবিলটি খুলুন। যদি আপনি **Table name** খালি রেখে থাকেন, তাহলে `pushwoosh_events` খুলুন।
5. **Preview**-তে ক্লিক করুন।
আপনার টেবিলে ইভেন্ট সারিটি দেখতে পাওয়া উচিত।
### টেবিল স্কিমা
Pushwoosh প্রতিটি নির্বাচিত ইভেন্টকে ডেস্টিনেশন টেবিলে একটি পৃথক সারি হিসাবে লেখে। কোয়েরি দ্রুত এবং ফিল্টার করা সহজ করার জন্য, টেবিলটি `timestamp` ব্যবহার করে দিন অনুযায়ী পার্টিশন করা হয় এবং `app_id` ও `event_kind` দ্বারা ক্লাস্টার করা হয়।
| Field name | Type | Description |
| :---- | :---- | :---- |
| `event_kind` | `STRING` | Pushwoosh ইভেন্টের ধরন, যেমন `Push Sent` বা `Email Opened`। |
| `message_id` | `STRING` | Pushwoosh মেসেজ কোড, যেমন ক্যাম্পেইন বা মেসেজ আইডেন্টিফায়ার। |
| `device_id` | `STRING` | ইভেন্ট তৈরি করা ডিভাইসের Pushwoosh হার্ডওয়্যার আইডি। |
| `user_id` | `STRING` | আপনার এক্সটার্নাল ইউজার আইডি যদি জানা থাকে। বেনামী ডিভাইসের জন্য খালি। |
| `timestamp` | `TIMESTAMP` | UTC-তে ইভেন্টের সময়। |
| `app_id` | `STRING` | Pushwoosh অ্যাপ্লিকেশন কোড। |
| `platform` | `STRING` | উৎস প্ল্যাটফর্ম, যেমন `ios`, `android`, বা `web`। |
| `properties` | `JSON` | অতিরিক্ত ইভেন্ট ক্ষেত্র। ক্ষেত্রগুলি কোয়েরি করতে `JSON_VALUE` ব্যবহার করুন, যেমন নীচে দেখানো হয়েছে। |
### কোয়েরি প্রোপার্টি
`properties` কলামটি JSON হিসাবে অতিরিক্ত ইভেন্ট ক্ষেত্র সংরক্ষণ করে। আপনার কোয়েরিতে পৃথক ক্ষেত্রগুলি এক্সট্র্যাক্ট করতে `JSON_VALUE` ব্যবহার করুন।
উদাহরণস্বরূপ, গত ৭ দিনে কোন ক্যাম্পেইনগুলি সবচেয়ে বেশি ওপেন এনেছে তা দেখতে, একটি নতুন কোয়েরি তৈরি করতে **+**-এ ক্লিক করুন, নীচের SQL পেস্ট করুন এবং **Run**-এ ক্লিক করুন।
```sql
SELECT
event_kind,
JSON_VALUE(properties, '$.campaign_id') AS campaign_id,
COUNT(*) AS events
FROM `your-project.your_dataset.pushwoosh_events`
WHERE event_kind = 'Push Opened'
AND timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
GROUP BY 1, 2
ORDER BY events DESC
```
গত ঘণ্টার ইভেন্ট সংখ্যা পর্যালোচনা করতে, এই কোয়েরিটি চালান:
```sql
SELECT
event_kind,
COUNT(*) AS events
FROM `your-project.your_dataset.pushwoosh_events`
WHERE timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 HOUR)
GROUP BY event_kind
ORDER BY events DESC
```
## ইন্টিগ্রেশন আপডেট করুন
### সার্ভিস অ্যাকাউন্ট কী রোটেট করুন
1. Google Cloud Console-এ, **IAM & Admin** → **Service Accounts**-এ যান।
2. আপনার সার্ভিস অ্যাকাউন্টটি খুলুন।
3. **Keys**-এ যান এবং একটি নতুন JSON কী তৈরি করুন।
4. নতুন কী কাজ করছে তা নিশ্চিত না হওয়া পর্যন্ত পুরানো কী সক্রিয় রাখুন।
5. Pushwoosh-এ, **Google BigQuery** কনফিগারেশন মোডালটি খুলুন।
6. নতুন JSON-টি **Service Account JSON**-এ পেস্ট করুন।
7. **Apply**-এ ক্লিক করুন।
Pushwoosh নতুন কী যাচাই করে, সংরক্ষিত ক্রেডেনশিয়াল প্রতিস্থাপন করে এবং পরবর্তী কনফিগারেশন রিলোডের পরে এটি ব্যবহার করা শুরু করে, যা প্রায় ৩০ সেকেন্ড সময় নেয়।
ইভেন্টগুলি এখনও প্রবাহিত হচ্ছে তা নিশ্চিত করার পরে, Google Cloud Console-এ পুরানো কী মুছে ফেলুন।
### ডেস্টিনেশন ডেটাসেট বা টেবিল পরিবর্তন করুন
1. Pushwoosh-এ, **Settings** → **3rd Party Integrations**-এ যান।
2. **Google BigQuery** সেটিংস খুলুন।
3. একটি ভিন্ন ডেটাসেট নির্বাচন করুন বা একটি নতুন টেবিলের নাম লিখুন।
4. **Apply**-এ ক্লিক করুন।
Pushwoosh প্রায় ৩০ সেকেন্ডের মধ্যে নতুন ডেস্টিনেশন সহ স্ট্রিমটি পুনরায় খোলে। ইতিমধ্যে লেখা সারিগুলি পুরানো টেবিলে থেকে যায়। Pushwoosh ঐতিহাসিক ডেটা ব্যাকফিল করে না।
অন্যান্য সেটিংস আপডেট করার সময় সংরক্ষিত সার্ভিস অ্যাকাউন্ট কী অপরিবর্তিত রাখতে, **Apply**-তে ক্লিক করার আগে **Service Account JSON** খালি রাখুন।
## ট্রাবলশুটিং
| Issue | What to check |
| :---- | :---- |
| **`auth_failed` সহ টেস্ট কানেকশন ব্যর্থ হলে** | সার্ভিস অ্যাকাউন্ট JSON ভুলভাবে ফর্ম্যাট করা হয়েছে বা Google Cloud-এ কী বাতিল করা হয়েছে। একটি নতুন কী তৈরি করুন এবং সম্পূর্ণ JSON ফাইলটি আবার পেস্ট করুন। ফাইলটি `{` দিয়ে শুরু হয়, `}` দিয়ে শেষ হয় এবং একটি `private_key` ব্লক ধারণ করে। |
| **`dataset_not_found` সহ টেস্ট কানেকশন ব্যর্থ হলে** | **Dataset ID** ভুলভাবে লেখা হয়েছে বা আপনার নির্দিষ্ট করা প্রজেক্টে বিদ্যমান নেই। ডেটাসেট আইডি কেস-সেনসিটিভ। টাইপো এড়াতে ড্রপডাউন থেকে ডেটাসেটটি নির্বাচন করুন। |
| **`missing_permission` সহ টেস্ট কানেকশন ব্যর্থ হলে** | সার্ভিস অ্যাকাউন্টে **BigQuery Data Editor** বা **BigQuery User** অনুপস্থিত। উভয় ভূমিকা প্রজেক্ট লেভেলে প্রদান করুন, অথবা আরও সীমাবদ্ধ অ্যাক্সেসের জন্য ডেটাসেট লেভেলে প্রদান করুন। |
| **টেস্ট কানেকশন পাস হলেও BigQuery-তে কোনো সারি দেখা না গেলে** | কমপক্ষে ৩০ সেকেন্ড অপেক্ষা করুন। পরীক্ষা করুন যে আপনি যে ইভেন্টের ধরন পাঠাচ্ছেন তা **Events**-এ নির্বাচিত আছে। উদাহরণস্বরূপ, যদি শুধুমাত্র **Push Opened** নির্বাচিত থাকে এবং কেউ পুশ না খোলে, তাহলে কোনো সারি দেখা যাবে না। |
| **কনফিগারেশন সঠিক দেখালেও মোডাল খালি ক্ষেত্র দেখালে** | পৃষ্ঠাটি রিলোড করুন। প্রতিটি মোডাল খোলার সময় কনফিগারেশন আনা হয় এবং অন্তর্নিহিত পরিষেবা দ্বারা ৩০ সেকেন্ডের জন্য ক্যাশে করা হয়। যদি আপনি এইমাত্র সেটিংস সেভ করে থাকেন, তাহলে কিছুক্ষণ অপেক্ষা করে আবার মোডালটি খুলুন। |
## FAQ
##### আমি কি একটি ফ্রি Google Cloud অ্যাকাউন্ট ব্যবহার করতে পারি?
হ্যাঁ, যতক্ষণ পর্যন্ত প্রজেক্টে বিলিং সক্ষম থাকে। ফ্রি ট্রায়াল ক্রেডিটগুলি সম্পূর্ণ ট্রায়াল সময়ের জন্য সাধারণ ভলিউমে এই ইন্টিগ্রেশন চালানোর জন্য যথেষ্ট। বিলিং ছাড়া BigQuery স্যান্ডবক্স কাজ করবে না কারণ Storage Write API-এর জন্য বিলিং প্রয়োজন।
##### Pushwoosh কি আমার BigQuery ডেটা দেখতে পায়?
না। আপনি যে সার্ভিস অ্যাকাউন্ট ক্রেডেনশিয়াল আপলোড করেন তা Pushwoosh-কে আপনার নির্বাচিত ডেটাসেটে লেখার অনুমতি দেয়। Pushwoosh আপনার ডেটাসেট থেকে পড়ে না এবং আপনার প্রজেক্টের বাকি অংশে কোনো অ্যাক্সেস নেই।
##### আমি কি একাধিক BigQuery ডেটাসেটে এক্সপোর্ট করতে পারি?
প্রতি অ্যাপ্লিকেশনে একটি ডেস্টিনেশন সমর্থিত। যদি আপনার দুটি ডেটাসেটে একই ইভেন্টের প্রয়োজন হয়, তাহলে আপনার প্রজেক্টে একটি BigQuery নির্ধারিত কোয়েরি সেট আপ করুন যাতে `pushwoosh_events` থেকে অন্য টেবিলে ডেটা কপি করা যায়।
##### আমি কি টেবিল স্কিমা পরিবর্তন করতে পারি?
স্কিমা সমস্ত গ্রাহকদের জন্য স্থির। যদি আপনার অতিরিক্ত কলামের প্রয়োজন হয়, তাহলে আপনার নিজের ভিউ বা নির্ধারিত কোয়েরিতে `properties` JSON থেকে সেগুলি এক্সট্র্যাক্ট করুন।
##### আমি যদি সাময়িকভাবে ইন্টিগ্রেশনটি নিষ্ক্রিয় করি তাহলে কী হবে?
**Stream events to BigQuery** বন্ধ করুন এবং **Apply**-তে ক্লিক করুন। Pushwoosh প্রায় ৩০ সেকেন্ডের মধ্যে এই অ্যাপ্লিকেশনের জন্য ইভেন্ট যুক্ত করা বন্ধ করে দেবে।
ইন্টিগ্রেশন বন্ধ থাকাকালীন উৎপাদিত ইভেন্টগুলি বাফার করা বা ব্যাকফিল করা হয় না যখন আপনি এটি আবার চালু করেন। Pushwoosh ক্রেডেনশিয়াল, ডেটাসেট এবং ইভেন্ট নির্বাচন সহ কনফিগারেশনটি রাখে।
##### আমি কীভাবে ইন্টিগ্রেশনটি সম্পূর্ণরূপে মুছে ফেলব?
ইন্টিগ্রেশন কনফিগারেশন মুছে ফেলতে [support@pushwoosh.com](mailto:support@pushwoosh.com)-এ যোগাযোগ করুন। ডেটাসেট এবং BigQuery-তে ইতিমধ্যে লেখা সারিগুলি আপনার Google Cloud অ্যাকাউন্টে থেকে যাবে।
##### কোনো ডেলিভারি গ্যারান্টি আছে কি?
ইন্টিগ্রেশনটি অ্যাট-লিস্ট-ওয়ান্স ডেলিভারি ব্যবহার করে। স্বাভাবিক অপারেশনে, ডুপ্লিকেট বিরল। একটি অ্যাপেন্ড এবং একটি কমিটের মধ্যে একটি প্রসেস রিস্টার্ট অল্প সংখ্যক ডুপ্লিকেট সারি তৈরি করতে পারে। যদি আপনার ডাউনস্ট্রিম পাইপলাইনের জন্য এক্সাক্টলি-ওয়ান্স ফলাফলের প্রয়োজন হয় তাহলে SQL-এ ডিডুপ্লিকেট করুন।
##### কেন কোনো Push Clicked ইভেন্ট নেই?
Pushwoosh বর্তমানে এই ইন্টিগ্রেশনে পুশ নোটিফিকেশনের জন্য **Push Sent**, **Push Delivered**, এবং **Push Opened** প্রকাশ করে। একটি ডেডিকেটেড পুশ ক্লিক স্টেপ উপলব্ধ নেই। ইমেল এবং SMS-এর নিজস্ব লাইফসাইকেল ইভেন্ট রয়েছে।
### প্রয়োজনীয় API গুলি সক্ষম করুন
Google Cloud Console-এ, **APIs & Services** → **Library**-তে যান এবং এই API গুলি সক্ষম করুন:
- **BigQuery API**
- **BigQuery Storage API**
Pushwoosh এই API গুলি ব্যবহার করে ডেস্টিনেশন টেবিল তৈরি করে এবং BigQuery-তে ইভেন্ট স্ট্রিম করে।
### একটি সার্ভিস অ্যাকাউন্ট তৈরি করুন
Pushwoosh আপনার BigQuery ডেটাসেটে ইভেন্ট লেখার জন্য সার্ভিস অ্যাকাউন্ট ব্যবহার করে।
1. **IAM & Admin** → **Service Accounts**-এ যান।
2. **Create service account**-এ ক্লিক করুন।
3. **Service account name**-এ একটি নাম লিখুন, যেমন, `pushwoosh-bigquery`।
Google Cloud নাম থেকে স্বয়ংক্রিয়ভাবে **Service account ID** তৈরি করে।
4. **Create and continue**-এ ক্লিক করুন।
### IAM ভূমিকা প্রদান করুন
1. সার্ভিস অ্যাকাউন্টকে এই IAM ভূমিকাগুলি প্রদান করুন:
- **BigQuery Data Editor:** Pushwoosh-কে টেবিল তৈরি করতে এবং সারি যুক্ত করতে দেয়।
- **BigQuery User:** Pushwoosh-কে Storage Write API ব্যবহার করতে দেয়।
2. **Continue**-তে ক্লিক করুন।
3. **Done**-এ ক্লিক করুন।
### একটি JSON কী তৈরি করুন
Pushwoosh সার্ভিস অ্যাকাউন্ট হিসাবে প্রমাণীকরণের জন্য JSON কী ব্যবহার করে।
1. আপনার তৈরি করা সার্ভিস অ্যাকাউন্টটি খুলুন।
2. **Keys** → **Add key** → **Create new key**-তে যান।
3. **JSON** নির্বাচন করুন।
Google Cloud আপনার কম্পিউটারে JSON কী ফাইলটি ডাউনলোড করে।
### একটি ডেটাসেট তৈরি করুন
ডেটাসেট হল যেখানে Pushwoosh স্ট্রিম করা ইভেন্ট টেবিল সংরক্ষণ করে।
1. Google Cloud Console-এ, **BigQuery** খুলুন।
2. **Explorer**-এ, ইন্টিগ্রেশনের জন্য প্রস্তুত করা প্রজেক্টটি নির্বাচন করুন।
3. **Create dataset**-এ ক্লিক করুন।
4. **Dataset ID**-তে একটি ডেটাসেট আইডি লিখুন, যেমন `pushwoosh_data`।
5. **Data location**-এ, ডেটাসেট অঞ্চলটি নির্বাচন করুন।
6. **Create dataset**-এ ক্লিক করুন।
## Pushwoosh-এ ইন্টিগ্রেশন কনফিগার করুন
1. আপনার Pushwoosh অ্যাকাউন্টে, যে অ্যাপ্লিকেশনটি আপনি সংযোগ করতে চান তার জন্য **Settings** → **3rd Party Integrations**-এ যান।
2. উপলব্ধ পরিষেবাগুলির তালিকায় **Google BigQuery** খুঁজুন এবং **Configure**-এ ক্লিক করুন।
3. কনফিগারেশন ক্ষেত্রগুলি পূরণ করুন।
- **GCP Project ID:** Google Cloud থেকে প্রজেক্ট আইডি লিখুন, যেমন `my-company-12345`।
- **Service Account JSON:** Google Cloud থেকে ডাউনলোড করা JSON কী ফাইলের সম্পূর্ণ বিষয়বস্তু পেস্ট করুন।
- **Dataset ID:** একবার **GCP Project ID** এবং **Service Account JSON** পূরণ হয়ে গেলে, Pushwoosh আপনার সার্ভিস অ্যাকাউন্টের অ্যাক্সেসযোগ্য ডেটাসেটগুলি নিয়ে আসে। ডেস্টিনেশন ডেটাসেটটি নির্বাচন করুন। যদি ড্রপডাউনটি খালি থাকে, তবে পরীক্ষা করুন যে সার্ভিস অ্যাকাউন্টের অ্যাক্সেস আছে এবং ডেটাসেটটি আপনার নির্দিষ্ট করা প্রজেক্টে বিদ্যমান আছে।
- **Dataset region:** আপনার BigQuery ডেটাসেটের অঞ্চলটি নির্বাচন করুন।
- **Table name:** ডিফল্ট `pushwoosh_events` টেবিল ব্যবহার করতে খালি রাখুন। Pushwoosh নীচে বর্ণিত স্কিমা সহ টেবিলটি তৈরি করে।
- **Events:** আপনি যে ইভেন্টগুলি স্ট্রিম করতে চান তা নির্বাচন করুন। আপনি পরে এই তালিকাটি পরিবর্তন করতে পারেন।
- **Stream events to BigQuery:** এই টগলটি সক্ষম করুন। কনফিগারেশন ডিলিট না করে স্ট্রিমিং পজ করতে এটি বন্ধ করুন।
4. **Test connection**-এ ক্লিক করুন।
Pushwoosh ডেটা না লিখে BigQuery-এর বিরুদ্ধে ক্রেডেনশিয়াল যাচাই করে।
আপনি এই সংযোগ স্ট্যাটাসগুলির মধ্যে একটি দেখতে পারেন:
- **Connection successful:** ক্রেডেনশিয়াল কাজ করছে এবং সার্ভিস অ্যাকাউন্ট ডেটাসেট অ্যাক্সেস করতে পারে।
- `auth_failed`: JSON কী অবৈধ বা বাতিল করা হয়েছে।
- `dataset_not_found`: ডেটাসেট আইডি ভুল অথবা সার্ভিস অ্যাকাউন্ট এটি অ্যাক্সেস করতে পারছে না।
- `missing_permission`: সার্ভিস অ্যাকাউন্টে প্রয়োজনীয় ভূমিকাগুলির মধ্যে একটি অনুপস্থিত।
5. **Apply**-এ ক্লিক করুন।
Pushwoosh কনফিগারেশন সেভ করে এবং প্রায় ৩০ সেকেন্ডের মধ্যে এটি ব্যবহার করা শুরু করে। এর পরে, নির্বাচিত ইভেন্টগুলি BigQuery-তে স্ট্রিম করা শুরু হয়।
## ইন্টিগ্রেশন যাচাই করুন
1. একটি টেস্ট পুশ পাঠান, অথবা অন্য কোনো মেসেজ ট্রিগার করুন যা আপনার নির্বাচিত ইভেন্টের ধরনের মধ্যে একটি তৈরি করে।
2. প্রায় ৩০ সেকেন্ড অপেক্ষা করুন।
3. [BigQuery Studio](https://console.cloud.google.com/bigquery) খুলুন।
4. আপনার প্রজেক্টে যান, তারপর আপনার কনফিগার করা ডেটাসেট এবং ডেস্টিনেশন টেবিলটি খুলুন। যদি আপনি **Table name** খালি রেখে থাকেন, তাহলে `pushwoosh_events` খুলুন।
5. **Preview**-তে ক্লিক করুন।
আপনার টেবিলে ইভেন্ট সারিটি দেখতে পাওয়া উচিত।
### টেবিল স্কিমা
Pushwoosh প্রতিটি নির্বাচিত ইভেন্টকে ডেস্টিনেশন টেবিলে একটি পৃথক সারি হিসাবে লেখে। কোয়েরি দ্রুত এবং ফিল্টার করা সহজ করার জন্য, টেবিলটি `timestamp` ব্যবহার করে দিন অনুযায়ী পার্টিশন করা হয় এবং `app_id` ও `event_kind` দ্বারা ক্লাস্টার করা হয়।
| Field name | Type | Description |
| :---- | :---- | :---- |
| `event_kind` | `STRING` | Pushwoosh ইভেন্টের ধরন, যেমন `Push Sent` বা `Email Opened`। |
| `message_id` | `STRING` | Pushwoosh মেসেজ কোড, যেমন ক্যাম্পেইন বা মেসেজ আইডেন্টিফায়ার। |
| `device_id` | `STRING` | ইভেন্ট তৈরি করা ডিভাইসের Pushwoosh হার্ডওয়্যার আইডি। |
| `user_id` | `STRING` | আপনার এক্সটার্নাল ইউজার আইডি যদি জানা থাকে। বেনামী ডিভাইসের জন্য খালি। |
| `timestamp` | `TIMESTAMP` | UTC-তে ইভেন্টের সময়। |
| `app_id` | `STRING` | Pushwoosh অ্যাপ্লিকেশন কোড। |
| `platform` | `STRING` | উৎস প্ল্যাটফর্ম, যেমন `ios`, `android`, বা `web`। |
| `properties` | `JSON` | অতিরিক্ত ইভেন্ট ক্ষেত্র। ক্ষেত্রগুলি কোয়েরি করতে `JSON_VALUE` ব্যবহার করুন, যেমন নীচে দেখানো হয়েছে। |
### কোয়েরি প্রোপার্টি
`properties` কলামটি JSON হিসাবে অতিরিক্ত ইভেন্ট ক্ষেত্র সংরক্ষণ করে। আপনার কোয়েরিতে পৃথক ক্ষেত্রগুলি এক্সট্র্যাক্ট করতে `JSON_VALUE` ব্যবহার করুন।
উদাহরণস্বরূপ, গত ৭ দিনে কোন ক্যাম্পেইনগুলি সবচেয়ে বেশি ওপেন এনেছে তা দেখতে, একটি নতুন কোয়েরি তৈরি করতে **+**-এ ক্লিক করুন, নীচের SQL পেস্ট করুন এবং **Run**-এ ক্লিক করুন।
```sql
SELECT
event_kind,
JSON_VALUE(properties, '$.campaign_id') AS campaign_id,
COUNT(*) AS events
FROM `your-project.your_dataset.pushwoosh_events`
WHERE event_kind = 'Push Opened'
AND timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
GROUP BY 1, 2
ORDER BY events DESC
```
গত ঘণ্টার ইভেন্ট সংখ্যা পর্যালোচনা করতে, এই কোয়েরিটি চালান:
```sql
SELECT
event_kind,
COUNT(*) AS events
FROM `your-project.your_dataset.pushwoosh_events`
WHERE timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 HOUR)
GROUP BY event_kind
ORDER BY events DESC
```
## ইন্টিগ্রেশন আপডেট করুন
### সার্ভিস অ্যাকাউন্ট কী রোটেট করুন
1. Google Cloud Console-এ, **IAM & Admin** → **Service Accounts**-এ যান।
2. আপনার সার্ভিস অ্যাকাউন্টটি খুলুন।
3. **Keys**-এ যান এবং একটি নতুন JSON কী তৈরি করুন।
4. নতুন কী কাজ করছে তা নিশ্চিত না হওয়া পর্যন্ত পুরানো কী সক্রিয় রাখুন।
5. Pushwoosh-এ, **Google BigQuery** কনফিগারেশন মোডালটি খুলুন।
6. নতুন JSON-টি **Service Account JSON**-এ পেস্ট করুন।
7. **Apply**-এ ক্লিক করুন।
Pushwoosh নতুন কী যাচাই করে, সংরক্ষিত ক্রেডেনশিয়াল প্রতিস্থাপন করে এবং পরবর্তী কনফিগারেশন রিলোডের পরে এটি ব্যবহার করা শুরু করে, যা প্রায় ৩০ সেকেন্ড সময় নেয়।
ইভেন্টগুলি এখনও প্রবাহিত হচ্ছে তা নিশ্চিত করার পরে, Google Cloud Console-এ পুরানো কী মুছে ফেলুন।
### ডেস্টিনেশন ডেটাসেট বা টেবিল পরিবর্তন করুন
1. Pushwoosh-এ, **Settings** → **3rd Party Integrations**-এ যান।
2. **Google BigQuery** সেটিংস খুলুন।
3. একটি ভিন্ন ডেটাসেট নির্বাচন করুন বা একটি নতুন টেবিলের নাম লিখুন।
4. **Apply**-এ ক্লিক করুন।
Pushwoosh প্রায় ৩০ সেকেন্ডের মধ্যে নতুন ডেস্টিনেশন সহ স্ট্রিমটি পুনরায় খোলে। ইতিমধ্যে লেখা সারিগুলি পুরানো টেবিলে থেকে যায়। Pushwoosh ঐতিহাসিক ডেটা ব্যাকফিল করে না।
অন্যান্য সেটিংস আপডেট করার সময় সংরক্ষিত সার্ভিস অ্যাকাউন্ট কী অপরিবর্তিত রাখতে, **Apply**-তে ক্লিক করার আগে **Service Account JSON** খালি রাখুন।
## ট্রাবলশুটিং
| Issue | What to check |
| :---- | :---- |
| **`auth_failed` সহ টেস্ট কানেকশন ব্যর্থ হলে** | সার্ভিস অ্যাকাউন্ট JSON ভুলভাবে ফর্ম্যাট করা হয়েছে বা Google Cloud-এ কী বাতিল করা হয়েছে। একটি নতুন কী তৈরি করুন এবং সম্পূর্ণ JSON ফাইলটি আবার পেস্ট করুন। ফাইলটি `{` দিয়ে শুরু হয়, `}` দিয়ে শেষ হয় এবং একটি `private_key` ব্লক ধারণ করে। |
| **`dataset_not_found` সহ টেস্ট কানেকশন ব্যর্থ হলে** | **Dataset ID** ভুলভাবে লেখা হয়েছে বা আপনার নির্দিষ্ট করা প্রজেক্টে বিদ্যমান নেই। ডেটাসেট আইডি কেস-সেনসিটিভ। টাইপো এড়াতে ড্রপডাউন থেকে ডেটাসেটটি নির্বাচন করুন। |
| **`missing_permission` সহ টেস্ট কানেকশন ব্যর্থ হলে** | সার্ভিস অ্যাকাউন্টে **BigQuery Data Editor** বা **BigQuery User** অনুপস্থিত। উভয় ভূমিকা প্রজেক্ট লেভেলে প্রদান করুন, অথবা আরও সীমাবদ্ধ অ্যাক্সেসের জন্য ডেটাসেট লেভেলে প্রদান করুন। |
| **টেস্ট কানেকশন পাস হলেও BigQuery-তে কোনো সারি দেখা না গেলে** | কমপক্ষে ৩০ সেকেন্ড অপেক্ষা করুন। পরীক্ষা করুন যে আপনি যে ইভেন্টের ধরন পাঠাচ্ছেন তা **Events**-এ নির্বাচিত আছে। উদাহরণস্বরূপ, যদি শুধুমাত্র **Push Opened** নির্বাচিত থাকে এবং কেউ পুশ না খোলে, তাহলে কোনো সারি দেখা যাবে না। |
| **কনফিগারেশন সঠিক দেখালেও মোডাল খালি ক্ষেত্র দেখালে** | পৃষ্ঠাটি রিলোড করুন। প্রতিটি মোডাল খোলার সময় কনফিগারেশন আনা হয় এবং অন্তর্নিহিত পরিষেবা দ্বারা ৩০ সেকেন্ডের জন্য ক্যাশে করা হয়। যদি আপনি এইমাত্র সেটিংস সেভ করে থাকেন, তাহলে কিছুক্ষণ অপেক্ষা করে আবার মোডালটি খুলুন। |
## FAQ
##### আমি কি একটি ফ্রি Google Cloud অ্যাকাউন্ট ব্যবহার করতে পারি?
হ্যাঁ, যতক্ষণ পর্যন্ত প্রজেক্টে বিলিং সক্ষম থাকে। ফ্রি ট্রায়াল ক্রেডিটগুলি সম্পূর্ণ ট্রায়াল সময়ের জন্য সাধারণ ভলিউমে এই ইন্টিগ্রেশন চালানোর জন্য যথেষ্ট। বিলিং ছাড়া BigQuery স্যান্ডবক্স কাজ করবে না কারণ Storage Write API-এর জন্য বিলিং প্রয়োজন।
##### Pushwoosh কি আমার BigQuery ডেটা দেখতে পায়?
না। আপনি যে সার্ভিস অ্যাকাউন্ট ক্রেডেনশিয়াল আপলোড করেন তা Pushwoosh-কে আপনার নির্বাচিত ডেটাসেটে লেখার অনুমতি দেয়। Pushwoosh আপনার ডেটাসেট থেকে পড়ে না এবং আপনার প্রজেক্টের বাকি অংশে কোনো অ্যাক্সেস নেই।
##### আমি কি একাধিক BigQuery ডেটাসেটে এক্সপোর্ট করতে পারি?
প্রতি অ্যাপ্লিকেশনে একটি ডেস্টিনেশন সমর্থিত। যদি আপনার দুটি ডেটাসেটে একই ইভেন্টের প্রয়োজন হয়, তাহলে আপনার প্রজেক্টে একটি BigQuery নির্ধারিত কোয়েরি সেট আপ করুন যাতে `pushwoosh_events` থেকে অন্য টেবিলে ডেটা কপি করা যায়।
##### আমি কি টেবিল স্কিমা পরিবর্তন করতে পারি?
স্কিমা সমস্ত গ্রাহকদের জন্য স্থির। যদি আপনার অতিরিক্ত কলামের প্রয়োজন হয়, তাহলে আপনার নিজের ভিউ বা নির্ধারিত কোয়েরিতে `properties` JSON থেকে সেগুলি এক্সট্র্যাক্ট করুন।
##### আমি যদি সাময়িকভাবে ইন্টিগ্রেশনটি নিষ্ক্রিয় করি তাহলে কী হবে?
**Stream events to BigQuery** বন্ধ করুন এবং **Apply**-তে ক্লিক করুন। Pushwoosh প্রায় ৩০ সেকেন্ডের মধ্যে এই অ্যাপ্লিকেশনের জন্য ইভেন্ট যুক্ত করা বন্ধ করে দেবে।
ইন্টিগ্রেশন বন্ধ থাকাকালীন উৎপাদিত ইভেন্টগুলি বাফার করা বা ব্যাকফিল করা হয় না যখন আপনি এটি আবার চালু করেন। Pushwoosh ক্রেডেনশিয়াল, ডেটাসেট এবং ইভেন্ট নির্বাচন সহ কনফিগারেশনটি রাখে।
##### আমি কীভাবে ইন্টিগ্রেশনটি সম্পূর্ণরূপে মুছে ফেলব?
ইন্টিগ্রেশন কনফিগারেশন মুছে ফেলতে [support@pushwoosh.com](mailto:support@pushwoosh.com)-এ যোগাযোগ করুন। ডেটাসেট এবং BigQuery-তে ইতিমধ্যে লেখা সারিগুলি আপনার Google Cloud অ্যাকাউন্টে থেকে যাবে।
##### কোনো ডেলিভারি গ্যারান্টি আছে কি?
ইন্টিগ্রেশনটি অ্যাট-লিস্ট-ওয়ান্স ডেলিভারি ব্যবহার করে। স্বাভাবিক অপারেশনে, ডুপ্লিকেট বিরল। একটি অ্যাপেন্ড এবং একটি কমিটের মধ্যে একটি প্রসেস রিস্টার্ট অল্প সংখ্যক ডুপ্লিকেট সারি তৈরি করতে পারে। যদি আপনার ডাউনস্ট্রিম পাইপলাইনের জন্য এক্সাক্টলি-ওয়ান্স ফলাফলের প্রয়োজন হয় তাহলে SQL-এ ডিডুপ্লিকেট করুন।
##### কেন কোনো Push Clicked ইভেন্ট নেই?
Pushwoosh বর্তমানে এই ইন্টিগ্রেশনে পুশ নোটিফিকেশনের জন্য **Push Sent**, **Push Delivered**, এবং **Push Opened** প্রকাশ করে। একটি ডেডিকেটেড পুশ ক্লিক স্টেপ উপলব্ধ নেই। ইমেল এবং SMS-এর নিজস্ব লাইফসাইকেল ইভেন্ট রয়েছে।