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.

¿Estás trabajando con tus ID de atribución de ingresos

Un identificador de atribución de ingresos es un identificador a nivel de oferta que asigna los ingresos de tus productos de AWS Marketplace a ofertas and/or AWS específicas de Marketplace y oportunidades de AWS Partner Central. Se basa en la implementación de la medición de ingresos de los socios (PRM) a nivel de producto: el PRM captura los ingresos totales atribuidos a un producto de Marketplace y un identificador de atribución de ingresos asigna esos ingresos a ofertas específicas de acuerdo con los porcentajes de asignación de costos mensuales que especifiques.

El servicio de atribución de ingresos expone las API para crear, recuperar, enumerar y actualizar los ID de atribución de ingresos y para gestionar sus entradas mensuales de asignación de costes de forma asincrónica.

¿Qué es un identificador de atribución de ingresos?

Un ID de atribución de ingresos tiene dos capas:

Un identificador de atribución de ingresos se puede utilizar de dos maneras:

¿Estás trabajando con tus ID de atribución de ingresos?

Los socios pueden gestionar los ID de atribución de ingresos y sus entradas de asignación de costes mensuales a través del Servicio de atribución de ingresos. El ciclo de vida se desarrolla a través de dos flujos independientes: el flujo de atribución y registro (crear, actualizar, recuperar, listar) y el flujo de asignaciones (iniciar una tarea por lotes, realizar una encuesta para obtener resultados, recuperar entradas individuales, listar entradas para una atribución).

Creación de un identificador de atribución de ingresos

El primer paso es crear un ID de atribución de ingresos mediante la acción de la CreateRevenueAttribution API. El valor devuelto Id Arn puede usarse inmediatamente como un valor de etiqueta de recurso o en una cadena de usuario-agente para atribuir el consumo. AWS

Al crear un ID de atribución de ingresos, los socios deben proporcionar:

De manera opcional, los socios pueden proporcionar:

Práctica recomendada: MarketplaceProduct.ProductIdentifier indícalo siempre que tu oferta esté vinculada a una ficha específica de Marketplace. Esto permite AWS comprobar que el producto es propiedad de la cuenta del socio que realiza la llamada o de una cuenta subsidiaria conectada a través de una conexión de cuenta de socio (PAC), y muestra la ProductCode letra y ProductType (por ejemplo, SaaSAMI,ML) resuelta en la respuesta. Si el producto no pertenece a una cuenta autorizada, la API se devuelve ValidationException con motivoPRODUCT_NOT_FOUND_OR_NOT_OWNED.

La respuesta devuelve los MarketplaceProduct atributos nuevos Id (formatora-[a-z0-9]{13})Arn, resueltos y el Version número inicial (que comienza en 1 y aumenta en cada actualización posterior).

Agregar entradas de asignación de costos mensuales

Una vez que se crea un identificador de atribución de ingresos, los socios asocian AWS Marketplace Offers and/or ACE Opportunities con él enviando un lote de entradas de asignación de costos mensuales a través de la acción de la StartRevenueAttributionAllocationsTask API. Se trata de una operación asincrónica que acepta hasta 250 cambios de asignación () CREATE and/or UPDATE por tarea.

Cada entrada de asignación especifica:

El% total de asignación de costes entre todas las entradas de asignación para un identificador de atribución de ingresos determinado y el mismo mes de facturación no debe superar el 100%. Si el total supera el 100%, la entrada infractora se rechaza durante la validación empresarial asincrónica con un código de error por registro.

Validación sincrónica: StartRevenueAttributionAllocationsTask realiza la validación básica de formas de forma sincrónica (tipos de campo, patrones, tamaño de lote). Si se aprueba la validación básica, la API devuelve un estado TaskId con. IN_PROGRESS La validación empresarial (comprobaciones de límites máximos, reglas de inmutabilidad, búsquedas de dependencias en Marketplace y ACE) se ejecuta de forma asincrónica y los resultados por registro se descubren mediante. GetRevenueAttributionAllocationsTask

Para supervisar una tarea enviada, los socios realizan una encuesta GetRevenueAttributionAllocationsTask con el identificador de recurso de atribución de ingresos o ARN. La respuesta avanza de IN_PROGRESS a COMPLETED (independientemente de si los registros individuales se han realizado correctamente o no) y devuelve:

