דף החנות

שתי החנויות מבקשות פחות או יותר את אותם דברים, בצורות שונות. ב-⁠Ploa הם קבוצה אחת של תשובות: הסוכן שלך כותב אותן מהקוד, אתה בודק אותן ומחליט על מה שלך להחליט, ושליחה אחת מעבירה אותן ל-⁠App Store Connect ול-⁠Google Play.

הכלים שמאחורי הבקשות האלה: כל כלי ה-⁠MCP › פרטי החנות,‏ פרטיות,‏ תאימות לייצוא ו-⁠צילומי מסך וסרטונים. ההנחיות שהסוכן שלך עובד לפיהן: fill_store_page,‏ translate_store_page,‏ make_screenshots,‏ answer_privacy ו-⁠write_release_notes.

מי עושה מה

מה החנויות מבקשות

המספרים הם מגבלת התווים של כל שדה.‏ Ploa בודקת כל תשובה מולן תוך כדי כתיבה, ומראה מה כל חנות הייתה דוחה (לתקן) ומה נראה כמו טעות (לבדוק).

טיוטות, ואז שליחה אחת

1. כותבים

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

2. בודקים

   ‏Ploa מראה, לפי שלב ושפה, מה כל חנות הייתה דוחה, והסוכן שלך מתקן, ושואל אותך את מה שרק אתה יודע (המחיר, למי האפליקציה מיועדת, טלפון ליצירת קשר, חשבון הדגמה).

3. שולחים

   כששום דבר לא אמור להידחות, לוחצים שליחה בדף פרטי החנות, או נותנים לסוכן לשלוח (ploa_details_send): כל הטיוטות יוצאות ל-⁠App Store Connect ול-⁠Google Play בבת אחת, ו-⁠Ploa אומרת מה כל חנות קיבלה. כשמשהו היה נדחה, שום דבר לא נשלח, והבעיות חוזרות עם השלב שבו מתקנים כל אחת.

שינוי מחיר שסוכן שולח מחכה לאישור שלך. מי רשאי לשלוח בכלל נקבע לפי רמת הגישה של הסוכן (ראה הרשאות ואישורים).

שינויים שנשמרים בזמן ש-⁠Apple בודקת

‏Apple לא מקבלת שינויים במה שהיא בודקת. כל עוד הגרסה אצל App Review,‏ Ploa שומרת את השינויים שלה (הטקסט ב-⁠App Store, צילומי מסך, סרטוני תצוגה, הגדרות ה-⁠App Store, התמונה של מוצר, אירוע באפליקציה) ושולחת אותם בעצמה כש-⁠Apple מחליטה. שליחה חדשה יותר של אותו חלק מחליפה את זו שנשמרה.

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

שפות

אילו שפות יהיו בדף החנות זו החלטה שלך; הסוכן שלך שואל קודם. אחר כך הוא כותב כמה שפות שרוצים בבת אחת. לכל חנות יש קודים משלה (עברית היא he ב-⁠Apple ו-⁠iw-IL ב-⁠Google);‏ Ploa ממפה ביניהם. תרגום טוב נכתב לשוק שלו, עם מילות מפתח שאנשים שם באמת מחפשים, והסוכן שלך עובד לפי הנחיות שנכתבו בדיוק בשביל זה (translate_store_page).

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

קבצים ל-⁠App Review

כשהבודקים לא יכולים להגיע לחלק מהאפליקציה בעצמם (צריך חומרה, חשבון בתשלום או מקום מסוים), מוסיפים סרטון הדגמה או מסמך בשלב App Review, מתחת להערות, או שהסוכן שלך מעלה אותו מהמחשב שלך (ploa_review_attachment_upload, עד 500 MB). הקובץ עולה ל-⁠Apple מיד כשמוסיפים אותו, עם הגרסה שבהכנה, ולא כטיוטה;‏ Ploa מציגה את המצב של כל קובץ אצל Apple ומסירה קובץ בלחיצה. כשהגרסה אצל App Review, קובץ חדש נשמר ב-⁠Ploa ונשלח כש-⁠Apple מחליטה (עד 60 MB; קובץ גדול יותר מוסיפים שוב אחר כך).

