Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

שלח הודעות באמצעות מסוף Firebase

אתה יכול לשלוח הודעות הודעות באמצעות ההודעות מלחינות במסוף Firebase. למרות זאת איננו מספק את אותה גמישות או רחבה כמו שליחת הודעות עם SDK של הניהול או פרוטוקולי HTTP ו- XMPP , זה יכול להיות שימושי מאוד עבור בדיקות או לשיווק ממוקד מאוד ומעורב של משתמשים. Firebase המסוף מספק כלים אנליטיים בדיקות A / B כדי לחדד עזרה ולשפר מסרים שיווקיים.

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

על אודות

כאשר אתה שולח הודעת דיווח של מלחין ההודעות , Google משתמשת הערכים שתזינו בשדות הטופס בדרכים הבאות:

  • פילדס כמו קטע משתמש פג לקבוע את אפשרויות היעד של העברת מסרים.
  • פילדס כמו טקסט התראות ונתונים מותאמים אישית נשלח אל לקוח מטען מורכב זוגות מפתח / ערך.

שדות אלה ממפים את המפתחות הזמינים באמצעות פרוטוקולי שרת ה- FCM. לדוגמא, מפתח / זוגות ערך שהוזנו נתונים מותאמים אישית מטופלות כמו מטען נתונים עבור ההודעה. שדות נוספים למפות ישירות מפתחות FCM מטען ההודעה .

חלק מהשדות ב מלחין ההודעות איננו זמינים דרך פרוטוקולי שרת FCM. לדוגמא, אתה יכול למקד פלחי משתמשים מבוססים על גרסת אפליקציה, שפה, סוג דפדפן וגרסה, או מאפיינים המשתמשים בדרכים שאיננו זמינים באמצעות to שדה API בשרת.

המפתחות שמסוף Firebase שולח ללקוחות הם:

מַפְתֵחַ תווית שדה המסוף תיאור
notification.title כותרת הודעה מציין כותרת הודעה.
notification.body טקסט הודעה מציין טקסט בגוף ההודעות.
data נתונים בהתאמה אישית זוגות מפתח/ערך שאתה מגדיר. אלה נמסרים כמטען נתונים עבור האפליקציה לטיפול.

המפתחות הקובעים את מסירת ההודעות כוללים:

מַפְתֵחַ תווית שדה המסוף תיאור
sound נשמע

מציין צליל שיש לנגן כאשר המכשיר מקבל הודעה.

time_to_live פג תוקפו

פרמטר זה מציין כמה זמן (בשניות) ההודעה צריכה להישמר באחסון FCM אם המכשיר במצב לא מקוון. לקבלת מידע נוסף, ראה הגדיר את תוחלת החיים של הודעה .

יומני ביקורת

דף זה מתאר את יומני ביקורת נוצר על ידי Firebase כחלק ענן ביקורת יומנים .

סקירה כללית

שירותי Firebase כותבים יומני ביקורת שיעזרו לך לענות על השאלות "מי עשה מה, היכן ומתי?" אלו הן ענן ביקורת יומנים, ובלבד כחלק פרויקט Google Cloud מחובר פרויקט Firebase שלך . כל הפרויקטים שלך ב- Firebase מכילים רק את יומני הביקורת של משאבים הנמצאים ישירות בתוך הפרויקט.

לסקירה כללית של יומני ביקורת ענן, ללכת ענן ביקורת יומנים . עבור הבנה עמוקה יותר של יומני ביקורת ענן, לסקור יומני ביקורת הבנה .

Cloud Audit Logs מחזיקה שלושה יומני ביקורת עבור כל פרויקט, תיקיה וארגון של Google Cloud:

  • יומני ביקורת על פעילות הניהול
  • יומני ביקורת של גישה לנתונים
  • יומני ביקורת אירועי מערכת

רק אם הופעל במפורש, מסוף הודעות Firebase כותב ביומני ביקורת גישה לנתונים. יומני ביקורת של גישה לנתונים מכילים קריאות API הקוראות את התצורה או את מטא הנתונים של המשאבים, כמו גם שיחות API מונחות משתמש היוצרות, משנות או קוראות נתוני משאבים שניתנו על ידי משתמשים. יומני ביקורת גישה לנתונים לא להקליט את הפעולות של גישה לנתונים על המשאבים המשותפים בפומבי (זמין לכל המשתמשים או משתמשים מאומתים כל) או שניתן לגשת ללא כניסה לתוך Google Cloud Print.

קונסולת הודעות Firebase לא לכתוב יומני ביקורת פעילות ניהול.

קונסולת הודעות Firebase לא לכתוב יומני ביקורת מערכת אירוע.

פעולות מבוקרות

להלן מסכם אילו פעולות API מתאימות לכל סוג יומן ביקורת במסוף התראות Firebase:

