> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# חיבור Google Analytics לאפליקציה שלך

> הצג נתוני תנועה, מעורבות וקמפיינים מ-Google Analytics בלוחות הבקרה ובדוחות של האפליקציה, עם חשבון משותף אחד או עם החשבון של כל אדם.

חבר את האפליקציה שלך ל-Google Analytics כדי להציג מגמות תנועה, מעורבות ותוצאות קמפיינים בלוחות בקרה ובדוחות. השתמש בחשבון Google משותף אחד לכל האפליקציה, או אפשר לכל אדם לחבר חשבון משלו.

***

## מה אפשר לעשות

הכנס את נתוני ה-Google Analytics שלך לאפליקציה.

> [card] הצגת מגמות תנועה
>
> הצג בלוח בקרה בתוך האפליקציה ביקורים, דפים מובילים ומקורות תנועה לאורך זמן.

> [card] ניתוח התנהגות משתמשים
>
> בדוק מעורבות ומשפכי המרה כדי לראות איפה מבקרים נוטשים.

> [card] בניית דוחות קבועים
>
> הפק לצוות שלך דוחות שבועיים עם נתוני תנועה ומעורבות.

> [card] מעקב אחרי קמפיינים
>
> השווה את הביצועים של קמפייני השיווק שלך בעזרת נתוני Analytics.

**הנחיות לדוגמה**

בצ'אט ה-AI, תאר את ה-property, את המדדים שצריך להציג ואת טווח התאריכים. לדוגמה:

```text wrap theme={null}
הצג את מגמות התנועה באתר שלי ואת הדפים עם הביצועים הטובים ביותר.
```

```text wrap theme={null}
צור לוח בקרה שמציג מדדי אנליטיקה מרכזיים.
```

```text wrap theme={null}
נתח התנהגות משתמשים ומשפכי המרה מ-Analytics.
```

```text wrap theme={null}
הפק דוחות שבועיים עם נתוני תנועה ומעורבות.
```

```text wrap theme={null}
עקוב אחרי ביצועי קמפיינים שיווקיים בעזרת נתוני Analytics.
```

***

## חיבור Google Analytics

בחר איך אנשים מתחברים: חשבון משותף אחד לכל האפליקציה, או החשבון של כל אדם.

