מתכוננים להעברה

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

הגדרה של חשבון פיתוח ב-Google Play

כדי לפרסם את האפליקציות והמשחקים שלכם ב-Google Play, אתם צריכים להשתמש ב-Google Play Console. בנוסף, אתם יכולים להשתמש ב-Google Play Console כדי לנהל את המוצרים וההגדרות שקשורים לחיוב.

כדי לגשת ל-Google Play Console, צריך להגדיר חשבון פיתוח ב-Google Play.

כדי למכור אפליקציות בתשלום ורכישות באפליקציה ב-Google Play, צריך גם להגדיר פרופיל במרכז התשלומים של Google ואז לקשר את הפרופיל הזה לחשבון הפיתוח ב-Google Play. במאמר קישור של חשבון פיתוח ב-Google Play לפרופיל התשלומים מוסבר איך לקשר את הפרופיל לחשבון, ואיך לבדוק אם כבר יש לכם חשבון ופרופיל מקושרים.

הפעלת תכונות שקשורות לחיוב ב-Google Play Console

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

הוספת תלות של הפרויקט בספרייה

כדי לשלב את מערכת החיוב של Google Play, קודם צריך להוסיף לאפליקציה תלות בספריית החיובים ב-Google Play. הספרייה הזו מספקת גישה לממשקי API של Android שמקשרים אתכם ל-Google Play. משם תוכלו לגשת לפרטי הרכישה, לשלוח שאילתות לגבי עדכונים על רכישות, לבקש מהמשתמש לבצע רכישות חדשות ועוד.

ספריית החיובים ב-Google Play זמינה במאגר Maven של Google. מוסיפים את התלות לקובץ build.gradle של האפליקציה, כמו בדוגמה הבאה:

Groovy