קטגוריית יומני ביקורת פעולות מסוף של הודעות Firebase הקלד שם (משמש לחיפוש בממשק המשתמש אחר יומנים)
יומני גישה לנתונים (DATA_READ) קבל קמפיין GetCampaign
יומני גישה לנתונים (DATA_READ) רשימת קמפיינים ListCampaign
יומני גישה לנתונים (DATA_READ) קבל מידע מהודעת ניסוי ABT LegacyGetRollout
יומני גישה לנתונים (DATA_READ) קבל אפשרויות מיקוד GetAudiences
יומני גישה לנתונים (DATA_READ) קבל נתונים סטטיסטיים של fcm (נשלח/נפתח/נמסר/הומר המרות) GetFcmStats
יומני גישה לנתונים (DATA_READ) קבל רשימת תוויות ניתוח עבור טווח תאריכים ופרויקט. GetAnalyticsLabelList
יומני גישה לנתונים (DATA_WRITE) צור קמפיין CreateCampaign
יומני גישה לנתונים (DATA_WRITE) מחק קמפיין מחק קמפיין
יומני גישה לנתונים (DATA_WRITE) עדכן קמפיין UpdateCampaign
יומני גישה לנתונים (DATA_WRITE) צור הפצה מתוך ABT LegacyCreateRollout

פורמט יומן ביקורת

ערכי יומן ביקורת - שניתן לצפות בהם ברישום Stackdriver Logger באמצעות מציג היומנים, ה- API Logging של Stackdriver או ה- SDK בענן - כוללים את האובייקטים הבאים:

  • רשומת היומן עצמו, שהוא אובייקט מסוג LogEntry . שדות שימושיים כוללים את הדברים הבאים:

    • logName מכיל ביומן הזדהות וביקורת פרויקט מסוג
    • resource מכיל את היעד של המבצע המבוקר
    • timeStamp מכילה בזמן המבצע המבוקר
    • protoPayload מכיל מידע המבוקרים
  • הנתונים רישום הביקורת, אשר מהווה AuditLog אובייקט שנערך protoPayload בתחום כניסת יומן.

  • שירות אופציונאלי וספציפי מידע ביקורת, שהוא חפץ שירות ספציפי שנערכה serviceData השדה של AuditLog האובייקט. לפרטים, ללכת נתונים לביקורת שירות ספציפיים .

עבור שדות אחרים האובייקטים האלה, בתוספת איך לפרש אותם, סקירת יומני ביקורת הבנה .

שם היומן

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

projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity
organizations/[ORGANIZATION_ID]/logs/cloudaudit.googleapis.com%2Fdata_access

שם השירות

יומני ביקורת קונסולת הודעות Firebase להשתמש בשם שירות gcmcontextualcampaign-pa.googleapis.com .

לפרטים נוספים על שירותי כניסה, ללכת שירותי מיפוי משאבים .

סוגי משאבים

יומני ביקורת קונסולת הודעות Firebase להשתמש בסוג המשאב audited_resource עבור כל יומני ביקורת.

לרשימה מלאה, ללכת סוגי משאב פיקוח .

אפשר רישום ביקורת

יומני ביקורת של גישה לנתונים מושבתים כברירת מחדל ואינם כתובים אלא אם כן הם מופעלים במפורש (היוצא מן הכלל הוא יומני ביקורת של גישה לנתונים עבור BigQuery, שלא ניתן להשביתם).

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

יומני הביקורת של גישה לנתונים שאתה מפעיל יכולים להשפיע על תמחור יומניך ב- Stackdriver. סקור את תמחור סעיף בדף זה.

מסוף ההתראות של Firebase אינו כותב יומני ביקורת של פעילות מנהל מערכת.

הרשאות יומן ביקורת

הרשאות ותפקידי ניהול זהויות וניהול ענן קובעים אילו יומני ביקורת ניתן להציג או לייצא. יומנים נמצאים בפרויקטים ובישויות אחרות, כולל ארגונים, תיקיות וחשבונות חיוב. לקבלת מידע נוסף, עבור אל תפקידים הבנה .

כדי להציג יומני ביקורת של Access Data, עליך להיות בעל אחד מהתפקידים הבאים בפרויקט המכיל את יומני הביקורת שלך:

אם אתה משתמש יומני ביקורת מגוף שאינו פרויקט, כגון ארגון, אז לשנות את תפקידי פרויקט לתפקידים בארגון מתאימים.

הצגת יומנים

יש לך מספר אפשרויות לצפייה בערכי יומן הביקורת שלך:

מציג בסיסי

