Las API de Economy v1 están en modo de mantenimiento y no recibirán nuevas características, solo correcciones de errores. Las API v1 se mantendrán en el futuro previsible. Consulte la información general de Economy v2 para obtener más información sobre la próxima versión de PlayFab Economy.
¿Qué es un catálogo?
Un catálogo se usa para definir los artículos que un jugador puede comprar o que usted puede conceder a un jugador. Muchos juegos ofrecen al jugador artículos para comprar, como un escudo, el desbloqueo de un nivel o una mejora. Estos artículos se especifican en un catálogo y a menudo se venden por moneda virtual o dinero real. El catálogo de PlayFab ofrece una forma sencilla de administrar los artículos virtuales de su juego y puede contener todos los artículos disponibles en él.Referencia de los campos de artículo
Esta sección describe cada campo de la sección Catalog V2 del área Economy en Game Manager. Cuando crea un título por primera vez, su catálogo está vacío. No verá ningún artículo en la sección Catalog hasta que los cree. Las siguientes pestañas existen en la sección Catalog v2:
Cada uno de estos es un tipo de artículo que se puede usar dentro de su catálogo.
Campos de artículo de Catalog V2
Cuando selecciona un Catalog V2, la pestaña Items y elige NEW ITEM, verá la siguiente página: La página New Item contiene estos campos. A menos que se indique, estos campos son opcionales:- PROPERTIES
- Creator Entity Type: Un campo creado por el sistema que le indica el tipo de creador de la entidad.
- Creator Entity ID: Un identificador único para el creador de la entidad. En Game Manager, este identificador se establece en el valor del título.
- Friendly ID: Un campo que se puede usar para facilitar la referencia en el código. Los identificadores descriptivos son opcionales para todos los artículos y deben ser únicos dentro del catálogo.
- Title: Un campo obligatorio para el nombre común del artículo que normalmente se muestra al jugador. Se admite una localización sencilla de Title mediante el uso de claves de configuración regional. Para obtener más información, consulte Localización de Economy V2.
- Default Stack ID: Los artículos se pueden almacenar en el inventario como pilas, cada una con su propia cantidad y diferenciadas por StackId. Si no se define, las acciones de inventario usarán default como StackId. Para obtener más información, consulte Pilas de Economy.
- Keywords: Las palabras clave se pueden usar para el filtrado básico de búsquedas. Son un diccionario de palabras clave localizadas en formato JSON. Para ver un ejemplo, consulte Localización de Economy V2.
- Description: Un diccionario de descripciones de artículos localizadas en formato JSON.
- Content Type: Puede seleccionar un tipo de contenido del artículo mediante esta lista desplegable. Los tipos de contenido se definen en la configuración del catálogo (Title Settings > Economy).
- Display Properties: Un blob JSON que puede usar para propiedades personalizadas del artículo.
- Display Version: Un campo que puede usar para versionar sus Display Properties.
- Tags: Este campo contiene etiquetas que puede usar para organizar los artículos de su catálogo para la búsqueda. Las etiquetas se pueden introducir como cadenas de texto delimitadas por comas. Estas cadenas se predefinen en la configuración del catálogo (Title Settings > Economy).
- Available Tags Práctica lista desplegable para seleccionar etiquetas de artículo ya definidas en la configuración del catálogo.
- OPTIONS
- Hidden: Actualmente hay una única opción disponible para los artículos que se enumeran en esta sección. Esta opción, Hidden, evita que el artículo se exponga en la búsqueda.
- Start Date: Un campo de fecha obligatorio para indicar cuándo debe estar disponible el artículo en la búsqueda.
- End Date: Un campo de fecha para designar cuándo debe dejar de estar disponible el artículo en la búsqueda.
- PRICES
- Add New Price: Puede usar esta sección para especificar uno o varios precios de compra para el artículo.
- FILES
- Upload: Aquí puede cargar contenido que se almacenará en el catálogo público y que se puede asociar a este artículo.
- IMAGES
- Upload: Aquí puede cargar varias imágenes, incluidas miniaturas y capturas de pantalla, para mostrar el artículo en el catálogo de su juego.
- PLATFORMS
- Manage: Puede especificar para qué plataformas es este artículo. La lista de plataformas se define en la configuración del catálogo (Title Settings > Economy).
Guardado de los artículos en estado de borrador o publicado
El catálogo de Economy V2 admite un estado de artículo Draft (borrador). Cuando usa Save as Draft, los metadatos del artículo están disponibles mediante llamada directa, pero no se exponen a la búsqueda pública. Cuando esté listo para hacer público su artículo, establézcalo en el estado Published (publicado). Puede leer más sobre esto en nuestra página Estado del artículo.Ejemplo de creación de un artículo
Para crear un artículo:- Abra Game Manager y seleccione Economy en la barra lateral izquierda.
- Seleccione la pestaña Catalogs V2.
- Seleccione el botón NEW ITEM.
- Rellene los campos obligatorios del artículo:
- Title (JSON, por ejemplo, {“NEUTRAL”:“My New Amazing Item”}).
- Start Date (seleccione la fecha de hoy).
- Rellene los campos obligatorios del artículo:
- Seleccione el botón SAVE AND PUBLISH, que le llevará de vuelta a la página Items.
- Para agregar más artículos, seleccione NEW ITEM y repita los pasos 3 a 5.
Campos de moneda de Catalog V2
Cuando selecciona Catalog V2, abre la pestaña Currency y elige NEW CURRENCY, abrirá la página New Currency. Las monedas contienen los mismos campos que los campos de artículo de Catalog V2.Campos de UGC de Catalog V2
Cuando selecciona un Catalog V2, abre la pestaña UGC y elige NEW ITEM, abrirá la página New User Generated Content. El contenido generado por el usuario contiene los mismos campos que los campos de artículo de Catalog V2, además de este campo:- MODERATION STATE
- Moderation State: Una forma sencilla de marcar un artículo como Approved, Awaiting Moderation o Rejected. El estado de moderación solo se puede modificar en un artículo publicado.
Campos de lote de Catalog V2
Cuando selecciona Catalog V2, abre la pestaña Bundles y elige NEW BUNDLE, abrirá la página New Bundle. Esta página contiene todos los campos de los campos de artículo de Catalog V2, además de estos campos:-
ITEMS
- Add: Los lotes le permiten agrupar varios artículos en un único artículo. Puede crear lotes de artículos que suelen comprarse juntos, o de artículos que solo están disponibles por tiempo limitado. Para obtener más información, consulte nuestra documentación sobre los lotes de Economy V2.
-
MARKETPLACE MAPPING
- Marketplace, Marketplace ID: Puede vincular su artículo del juego a uno o varios artículos de marketplace para escenarios de canje. Para obtener más información, consulte nuestra documentación sobre las compras desde la aplicación de Economy V2.
Campos de tienda de Catalog V2
Cuando selecciona Catalog V2, abre la pestaña Stores y elige NEW STORE, abrirá la página New Store. Las tiendas contienen los mismos campos que los campos de artículo de Catalog V2, además de este campo:- ITEMS
- Add: Las tiendas pueden contener cualquier otro tipo de artículo del catálogo. Todo el contenido del catálogo conservará su costo base o se podrá comprar en esta tienda por los precios indicados aquí. Para obtener más información, consulte nuestra documentación sobre las tiendas de Economy V2.