Google Service Account सेटअप
एक Google service account बनाएँ, Search Console और Analytics APIs सक्षम करें, और JSON key को 1MarketingTool से कनेक्ट करें।
जब आप चाहते हैं कि 1MarketingTool बिना किसी पर्सनल Google अकाउंट से साइन इन किए Search Console और GA4 डेटा पढ़े, तो Google service account का उपयोग करें।
क्विक Cloud Shell फ्लो चुनें, या मैन्युअल Google Cloud Console वॉकथ्रू फॉलो करें।
Cloud Shell से क्विक सेटअप
Cloud Shell ब्राउज़र में चलता है, पहले से आपके Google अकाउंट से साइन इन होता है। Cloud Shell खोलें, स्क्रिप्ट पेस्ट करें, Enter दबाएँ, और पूरा होने पर key.json डाउनलोड हो जाता है। फिर 1MarketingTool में Import JSON का उपयोग करके डाउनलोड की गई key लोड करें और सेव करें।
set -e
PROJECT_ID=$(gcloud config get-value project 2>/dev/null)
if [ -z "$PROJECT_ID" ]; then
PROJECT_ID="marketing-tool-$RANDOM$RANDOM"
gcloud projects create "$PROJECT_ID" --set-as-default
fi
gcloud services enable iam.googleapis.com searchconsole.googleapis.com analyticsadmin.googleapis.com \
analyticsdata.googleapis.com indexing.googleapis.com --project "$PROJECT_ID"
SA_EMAIL="marketing-tool@$PROJECT_ID.iam.gserviceaccount.com"
gcloud iam service-accounts create marketing-tool --display-name "1MarketingTool" --project "$PROJECT_ID" || true
echo "Waiting for the service account to be ready..."
for i in $(seq 1 30); do
gcloud iam service-accounts describe "$SA_EMAIL" --project "$PROJECT_ID" >/dev/null 2>&1 && break
sleep 2
done
rm -f key.json
gcloud iam service-accounts keys create key.json --iam-account "$SA_EMAIL" --project "$PROJECT_ID"
cloudshell download key.json
echo "Grant read access in Search Console and GA4 to: $SA_EMAIL"1. Google Cloud प्रोजेक्ट बनाएँ
Google Cloud Console खोलें, ऊपरी बार में प्रोजेक्ट ड्रॉपडाउन का उपयोग करें, फिर New Project चुनें। अगर आपके पास पहले से इस वर्कस्पेस के लिए कोई प्रोजेक्ट है तो आप उसे भी रीयूज़ कर सकते हैं।
प्रोजेक्ट को एक पहचानने योग्य नाम दें, जैसे marketing-tool, फिर Create पर क्लिक करें।
आगे बढ़ने से पहले सुनिश्चित करें कि ऊपरी बार में नया प्रोजेक्ट सेलेक्ट किया गया है।
2. Service Account बनाएँ
APIs & Services -> Credentials पर जाएँ, फिर Create credentials -> Service account चुनें।
एक नाम दर्ज करें जैसे marketing-tool-reader। Google उस नाम से एक service account ID और ईमेल एड्रेस जनरेट करेगा। Create and continue पर क्लिक करें।
आप Google Cloud प्रोजेक्ट रोल देना छोड़ सकते हैं। Search Console और GA4 एक्सेस बाद में उन प्रोडक्ट्स के अंदर दिया जाता है। Done पर क्लिक करें।
Service account ईमेल कॉपी करें। यह कुछ ऐसा दिखता है [email protected]। आप इस ईमेल का उपयोग Search Console और Analytics एक्सेस देते समय करेंगे।
3. JSON Key डाउनलोड करें
Service account खोलें, Keys टैब पर जाएँ, फिर Add key -> Create new key चुनें।
JSON चुनें, फिर Create पर क्लिक करें। एक .json फ़ाइल आपके कंप्यूटर पर डाउनलोड हो जाती है। इस फ़ाइल को प्राइवेट रखें क्योंकि यह एक क्रेडेंशियल है।
4. आवश्यक APIs सक्षम करें
Google Cloud Console में, APIs & Services -> Library खोलें और Google Search Console API सर्च करें।
Google Search Console API चुनें।
सेलेक्ट किए गए प्रोजेक्ट के लिए Enable पर क्लिक करें।
API Library में वापस जाएँ, Google Analytics Data API सर्च करें, फिर उसे सक्षम करें। यह API GA4 रिपोर्टिंग के लिए ज़रूरी है।
वैकल्पिक रूप से Google Analytics Admin API भी सक्षम करें। इससे ऐप GA4 प्रॉपर्टीज़ लिस्ट कर सकता है जब कनेक्टेड वर्कफ्लो द्वारा सपोर्ट हो।
5. Search Console में एक्सेस दें
Google Search Console खोलें, वह प्रॉपर्टी चुनें जिसे आप कनेक्ट करना चाहते हैं, फिर Settings -> Users and permissions -> Add user पर जाएँ।
स्टेप 2 से service account ईमेल पेस्ट करें। Full या Restricted परमिशन चुनें, फिर Add पर क्लिक करें।
6. Google Analytics में एक्सेस दें
Google Analytics खोलें, Admin पर क्लिक करें, फिर सही GA4 प्रॉपर्टी चुनें।
Property access management पर जाएँ, + पर क्लिक करें, और service account ईमेल जोड़ें। Viewer या Analyst एक्सेस का उपयोग करें, फिर Add पर क्लिक करें।
7. 1MarketingTool में कनेक्ट करें
1MarketingTool में, Google प्रोवाइडर या इंटीग्रेशन सेटिंग्स खोलें और पहले डाउनलोड की गई JSON key फ़ाइल इम्पोर्ट करें।
सेव करने के बाद, Search Console या GA4 प्रॉपर्टी को ऐप में सही प्रोजेक्ट से मैप करें।
नोट्स
- अगर Search Console या GA4 डेटा तुरंत नहीं दिखता, तो थोड़ा इंतज़ार करें और फिर से कोशिश करें। Google परमिशन्स को प्रोपेगेट होने में कुछ मिनट लग सकते हैं।
- एक service account को जितने चाहें उतने Search Console और GA4 प्रॉपर्टीज़ में जोड़ा जा सकता है, फिर 1MarketingTool में प्रति प्रोजेक्ट मैप किया जा सकता है।
- अगर आप Google Cloud में JSON key रोटेट या डिलीट करते हैं, तो ऐप में नई key इम्पोर्ट करें।
- JSON key को सुरक्षित रूप से स्टोर करें और इसे सोर्स कंट्रोल में कमिट न करें।