צילומי מסך וסרטוני תצוגה

• ‏App Store: סט האייפון בגודל 6.9 אינץ' הוא חובה (1320×2868, מסימולטור של iPhone 17 Pro Max); סט האייפד בגודל 13 אינץ' אם האפליקציה רצה על אייפד. עד 10 בכל סט. צילומי מסך משתנים רק בגרסה שנמצאת בהכנה.
• ‏Google Play: בין 2 ל-⁠8 צילומי מסך לטלפון, סטים לטאבלט כרשות, ותמונה ראשית (feature graphic) בגודל 1024×500.
• סרטונים הם רשות בשתי החנויות, ולכן הסוכן שלך יוצר אחד רק כשאתה רוצה. סרטוני תצוגה ב-⁠App Store: .mov,‏ .m4v או .mp4, בין 15 ל-⁠30 שניות, עד 3 לכל גודל מכשיר ושפה, עם תמונת פתיחה שבוחרים. סרטון הקידום של Google Play הוא קישור.

הסוכן שלך קורא את המידות המדויקות שכל חנות מקבלת ואילו סטים עוד חסרים בדף (ploa_screenshot_specs), מביא את האפליקציה לכל מסך בסימולטור או באמולטור ומצלם אותו (ploa_screenshot_capture), בודק כל קובץ מול הכללים של החנות (פורמט, שקיפות, מידות, גודל קובץ), ומעלה אותם לפי הסדר. הצילום וההעלאה רצים על המחשב שלך, ולכן הם צריכים את Ploa בסוכן שעל המחשב (ראה Ploa בסוכן שלך). בלוח הבקרה, שלב צילומי המסך בפרטי החנות מחזיק את הסטים של שתי החנויות לכל שפה: גוררים אליו קבצים, וכל אחד נבדק מול הכללים של החנות לפני שהוא עולה; קובץ במידה לא נכונה אפשר להתאים שם למידה של הסט.

האייקון של האפליקציה

‏App Store לוקח את האייקון מהבנייה. ב-⁠Google Play, כשלדף החנות בשפת ברירת המחדל עוד אין אייקון,‏ Ploa מקטינה את האייקון של האפליקציה ל-⁠PNG בגודל 512×512 ומעלה אותו, כשבנייה או הסוכן שלך שולחים את האייקון של הפרויקט וכשהטקסט של Google Play נשלח. אייקון שכבר יש ב-⁠Play אף פעם לא מוחלף, כי ייתכן שהוא נעשה במיוחד לחנות. אייקון בפורמט JPEG או WebP, או כזה שקטן מ-⁠512 או לא ריבועי, לא נשלח:‏ Ploa אומרת למה, ומעלים אחד ב-⁠Play Console › Store listing.

פרטיות: ‏App Privacy,‏ Data safety והטפסים שממלאים ביד

עונים פעם אחת מה האפליקציה אוספת (סוגי מידע, מטרות, האם הוא מקושר למשתמש, האם הוא משמש למעקב) ו-⁠Ploa בונה את שני הטפסים. הסוכן שלך מסיק את זה מהקוד: חבילות, הרשאות, מחרוזות מטרה ו-⁠privacy manifests, ו-⁠SDKs מוכרים לאנליטיקה, קריסות, פרסומות, התראות, התחברות ותשלומים. הוא בודק בקוד את מה שהרמזים לא מכריעים, והתשובות נשארות שלך לאשר.

