View a markdown version of this page

¿Trabajas con tus porcentajes de ingresos de Marketplace? - AWS Centro de socios
¿Qué es un reparto de ingresos de Marketplace?Trabaje con sus porcentajes de ingresos de MarketplaceEtiquetado de las participaciones en los ingresos del mercado

Se reestructuró la referencia de la Centro de socios de AWS API. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia de la Centro de socios de AWS API.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

¿Trabajas con tus porcentajes de ingresos de Marketplace?

Un reparto de ingresos de Marketplace es un insumo para un producto de AWS Marketplace en el que se declara la parte de los ingresos totales del producto recaudada a través de AWS Marketplace. AWS utiliza esta información para correlacionar los Marketplace-collected ingresos de un socio con otras señales de ingresos.

El servicio de reparto de ingresos de Marketplace expone las API para crear, recuperar y enumerar los recursos de reparto de ingresos de Marketplace y para gestionar sus asignaciones (los porcentajes de reparto de ingresos declarados por el socio y los períodos de entrada en vigor). El recurso de reparto de ingresos de AWS Marketplace admite las operaciones de etiquetado estándar.

¿Qué es un reparto de ingresos de Marketplace?

Un reparto de ingresos de Marketplace tiene dos niveles:

  • La acción: una entrada para un único producto de AWS Marketplace, identificado por el MarketplaceProductId. Hay exactamente un reparto de ingresos de Marketplace por producto.

  • Una o más asignaciones: cada asignación declara una ventana de fecha de entrada en vigor RevenueSharePercent y una fecha de entrada en vigor (EffectiveDateopcionalExpirationDate). Una acción puede tener muchas asignaciones a lo largo del tiempo, pero en cualquier momento solo se puede aplicar una ACTIVE asignación.

Las asignaciones tienen las siguientes propiedades clave:

  • Estado — ACTIVE o. INACTIVE En el momento de la creación, el estado predeterminado es. ACTIVE Solo ACTIVE las asignaciones participan en los cálculos de ingresos y se superponen en las verificaciones.

  • Superposición invariable: dentro de una sola acción, no es posible que dos ACTIVE asignaciones tengan rangos superpuestos. [EffectiveDate, ExpirationDate] Como máximo, se permite una ACTIVE asignación indefinida (noExpirationDate) por acción en cualquier momento.

Trabaje con sus porcentajes de ingresos de Marketplace

Los socios administran los ingresos compartidos de Marketplace y sus asignaciones a través del servicio de reparto de ingresos de Marketplace. El ciclo de vida se desarrolla a través de dos flujos: el flujo de acciones (crear, recuperar, listar, etiquetar) y el flujo de asignaciones (crear, actualizar, eliminar temporalmente, recuperar, listar).

Creación de un reparto de ingresos en Marketplace

El primer paso es crear un reparto de ingresos de Marketplace para un producto de AWS Marketplace mediante la acción de la CreateMarketplaceRevenueShare API. La acción es identificada por el Marketplace ProductId y sirve de contenedor para todas las asignaciones posteriores.

Al crear un reparto de ingresos en Marketplace, los socios deben proporcionar:

  • Catalog— AWS para producción o Sandbox para pruebas.

  • ProductId— el identificador de producto de 25 caracteres de Marketplace. Patrón:[a-z0-9]{25}.

Los socios pueden proporcionar opcionalmente:

  • Tags— hasta 50 pares clave-valor para la organización de los recursos en el momento de la creación. Se usa TagResource para agregar etiquetas después de la creación.

  • ClientToken— un token de idempotencia para evitar que se dupliquen creaciones al volver a intentarlo. 64 caracteres como máximo. Los SDK generan automáticamente este token.

Validación del producto: al crearlo, el servicio verifica con AWS Marketplace que el producto es propiedad de la cuenta de la persona que llama o de una cuenta subsidiaria conectada a la persona que llama a través de una conexión de cuenta de socio (PAC). Si el producto no existe o la cuenta del propietario no está autorizada para la persona que llama, la API responde con motivo. ValidationException PRODUCT_NOT_FOUND_OR_NOT_OWNED

Una acción por producto: una segunda solicitud CreateMarketplaceRevenueShare para obtener lo mismo ProductId en las mismas Catalog devolucionesConflictException.

La respuesta devuelve la acción Arn (formatoarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}) CatalogProductId, el Version número inicial (que comienza en 1 y aumenta con cada mutación de asignación) y cualquier etiqueta aplicada en el momento de la creación.

Añadir asignaciones

Una vez que se crea un reparto de ingresos de Marketplace, los socios declaran un porcentaje de reparto de ingresos y un período de entrada en vigor mediante la creación de una asignación mediante la acción de la API. CreateMarketplaceRevenueShareAllocation

Al crear una asignación, los socios deben proporcionar:

  • Catalog— AWS oSandbox.

  • MarketplaceRevenueShareIdentifier— el identificador de la acción matriz.

  • RevenueSharePercent— el porcentaje de los ingresos del producto recaudados a través de Marketplace expresado en decimal (por ejemplo, 0.45 para el 45%).

  • EffectiveDate— la fecha natural en la que entra en vigor esta asignación. Formato: YYYY-MM-DD.