> [tab] מחבר משותף
>
> חבר חשבון Google אחד, וכל מי שמשתמש באפליקציה חולק אותו ואת נתוני ה-Analytics שלו.
>
> **כדי להוסיף מחבר Google Analytics משותף:**
>
> 1. לחץ על **Connectors** בסרגל הצד של סביבת העבודה.
>
> 2. לחץ על **Add connector**.
>
> 3. חפש את **Google Analytics** ולחץ עליו.
>
> 4. בחר **Shared connector** ולחץ על **Next**.
>
> 5. הזן **Connection name**.
>
> 6. ב-**Who can access**, בחר **Apps and Super agent**, **Apps only** או **Super agent only**. **Apps and Super agent** מסומן כברירת מחדל.
>
> 7. בחר את [היקפי ההרשאות](#scopes-and-permissions) שהאפליקציה צריכה תחת **Permissions**:
>
>    * **Read-only:** האפליקציה יכולה לצפות בנתונים ובהגדרות של Analytics. זו ברירת המחדל.
>    * **Read & write:** האפליקציה יכולה גם לשנות את ההגדרות של החשבון וה-property ב-Analytics.
>    * **Custom:** בחר את ההרשאות האופציונליות שהאפליקציה צריכה. הרשאות נדרשות נשארות מסומנות.
>
>    ![הגדרת מחבר Google Analytics משותף עם Connection name, Who can access והרשאות Read-only מסומנות](https://mintcdn.com/base44/f-7NhkNoXDoVi_Da/images/apps-connectors-google-analytics-shared-setup.png?fit=max\&auto=format\&n=f-7NhkNoXDoVi_Da\&q=85\&s=cd95db20bce0213e7874e1cb16c1eb6b)
>
>    הגדרת מחבר Google Analytics משותף
>
> 8. לחץ על **Add connector**.
>
> 9. התחבר עם חשבון ה-Google שיש לו גישה ל-properties שלך ב-Analytics.

> [tab] מחבר למשתמשי אפליקציה
>
> כל אדם מחבר את חשבון ה-Google שלו, כך שהאפליקציה יכולה להציג את ה-properties ב-Analytics שיש לו גישה אליהם.
>
> > [!WARNING]
> >
> > רק בעלים ומנהלים של סביבת העבודה יכולים להגדיר את זה.
>
> > [!TIP]
> >
> > **לפני שאתה מגדיר מחבר למשתמשי אפליקציה:** נדרש לקוח OAuth של Google Cloud, עם ה-Client ID וה-Client Secret שלו. באותו פרויקט Google Cloud, הפעל את Google Analytics Data API. אם האפליקציה מציגה רשימת properties או משנה הגדרות, הפעל גם את Google Analytics Admin API. ראה [שימוש בלקוח OAuth משלך](https://docs.base44.com/he/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **כדי להוסיף מחבר Google Analytics למשתמשי אפליקציה:**
>
> 1. לחץ על **Connectors** בסרגל הצד של סביבת העבודה.
>
> 2. לחץ על **Add connector**.
>
> 3. חפש את **Google Analytics** ולחץ עליו.
>
> 4. בחר **App user connector** ולחץ על **Next**.
>
> 5. העתק את ה-**Callback URL**.
>
> 6. בלקוח ה-OAuth שלך ב-Google Cloud, הוסף את ה-Callback URL ל-authorized redirect URIs.
>
> 7. חזור לטופס **Add Google Analytics Connection** והזן **Connector name**.
>
> 8. הזן את ה-**Client ID** שלך.
>
> 9. הזן את ה-**Client Secret** שלך.
>
> 10. בחר את [היקפי ההרשאות](#scopes-and-permissions) שהאפליקציה צריכה תחת **Scopes**.
>
>     ![רשימת Scopes של Google Analytics עם email נעול, ו-analytics readonly ו-analytics edit לבחירה](https://mintcdn.com/base44/f-7NhkNoXDoVi_Da/images/apps-connectors-google-analytics-app-user-scopes.png?fit=max\&auto=format\&n=f-7NhkNoXDoVi_Da\&q=85\&s=7610bcb079782883d45daf160a69f252)
>
>     בחירת היקפי הרשאות למחבר למשתמשי אפליקציה
>
> 11. לחץ על **Add Connector**.
>
> 12. עבור לעורך האפליקציה.
>
> 13. בקש מצ'אט ה-AI להוסיף דרך שבה אנשים יוכלו לחבר את חשבון ה-Google Analytics שלהם.

***

## היקפי הרשאות

ה-scopes קובעים מה האפליקציה יכולה לעשות ב-Google Analytics. אתה בוחר אותם כשאתה מגדיר מחבר.

> [card]
>
> **1. מה Base44 מוסיפה**
>
> ‏Base44 תמיד כוללת את ה-scope הזה. הוא מופיע נעול תחת **Custom** במחבר משותף, או תחת **Scopes** במחבר למשתמשי אפליקציה.
>
> * `email`: מזהה את חשבון ה-Google שמתחבר
>
> **2. מה אתה מגדיר**
>
> במחבר משותף, בחר אפשרות הרשאה. במחבר למשתמשי אפליקציה, בחר scopes. שמות ה-scopes של Google Analytics מתחילים ב-`https://www.googleapis.com/auth/`:
>
> * `analytics.readonly`: צפייה בנתונים ובהגדרות של Analytics
> * `analytics.edit`: עריכת ההגדרות של החשבון וה-property ב-Analytics
>
> **גישה:** האפליקציה רואה את החשבונות וה-properties ב-Analytics שחשבון ה-Google המחובר יכול לגשת אליהם.

***

## שימוש בפונקציות backend

אחרי ש-Google Analytics מחובר, פונקציות ה-backend שלך יכולות לקבל אסימון גישה ולקרוא ישירות ל-Google Analytics Data API. ‏Base44 מטפלת בהתחברות ושומרת את האסימון מעודכן בשבילך.

* בחיבור משותף, השתמש ב-`getConnection()` כדי לקבל את האסימון.
* בחיבור של משתמש אפליקציה, השתמש ב-`getCurrentAppUserConnection()` כדי שכל בקשה תשתמש באסימון של האדם המחובר.

קרא ל-Google Analytics Data API בכתובת `analyticsdata.googleapis.com` והעבר את האסימון בכותרת `Authorization`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("google_analytics");

const propertyId = "123456789"; // Your Google Analytics property ID

const response = await fetch(
  `https://analyticsdata.googleapis.com/v1beta/properties/${propertyId}:runReport`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
      dimensions: [{ name: "pagePath" }],
      metrics: [{ name: "screenPageViews" }],
    }),
  },
);
const report = await response.json();
```

> [card] [מחברים משותפים](https://docs.base44.com/he/developers/backend/resources/connectors/shared-connectors.md)
>
> הגדר, פרוס וקרא לחיבור משותף מפונקציית backend.

> [card] [מחברים למשתמשי אפליקציה](https://docs.base44.com/he/developers/backend/resources/connectors/app-user-connectors.md)
>
> קבל אסימון לכל משתמש וקרא ל-API בשם האדם המחובר.

***

## פתרון בעיות

אם Google Analytics מפסיק לעבוד באפליקציה, בדוק את החיבור, את חשבון ה-Google ואת ה-scopes שלו.

> [accordion] צריך לחבר מחדש את החיבור
>
> אם הגישה ל-Google Analytics אובדת או פגה, החיבור מציג קטע **Reconnect this connection**. במחבר משותף, [חבר אותו מחדש](https://docs.base44.com/he/Integrations/Connectors.md#managing-your-connectors) והתחבר עם אותו חשבון Google. כל אפליקציה שמשתמשת בו תעבוד שוב. במחבר למשתמשי אפליקציה, כל אדם מחבר מחדש את החשבון שלו מתוך האפליקציה.

> [accordion] נתוני ה-Analytics שלי לא מופיעים
>
> בדוק שלחשבון ה-Google שחיברת יש גישה ל-property שאתה רוצה, ושהאפליקציה משתמשת ב-ID של אותו property. ל-property חדש עשוי לקחת זמן לאסוף נתונים, לכן השווה לאותו טווח תאריכים ב-Google Analytics.

> [accordion] האפליקציה לא יכולה לשנות הגדרות ב-Analytics
>
> כדי לשנות הגדרות של חשבון ו-property, האפליקציה צריכה את ה-scope `analytics.edit`.
>
> * במחבר משותף, ההרשאות נקבעות כשאתה מוסיף את החיבור. לחץ על **Add another connector** בדף מחבר ה-Google Analytics, ובחר **Read & write** לחיבור החדש.
> * במחבר למשתמשי אפליקציה, פתח אותו בדף מחבר ה-Google Analytics, הוסף את `analytics.edit` ל-scopes שלו ולחץ על **Save Changes**. מי שכבר התחבר שומר על הגישה הקודמת שלו עד שהוא מתחבר שוב.

> [accordion] חלק מהאנשים לא יכולים לחבר את חשבון ה-Google שלהם
>
> לקוח ה-OAuth שלך מתחיל במצב בדיקה, שבו רק משתמשי בדיקה מאושרים יכולים להתחבר. לפני שאתה פותח את הגישה לקהל רחב יותר, העבר את אפליקציית ה-OAuth לייצור והשלם כל אימות ש-Google דורשת.

> [accordion] החיבור נכשל עם שגיאת redirect URI
>
> העתק את ה-**Callback URL** מהטופס **Add Google Analytics Connection**, והוסף אותו בדיוק כפי שהוא ל-authorized redirect URIs בלקוח ה-OAuth שלך ב-Google Cloud.

***

## שאלות נפוצות

> [accordion] איזה תפקיד ב-Google Analytics החשבון צריך?
>
> חבר חשבון Google עם תפקיד Viewer לפחות ב-properties שאתה רוצה להציג. כדי לאפשר לאפליקציה לשנות הגדרות של חשבון או property, החשבון צריך תפקיד Editor.

> [accordion] האם האפליקציה יכולה להשתמש ביותר מ-property אחד?
>
> כן. אם לחשבון ה-Google המחובר יש גישה לכמה properties, ציין בצ'אט ה-AI את זה שאתה רוצה, או בקש דרך לעבור ביניהם.

> [accordion] האם אפשר להשתמש ב-Google Analytics וב-Google Search Console יחד?
>
> כן. הוסף כל מחבר בנפרד, ואז בקש מצ'אט ה-AI לשלב בלוח בקרה אחד את התנועה מ-Google Analytics עם ביצועי החיפוש מ-[Google Search Console](https://docs.base44.com/he/Integrations/google-search-console-connector.md).

> [!NOTE]
>
> דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](https://docs.base44.com/index.md).


## Related topics

- [חיבור Google Maps לאפליקציה שלך](https://docs.base44.com/he/Integrations/google-maps-connector.md)
- [חיבור Google Search Console לאפליקציה שלך](https://docs.base44.com/he/Integrations/google-search-console-connector.md)
- [חיבור דומיין לאפליקציה שלך](https://docs.base44.com/he/Setting-up-your-app/Setting-up-your-custom-domain.md)
- [חיבור Snowflake לאפליקציה שלך](https://docs.base44.com/he/Integrations/snowflake-connector.md)
- [חיבור Slack לאפליקציה שלך](https://docs.base44.com/he/Integrations/slack-connectors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.