Los socios deben recuperar los resultados de las tareas con prontitud. Una vez finalizada la tarea, los resultados de cada registro se pueden conciliar y las entradas fallidas se pueden corregir y volver a enviar en una nueva tarea.

Edición de las entradas de asignación de costos mensuales

Las entradas de asignación de costos se administran por mes de facturación con estas reglas:

Después del día 7 del mes actual, ya no se podrá modificar la atribución del mes de facturación anterior. Las actualizaciones de la entrada de un mes actual o futuro se aplicarán a partir del siguiente ciclo de facturación mensual. La atribución histórica de los meses anteriores no se recalcula de forma retroactiva.

Las actualizaciones de las entradas de asignación se envían mediante la misma acción de la StartRevenueAttributionAllocationsTask API, con el valor Operation establecido en UPDATE para cada entrada afectada. El patrón de tareas asíncronas gestiona las actualizaciones y las creaciones de manera uniforme.

Actualización de un identificador de atribución de ingresos

Los socios pueden actualizar el ID Description de atribución de ingresos existente mediante la acción de la UpdateRevenueAttribution API. Por lo demás, el registro de atribución en sí es inmutable:Name,MarketplaceProduct, y los valores de la etiqueta al crear no se pueden cambiar después de la creación. Para volver a etiquetar el recurso, usa las operaciones de AWS etiquetado estándar en el ARN de la atribución.

Al actualizar un ID de atribución de ingresos, los socios deben proporcionar:

De manera opcional, los socios pueden proporcionar:

Bloqueo optimista: Version este campo garantiza que las actualizaciones solo se apliquen si la atribución no ha cambiado desde la última vez que se recuperó. Si la información enviada Version no coincide con la versión actual del recurso, se rechaza la actualización ConflictException y se muestra un mensaje con los números de versión actual y enviada. La mejor práctica es recuperar la versión más reciente GetRevenueAttribution antes de cada actualización.

Visualización de los detalles del identificador de atribución de ingresos

Los socios pueden recuperar la información completa de un único ID de atribución de ingresos mediante la acción de la GetRevenueAttribution API. Esto muestra:

Metadatos de recursos:

Atributos del producto de Marketplace (si MarketplaceProduct se configuraron en el momento de la creación):

Información de auditoría:

Los socios pueden, de forma opcional, proporcionar una información específica Version en la solicitud para recuperar una versión histórica de la atribución. Omite Version devolver la versión más reciente.

Para recuperar una entrada de asignación de costos mensual específica, los socios utilizan la acción de la GetRevenueAttributionAllocation API junto con la AllocationId entrada. Esto muestra el ID de la oferta o el ID de oportunidad, el mes de facturación, el% de asignación de costos, el ID de la AWS cuenta del cliente y la información de estado y auditoría de la entrada.

ID de atribución de ingresos del anuncio

Los socios pueden ver todos los ID de atribución de ingresos de su cuenta mediante la acción de la ListRevenueAttributions API. Esto devuelve una lista paginada de resúmenes de atribución con funciones de filtrado y clasificación.

Los socios pueden filtrar los resultados según:

Los socios pueden configurar la clasificación de los resultados mediante el Sort parámetro:

La respuesta incluye un resumen de cada atribución:Arn,,, Id CatalogName, MarketplaceProduct los atributos resueltos, CreatedDateLastModifiedDate, los más recientes Version y TotalRevenueAttributionAssociationCount (el número de entradas de asignación de costes mensuales activas vinculadas a la atribución).

MaxResultsUtilízalo (25 por defecto, 100 como máximo) y NextToken para paginar grandes conjuntos de resultados. La respuesta incluye un NextToken si hay páginas adicionales disponibles.

Listar las entradas de asignación de costos mensuales

Los socios pueden enumerar las entradas de asignación de costos mensuales para un ID de atribución de ingresos específico mediante la acción de la ListRevenueAttributionAllocations API. Esto devuelve una lista paginada de resúmenes de asignación con funciones de filtrado.

Los socios pueden filtrar los resultados según:

La respuesta incluye información resumida de cada entrada: el identificador de la AllocationId oferta o el identificador de oportunidad asociados, el identificador de la AWS cuenta del cliente, el mes de facturación, el porcentaje de asignación de costes, el nombre y el estado de la entrada y las marcas de tiempo de la auditoría.

Creación de paneles: la combinación de ListRevenueAttributions y ListRevenueAttributionAllocations está diseñada para facilitar la creación de paneles para socios. Los socios pueden crear puntos de vista como: