Reminder: By Aug 31, 2025, all new apps and updates to existing apps must use Billing Library version 7 or newer. If you need more time to update your app, you can request an extension until Nov 1, 2025. Learn about
Play Billing Library version deprecation.
External offers APIs
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במדינות מסוימות, מפתחים שעומדים בדרישות יכולים להפנות משתמשים אל מחוץ לאפליקציה, כולל כדי לקדם מבצעים על תכונות ושירותים דיגיטליים בתוך האפליקציה. במדריך הזה מוסבר על ממשקי ה-API שמאפשרים להפעיל מבצעים חיצוניים. לפני שמשתמשים בממשקי ה-API האלה, חשוב לעיין בדרישות התוכנית ולהירשם לתוכנית לשיווק מחוץ לאפליקציה.
מילון מונחים
מוסכמות המונחים שבהן נעשה שימוש במדריך הזה:
- External offers APIs: ממשקי API שמשמשים להפניית המשתמש אל מחוץ לאפליקציה, כולל הצגת מסך המידע הנדרש ודיווח על עסקאות רלוונטיות.
- עסקה חיצונית: עסקה שעומדת בדרישות ומתרחשת מחוץ לאפליקציה, כפי שמוגדר בדרישות התוכנית.
- אסימון של עסקה חיצונית: אסימון שמועבר למפתח דרך ספריית החיובים ב-Play, כדי שהמפתח יוכל להשתמש בו כשהמשתמש משלים עסקה חיצונית. האסימון הזה משמש כדי להודיע ל-Google Play על רכישה שבוצעה בהצלחה.
- מזהה עסקה חיצוני: מזהה ייחודי שנוצר על ידי המפתח כדי לזהות עסקה חיצונית.
תמיכה בתוכנית לשיווק מחוץ לאפליקציה
בקטע הזה מוסבר איך תומכים במוצרים חיצוניים.
לפני שמשתמשים בממשקי ה-API האלה, חשוב לוודא את הדברים הבאים:
הגדרה ב-Play Console
כדי להגדיר מבצעים מחוץ לאפליקציה ב-Play Console, צריך לפעול לפי השלבים שמפורטים בדרישות התוכנית.
מסך המידע עוזר למשתמשים להבין שהם עומדים לבקר באתר חיצוני. מסך המידע יוצג למשתמשים בכל פעם לפני שהם מופנים אל מחוץ לאפליקציה באמצעות ממשקי ה-API של המבצעים החיצוניים.
מסך המידע
|
הדוגמה הזו מיועדת להמחשה בלבד.
השלבים הבאים
כדי להתחיל לשלב את ממשקי ה-API של התוכנית לשיווק מחוץ לאפליקציה, צריך לפעול לפי המדריכים המפורטים בנושא שילוב באפליקציה ושילוב בקצה העורפי.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# External offers APIs\n\nIn certain countries, eligible developers are able to lead users outside the\napp, including to promote offers for in-app digital features and services. This\nguide addresses the APIs to enable external offers. You should review the\n[program requirements](https://support.google.com/googleplay/android-developer/answer/14372887) and enroll in the external offers program before\nusing these APIs.\n\nGlossary of terms\n-----------------\n\nTerm conventions followed by this guide:\n\n- **External offers APIs**: APIs used to direct the user outside of the app, including surfacing required information screen and reporting applicable transactions.\n- **External transaction** : A qualifying transaction that occurs outside of the app as defined by the [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n- **External transaction token**: A token provided to the developer through the Play Billing Library for the developer to use when the user completes an external transaction. This token is used to notify Google Play of a successful purchase.\n- **External transaction ID**: A unique identifier generated by the developer to identify an external transaction.\n\nSupport external offers\n-----------------------\n\nThis section describes how to support external offers.\nBefore using these APIs, ensure the following:\n\n- Review the eligibility requirements for the relevant program and complete the onboarding steps outlined in the [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n- Integrate [Play Billing Library 6.2.1](/google/play/billing/release-notes) or higher.\n\n### Configure in Play Console\n\nTo configure external offers in Play Console, follow the steps outlined in\nthe [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n\n### Information screen for users\n\nThe information screen helps users understand that they are about to visit an\nexternal website. The information screen will be shown to users each time before\nthey are directed outside of the app using the external offers APIs. \n\n|--------------------|\n| Information screen |\n\nExample for illustrative purposes only.\n\n### Next steps\n\nTo begin integrating the external offers APIs, follow the in-depth guides\nfor both [in-app integration](/google/play/billing/external/integration) and [backend integration](/google/play/billing/outside-gpb-backend)."]]