• ‏Data safety של Google Play: ‏Ploa שולחת אותו דרך ה-⁠API של Google, ומחליפה את הטופס כולו, כשלוחצים לשלוח ל-⁠Google Play בשלב הפרטיות (או כשסוכן אוטונומי שולח).‏ Google בודקת אותו אחר כך.
• ל-⁠App Privacy של Apple אין API:‏ Ploa מראה בדיוק מה להזין ב-⁠App Store Connect, עם הקישור, ומסמנים אותו כשמסיימים.
• שאר טפסי App content ב-⁠Play Console (מדיניות פרטיות, גישה לאפליקציה, פרסומות, דירוג תוכן, קהל יעד, חדשות, בריאות, פיצ'רים פיננסיים, אפליקציות ממשלתיות) וגם הגדרות החנות, התמחור והמדינות ממולאים ב-⁠Play Console. שלב הפרטיות מפרט כל אחד עם התשובה להזין וקישור ישיר, ומסמנים כל אחד כשמסיימים. מדביקים שם פעם אחת כתובת כלשהי של האפליקציה ב-⁠Play Console, כדי שהקישורים יפתחו ישר כל טופס של האפליקציה הזו.
• מעמד סוחר (לפי החוק באירופה ובבריטניה) מוצהר ב-⁠Play Console עד 1 בפברואר 2027, אחרת Google מסירה את האפליקציות של החשבון: פעם אחת לחשבון המפתח, ואז לכל אפליקציה. ההחלטה אם יש לך מעמד של סוחר היא שלך. הכנסה מהאפליקציות (מחיר, מכירות בתוך האפליקציה, מנויים או פרסומות) בדרך כלל הופכת אותך לסוחר, ואצל סוחר פרטי הטלפון והכתובת מוצגים לכולם ב-⁠Google Play.‏ Ploa מציגה אותו עם שאר הטפסים, עם השלבים.
• ההצהרות של Apple שאין להן API (ההצהרה על מכשיר רפואי מפוקח ומעמד סוחר באיחוד האירופי) מגיעות אליך כמשימות עם התשובה ש-⁠Ploa מציעה; ראה צעדים ש-⁠Apple משאירה לך.

תאימות לייצוא (הצפנה)

‏Apple שואלת כל בנייה של iOS אם היא משתמשת בהצפנה שכללי הייצוא של ארצות הברית לא פוטרים. התשובה שלך, הצהרה מול Apple; הסוכן שלך קורא את הקוד ומציע תשובה, ושומר רק את מה שאמרת. זה בשלב App Review של פרטי החנות.

בלי הצהרה, שמים את "usesNonExemptEncryption": false תחת ios.config ב-⁠app.json, וכל בנייה עונה בעצמה; ה-⁠preflight בודק את זה.

1. עונים

   סוג ההצפנה, האם האפליקציה ב-⁠App Store בצרפת (Ploa אומרת אם צרפת בין המדינות שלה עכשיו), ולמה היא משתמשת בהצפנה, בכמה משפטים.

2. מעלים את המסמך

   רק כשצריך: PDF,‏ PNG או JPEG, עד 10 MB. המסמכים מגיעים מהרשויות האלה, לא מ-⁠Apple ולא מ-⁠Ploa, והסוכן שלך מעלה רק מסמך שנתת לו.‏ Apple מקבלת קובץ אחד לכל הצהרה, אז שני מסמכים נכנסים ל-⁠PDF אחד.

3. שולחים ל-⁠Apple

   ‏Ploa יוצרת את הצהרת ההצפנה ב-⁠App Store Connect, מעלה אליה את המסמך ומצמידה אותה לבנייה של הגרסה ולכל בנייה שעוד מחכה לתשובה. רק אתה שולח אותה (או סוכן שהפכת לאוטונומי).

4. ‏Apple בודקת

   בדרך כלל תוך כשני ימי עסקים.‏ Ploa מצמידה את ההצהרה לכל בנייה חדשה ש-⁠Apple סיימה לעבד. אחרי ש-⁠Apple מאשרת, שמים את הקוד שלה ב-⁠ITSEncryptionExportComplianceCode ב-⁠Info.plist (Ploa מראה אותו), כדי שגם בניות שנעשות במקום אחר יכללו אותו.

מה ה-⁠API של Apple לא יודע לעשות: להחליט אם אפליקציה פטורה (Apple מחשבת את זה מהתשובות), לומר למה דחתה הצהרה, או להחליף את המסמך של הצהרה. העמוד App Information ב-⁠App Store Connect, תחת App Encryption Documentation, מראה כל הצהרה ומצבה; תשובות ששונו או מסמך חדש יוצרים הצהרה חדשה כששולחים שוב. כללי ארצות הברית יכולים לדרוש יותר מאפליקציה עם הצפנה שאינה פטורה גם מחוץ ל-⁠App Store, למשל דוח סיווג עצמי שנתי; זה בינך לבין הרשויות.

הדף של גרסה חדשה

‏Apple מקבלת שינויים בטקסט ובצילומי המסך רק בגרסה שנמצאת בהכנה. הסוכן שלך פותח את הגרסה הבאה (למשל 1.2.0,‏ ploa_listing_start_version), מעתיק אליה את הטקסט וצילומי המסך של הקודמת, וכותב את "מה חדש" מהשינויים מאז השחרור האחרון.

"מה חדש" בשתי החנויות

"מה חדש" הוא תשובה אחת לכל שפה, כמו שאר הטקסט, וכל חנות מקבלת אותו בדרך שלה:

• ‏App Store: על הגרסה שבהכנה, עד 4000 תווים, ורק בעדכון:‏ Apple דוחה אותו בגרסה הראשונה של האפליקציה. הוא יוצא עם שליחה.
• ‏Google Play: ‏Play שומרת את הערות הגרסה (release notes) על ה-⁠release עצמו, לא על דף החנות.‏ Ploa שומרת אותן ומצמידה אותן ל-⁠release שהיא יוצרת בבדיקה הפנימית כשהבנייה מגיעה, בכל שפה של האפליקציה ב-⁠Google Play, עד 500 תווים לכל שפה. קידום ה-⁠release לפרודקשן, שינוי ההפצה שלו או עצירה שלו שומרים את ההערות שאיתן הוא יצא. לא צריך שליחה, וגם לגרסה ראשונה אפשר.

כשהאפליקציה בשתי החנויות, כדאי להישאר בתוך 500 תווים, כדי שטקסט אחד יתאים לשתיהן. הסוכן שלך כותב אותו מה-⁠pull requests והקומיטים מאז השחרור האחרון (ploa_release_changes), במילים של מי שמשתמש באפליקציה, ושומר אותו לפני שהבנייה מתחילה. בנייה שיצאה בלי הערות מקבלת את אלה שנכתבו מאז כש-⁠Ploa מקדמת אותה, משנה את ההפצה שלה או עוצרת אותה; בנייה שיצאה עם הערות שומרת אותן, והערות חדשות יוצאות עם הבנייה הבאה. אחרי שבנייה יצאה עם ההערות של שפה מסוימת, פרטי החנות אומרים את זה עד שכותבים את ההערות של הגרסה הבאה. ההערות עוברות דרך Ploa, ואף פעם לא מוקלדות ב-⁠Play Console, כדי שהשחרור הבא ישמור אותן.

"מה חדש" אחר לכל חנות

ברירת המחדל היא טקסט אחד לשתי החנויות, אבל בכל שפה אפשר לתת לכל חנות טקסט משלה: בדף פרטי החנות, טקסט אחר לכל חנות מתחת ל-"מה חדש" פותח תיבה ל-⁠App Store ותיבה ל-⁠Google Play, ושתיהן מתחילות מהטקסט המשותף. הטקסט של כל חנות נשמר לחוד, אז אפשר לכתוב את של Google Play לפני הבנייה לאנדרואיד ואת של App Store כשהגרסה שלו פתוחה, בכל סדר. טקסט אחד לשתי החנויות מחזיר את זה של App Store לשתיהן.

בשביל זה יש לכל חנות טקסט משלה: החנויות מסמנות "מה חדש" שמזכיר את הפלטפורמה השנייה. ב-⁠App Store לא מזכירים את Android,‏ Google או Google Play, וב-⁠Google Play לא מזכירים את Apple,‏ iOS,‏ iPhone,‏ iPad או Mac. פרטי החנות מזהירים כשהטקסט של חנות עושה את זה, באנגלית או בעברית, כדי שאפשר יהיה לתת לה טקסט משלה. הסוכן שלך עושה אותו דבר עם whatsNewApple ו-⁠whatsNewGoogle (ראה write_release_notes).

דף החנות מתוך הריפו

כש-⁠GitHub מקושר, תיקיית store/ בתיקיית האפליקציה יכולה להפוך לטיוטות בכל push לענף השחרור. רק בכיוון אחד: הריפו מציע, ואתה עדיין שולח מ-⁠Ploa. ראה הגדרות GitHub.