תוכל להשתמש בממשק הבסיסי של מציג היומנים במסוף GCP כדי לאחזר את רשומות יומן הביקורת שלך. תעשה את הדברים הבאים:

  1. עבור אל Logging Stackdriver> יומנים (Viewer יומנים) דף בקונסולת GCP:

    עבור לדף מציג היומנים

  2. בחר פרויקט קיים של Google Cloud בראש הדף, או צור פרויקט חדש.

  3. בתפריט הנפתח הראשון, בחר את סוג המשאב שאת יומני הביקורת שלו ברצונך להציג. אתה יכול לבחור משאב ספציפי או Global עבור כל המשאבים.

  4. בתפריט הנפתח השני, בחר את סוג היומן שברצונך להציג: activity עבור יומני ביקורת של פעילות ניהול, data_access עבור יומני ביקורת גישה לנתונים, ו system_events עבור יומני ביקורת מערכת אירוע.

    אם אף אחת מהאפשרויות הללו לא מוצגת, אין פרוייקטים של יומני ביקורת מסוג זה.

מציג מתקדם

תוכל להשתמש בממשק המתקדם של מציג היומנים במסוף GCP כדי לאחזר את רשומות יומן הביקורת שלך. תעשה את הדברים הבאים:

  1. עבור אל Logging Stackdriver> יומנים (Viewer יומנים) דף בקונסולת GCP:

    עבור לדף מציג היומנים

  2. בחר פרויקט קיים של Google Cloud בראש הדף, או צור פרויקט חדש.

  3. בתפריט הנפתח הראשון, בחר את סוג המשאב שאת יומני הביקורת שלו ברצונך להציג. אתה יכול לבחור משאב ספציפי או Global עבור כל המשאבים.

  4. לחץ על החץ הנפתח (▾) בקצה הימני או השמאלי של תיבת החיפוש-מסנן ובחר להמיר מסנן מתקדם.

  5. צור מסנן המציין עוד יותר את רשומות היומן שברצונך להציג. כדי לאחזר את כל יומני הביקורת בפרויקט שלך, הוסף את המסנן הבא. לספק תקף [PROJECT_ID] בכל אחד השמות ביומן.

      logName = ("projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity" OR
          OR "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events"
          OR "projects/[PROJECT_ID]logs/cloudaudit.googleapis.com%2Fdata_access")
    

    לפרטים נוספים על מסננים, ללכת מתקדם יומני מסננים .

API

כדי להסתכל על רשומות יומן הביקורת שלך באמצעות ה- API Logging של Stackdriver:

  1. עבור אל API נסה את זה בסעיף בתיעוד עבור entries.list השיטה.

  2. שים את הבאה לתוך חלק גוף בקשה של API נסה את זה בצורה. לחיצה על זה בצורה מוזנת מראש ממלאה את גוף הבקשה באופן אוטומטי, אבל תצטרך לספק תקף [PROJECT_ID] בכול אחד השמות ביומן.

      {
        "resourceNames": [
          "projects/[PROJECT_ID]"
        ],
        "pageSize": 5,
        "filter": "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"
      }
    
  3. לחץ על בצע.

לפרטים נוספים אודות שאילתות, ללכת מתקדם יומני שאילתות .

SDK

כדי לקרוא את ערכי היומן שלך באמצעות Cloud SDK, הפעל את הפקודה הבאה. לספק תקף [PROJECT_ID] בכל אחד השמות ביומן.

gcloud logging read "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"

עבור ערכי יומן קריאה לקבלת מידע נוסף על שימוש הענן SDK.

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

ייצא יומני ביקורת

אתה יכול לייצא יומני ביקורת באותו אופן שאתה מייצא סוגים אחרים של יומנים. לפרטים על איך לייצא היומנים שלך, ללכת יומני ייצוא . להלן מספר יישומים לייצוא יומני ביקורת:

  • כדי לשמור על יומני ביקורת למשך פרק זמן ארוך יותר או להשתמש ביכולות חיפוש חזקות יותר, תוכל לייצא עותקים של יומני הביקורת שלך לאחסון ענן של Google, BigQuery או Google Cloud Pub/Sub. באמצעות Cloud Pub/Sub תוכל לייצא ליישומים אחרים, מאגרים אחרים ולצדדים שלישיים.

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

  • אם יומני הביקורת המאפשרים גישה לנתונים שלך דוחפים את הפרויקטים שלך על הקצאות היומנים שלהם, תוכל לייצא ולכלול את יומני הביקורת של Access Data מתוך רישום. לפרטים, ללכת יומנים לא כולל .

תמחור

Stackdriver Logging מחייב אותך על יומני ביקורת של גישה לנתונים שאתה מבקש במפורש. מסוף ההתראות של Firebase אינו כותב יומני ביקורת על פעילות מנהל המערכת או יומני ביקורת אירועי מערכת.

לקבלת מידע נוסף על תמחור יומני ביקורת, סקירה ותמחור Stackdriver .