La respuesta muestra la asignación Id (formatomrsa-[A-Za-z0-9]{13}), el estado de la asignación (ACTIVEen el momento de la creación) y la del recurso compartido principal Version (cada mutación de la asignación asigna un entero de versión único por recurso compartido, que se utiliza para bloquear de forma optimista las actualizaciones de asignación posteriores).

Actualización de las asignaciones

Los socios pueden actualizar una asignación mediante la acción de la UpdateMarketplaceRevenueShareAllocation API. Los campos actualizables dependen de si la asignación tiene una fecha futura, está en vigor actualmente o es una fecha pasada.

Al actualizar una asignación, los socios deben proporcionar:

  • Catalog— AWS oSandbox.

  • MarketplaceRevenueShareIdentifier— el identificador de la acción matriz.

  • AllocationId— el mrsa- ID de la asignación que se va a actualizar.

  • MarketplaceRevenueShareVersion— la versión actual de la acción principal para fijar la asignación de forma optimista. ConflictExceptionVuelven los conflictos repentinos.

De manera opcional, los socios pueden proporcionar:

  • RevenueSharePercent— el porcentaje de participación en los ingresos actualizado. Solo se puede editar en las asignaciones con fecha futura.

  • EffectiveDate— la fecha de entrada en vigor actualizada. Solo se puede editar en las asignaciones con fecha futura.

  • ExpirationDate— la fecha de caducidad actualizada. Se puede editar en las asignaciones con fecha futura (cualquier valor> EffectiveDate) y en las asignaciones actualmente en vigor o indefinidas (cualquier valor). ≥ today

  • StatusINACTIVE— o. ACTIVE Si se establece en esta opciónINACTIVE, se borra temporalmente la asignación. Solo se puede editar en asignaciones con fecha futura.

  • ClientToken— un token de idempotencia.

Ver los detalles del reparto de ingresos de Marketplace

Los socios pueden recuperar la información completa de un único reparto de ingresos de Marketplace mediante la acción de la GetMarketplaceRevenueShare API. Esto devuelve la acciónArn, CatalogProductId, Version (la versión actual de la acción principal) y cualquier etiqueta que se haya aplicado a la acción. CreatedDate LastModifiedDate

Los socios pueden recuperar una sola asignación mediante la acción de la GetMarketplaceRevenueShareAllocation API junto con la asignaciónId. Esto muestra:

  • La asignación Id y las acciones principalesMarketplaceRevenueShareArn.

  • RevenueSharePercent, EffectiveDate, ExpirationDate.

  • Status(ACTIVEoINACTIVE).

  • La principal es MarketplaceRevenueShareVersion para fijar de forma optimista las actualizaciones posteriores.

  • CreatedDate y LastModifiedDate.

Cotización de acciones de ingresos del mercado

Los socios pueden ver todos los porcentajes de ingresos de Marketplace que pertenecen a su cuenta mediante la acción de la ListMarketplaceRevenueShares API. Esto devuelve una lista paginada de resúmenes de acciones.

Los socios pueden filtrar los resultados por:

  • Catalog— AWS o Sandbox (obligatorio).

  • ProductIds— una lista de los identificadores de productos específicos de Marketplace que se deben recuperar.

La respuesta incluye un resumen de cada acción: ArnCatalog,ProductId,, la última VersionCreatedDate, yLastModifiedDate.

Utilice MaxResults y NextToken para paginar conjuntos de resultados de gran tamaño.

Listar las asignaciones

Los socios pueden enumerar las asignaciones para un reparto de ingresos específico de Marketplace mediante la acción de la ListMarketplaceRevenueShareAllocations API. Esto devuelve una lista paginada de resúmenes de asignaciones con funciones de filtrado.

Los socios pueden filtrar los resultados según:

  • Status— ACTIVE oINACTIVE.

  • Intervalo de fechas de entrada en vigor —EffectiveDateOnOrAfter/EffectiveDateOnOrBeforepara recuperar las asignaciones cuya fecha de entrada en vigor se encuentre dentro de un período específico.

La respuesta incluye información resumida para cada asignación:Id,,, RevenueSharePercent EffectiveDate ExpirationDate StatusMarketplaceRevenueShareVersion, y las marcas de tiempo de la auditoría.

Etiquetado de las participaciones en los ingresos del mercado

Las operaciones de AWS etiquetado estándar son compatibles con el recurso de reparto de ingresos de Marketplace:

  • TagResource— añadir o sobrescribir etiquetas en un reparto de ingresos de Marketplace. Máximo 50 etiquetas por acción.

  • UntagResource— eliminar etiquetas específicas mediante clave.

  • ListTagsForResource— recuperar todas las etiquetas que se aplican actualmente a una participación en los ingresos de Marketplace.

Las asignaciones no admiten etiquetas. Etiquete el recurso compartido principal para organizar las asignaciones relacionadas.

Cada operación de etiquetado acepta el Arn (formatoarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}) del recurso compartido como identificador del recurso. La AWS etiqueta estándar al crear también se admite mediante el campo on. Tags CreateMarketplaceRevenueShare