dependencies {
    def billing_version = "9.1.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "9.1.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

אם אתם משתמשים ב-Kotlin, מודול KTX של ספריית החיובים ב-Play מכיל תוספים של Kotlin ותמיכה בשגרות המשך (coroutines) שמאפשרים לכם לכתוב ב-Kotlin אידיומטי כשאתם משתמשים במערכת החיוב של Google Play. כדי לכלול את התוספים האלה בפרויקט, מוסיפים את התלות הבאה לקובץ build.gradle של האפליקציה, כמו שמוצג:

Groovy

dependencies {
    def billing_version = "9.1.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "9.1.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

דוגמאות הקוד ב-Kotlin שמופיעות בדף הזה משתמשות ב-KTX כשאפשר.

העלאת האפליקציה

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

יצירה והגדרה של המוצרים

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

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

ב-Google Play Console יש ממשק אינטרנט שבו אפשר לנהל את המוצרים.

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

  • כדי ליצור ולהגדיר מינויים, קראו את המאמר יצירת מינוי.

כחלופה לממשק האינטרנט, אתם יכולים לנהל את המוצרים גם באמצעות משאב ה-REST‏ inappproducts למוצרים באפליקציה ומשאב ה-REST‏ monetization.subscriptions למוצרים מסוג מינוי בממשק API של Google Play למפתחים.

הגדרת ממשק API של Google Play למפתחים

ממשק ה-API של Google Play למפתחים הוא API בין שרתים שמשלים את ספריית החיובים ב-Google Play ב-Android. ה-API הזה מספק פונקציונליות שלא זמינה בספריית החיובים ב-Google Play, כמו אימות מאובטח של רכישות והנפקת החזרים כספיים למשתמשים.

כחלק מהשילוב של מערכת החיוב של Google Play באפליקציה, צריך להגדיר גישה לממשק ה-API של Google Play למפתחים דרך Google Play Console. הוראות מפורטות זמינות במאמר תחילת העבודה עם ממשק API של Google Play למפתחים.

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

הגדרת התראות בזמן אמת למפתחים

התראות בזמן אמת למפתחים (RTDN) הן מנגנון לקבלת התראות מ-Google בכל פעם שיש שינוי בהרשאה של משתמש באפליקציה. התראות RTDN משתמשות ב-Google Cloud Pub/Sub, שמאפשר לקבל נתונים שנשלחים לכתובת URL שהגדרתם או נדגמים באמצעות ספריית לקוח. ההתראות האלה מאפשרות לכם להגיב מיד לשינויים בסטטוס המינוי, בלי שתצטרכו לבצע סקרים בממשק ה-API של Google Play למפתחים. חשוב לזכור ששימוש לא יעיל בממשק API של Google Play למפתחים עלול להוביל להגבלות על מכסת ה-API.

‫Cloud Pub/Sub הוא שירות מנוהל לחלוטין להעברת הודעות בזמן אמת, שמאפשר לשלוח ולקבל הודעות בין אפליקציות עצמאיות. מערכת Google Play משתמשת ב-Cloud Pub/Sub כדי לפרסם התראות בנושאים שאתם נרשמים אליהם.

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

הגדרת תמחור ומכסות

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

הערכת השימוש בחבילת הגלישה

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

הגדרת Cloud Pub/Sub

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

כדי להשתמש ב-Cloud Pub/Sub, צריך פרויקט בענן של Google שבו מופעל Cloud Pub/Sub API. אם אתם לא מכירים את Google Cloud ואת Cloud Pub/Sub, כדאי לעיין במדריך למתחילים.

יצירת נושא

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

יצירת מינוי ל-Pub/Sub

כדי לקבל הודעות שפורסמו בנושא מסוים, צריך ליצור מינוי Pub/Sub לאותו נושא. כדי ליצור מינוי ל-Pub/Sub:

  1. במדריך למנויים של Cloud Pub/Sub מוסבר איך להגדיר את המינוי כמינוי דחיפה או כמינוי שליפה.
    • מינוי דחיפה מאפשר ל-Cloud Pub/Sub לשלוח התראות לקצה העורפי המאובטח שלכם באמצעות בקשות HTTPS.
    • במינוי שליפה, שרת בק-אנד המאובטח שלכם צריך לשלוח בקשות לשרת Cloud Pub/Sub כדי לאחזר הודעות.
  2. כדי ליצור מינוי, פועלים לפי ההוראות במאמר הוספת מינוי.

הענקת זכויות פרסום בנושא שלכם

ב-Cloud Pub/Sub צריך לתת ל-Google Play הרשאות לפרסם התראות בנושא שלכם.

  1. פותחים את מסוף Google Cloud.
  2. בוחרים את הפרויקט ולוחצים על Pub/Sub בתפריט הניווט שמימין.
  3. מוצאים את הנושא ופותחים את פרטי ההרשאות.

    גישה להגדרות של נושא ההרשאות
    איור 1. גישה להגדרות של הנושא הרשאות.
  4. מוסיפים את חשבון השירות google-play-developer-notifications@system.gserviceaccount.com ומקצים לו את התפקיד פרסום הודעות ב-Pub/Sub.

    הוספת חשבון שירות של Google Play בתור מפרסם ב-Pub/Sub
    איור 2. הוספת חשבון שירות של Google Play בתור בעל הרשאת פרסום ב-Pub/Sub.
  5. כדי לסיים את הגדרת הנושא, לוחצים על שמירה.

    נושא מוגדר ב-Cloud Pub/Sub במסוף Google Cloud.
    איור 3. נושא שהוגדר.

הפעלת התראות בזמן אמת למפתחים באפליקציה

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

  1. פותחים את Google Play Console.
  2. בוחרים את האפליקציה הרצויה.
  3. עוברים אל ייצור הכנסות > הגדרת מונטיזציה.
  4. עוברים לקטע התראות בזמן אמת למפתחים בחלק העליון של הדף.

    הקטע "התראות בזמן אמת למפתחים" ב-Play Console.
    איור 4. התראות בזמן אמת למפתחים.
  5. לוחצים על הפעלת התראות בזמן אמת.

  6. בשדה Topic name, מזינים את השם המלא של נושא Cloud Pub/Sub שהגדרתם קודם. שם הנושא צריך להיות בפורמט projects/{project_id}/topics/{topic_name}, כאשר project_id הוא המזהה הייחודי של הפרויקט ו-topic_name הוא שם הנושא שיצרתם קודם.

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

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

    אם הפרסום נכשל, מוצגת שגיאה. צריך לוודא ששם הנושא נכון, ושלחשבון השירות google-play-developer-notifications@system.gserviceaccount.com יש גישה לנושא בתפקיד מפרסם ב-Pub/Sub.

  8. בוחרים את סוגי ההתראות שרוצים לקבל.

    • קבלת התראות לגבי מינויים ולגבי כל הרכישות שבוטלו – קבלת התראות בזמן אמת למפתחים שקשורות למינויים ולרכישות שבוטלו. לא תקבלו התראות על רכישות של מוצרים בחיוב חד-פעמי.
    • קבלת כל ההתראות לגבי מינויים ומוצרים בחיוב חד-פעמי – קבלת התראות לגבי כל האירועים של מינויים ורכישות שבוטלו. תקבלו גם אירועים של רכישת מוצרים בחיוב חד-פעמי, כמו ONE_TIME_PRODUCT_PURCHASED ו-ONE_TIME_PRODUCT_CANCELED. במאמר מחזור החיים של רכישה חד-פעמית מוסבר בהרחבה על אירועי הרכישה האלה.
  9. לוחצים על שמירת השינויים.

אימות ההגדרות האישיות

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

כדי לבדוק את ההגדרות, אפשר להשתמש בלחצן Send Test Message ב-Google Play Console, כמו שמתואר בקטע הקודם. אם לא הגדרתם שרת בק-אנד לצריכת התראות, אתם יכולים להשתמש בכלי שורת הפקודה gcloud כדי לאמת את ההגדרה. במאמר משיכת ההודעה מהמינוי מוסבר איך לעבד הודעות באמצעות gcloud.

השלבים הבאים