View a markdown version of this page

Trabaje con sus ID de atribución de ingresos - AWS Centro de socios
¿Qué es un identificador de atribución de ingresos?Trabajando con tus ID de atribución de ingresos

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.

Trabaje con sus ID de atribución de ingresos

Un identificador de atribución de ingresos es un identificador a nivel de oferta que asigna los ingresos por productos de AWS Marketplace a oportunidades específicas de AWS Marketplace Offers and/or AWS Partner Central. Se basa en la implementación de Partner Revenue Measurement (PRM) a nivel de producto: 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 costes 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 gestionar sus entradas de asignación de costes mensuales de forma asíncrona.

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

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

  • La atribución es un recurso denominado y descrito por el socio identificado por un identificador de ra- prefijo (por ejemplo,) y un ARN. ra-aabbccddee001 El ámbito de cada atribución es a (para producción, para pruebasCatalog) y AWS para la cuenta del socio. Sandbox

  • Una o más entradas de asignación de costes mensuales, cada entrada asigna una única combinación (identificador de oferta o identificador de oportunidad, mes de facturación) a un porcentaje de asignación de costes. Las entradas se gestionan en lotes de forma asíncrona mediante un patrón de tareas de asignación.

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

  • Como una superposición a nivel de negocio de su implementación de PRM a nivel de producto existente. Cree un identificador de atribución de ingresos, asocie las oportunidades de and/or ACE de Marketplace Offers correspondientes y AWS asigne los ingresos por productos ya medidos a esas ofertas específicas; no es necesario cambiar las etiquetas de recursos ni las cadenas de agentes de usuario existentes.

  • Como identificador independiente, se usa directamente como un valor de etiqueta de recurso (aws-apn-id=<RA ID>) o en una cadena de agente de usuario (APN_1.1/pc_<RA ID>$) para atribuir el AWS consumo a una oferta específica desde el principio.

Trabajando con tus ID de atribución de ingresos

Los socios pueden gestionar los identificadores de atribución de ingresos y sus registros de asignación de costes mensuales a través del Servicio de atribución de ingresos. El ciclo de vida progresa a través de dos flujos independientes: el flujo de registro de atribuciones (crear, actualizar, recuperar, enumerar) y el flujo de asignaciones (iniciar una tarea por lotes, sondear los resultados, recuperar entradas individuales o enumerar las entradas para una atribución).

Crear 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. Se devuelve Id y se Arn puede usar inmediatamente como un valor de etiqueta de recurso o en una cadena de agente de usuario para atribuir el consumo.AWS

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

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

  • Name— un nombre legible para las personas para la atribución. Debe ser único en el catálogo y en la cuenta del socio. 128 caracteres como máximo.

Los socios pueden proporcionar, de forma opcional:

  • Description— descripción en texto libre de la atribución. Máximo 1024 caracteres.

  • MarketplaceProduct— el producto de AWS Marketplace que se asociará a esta atribución. Proporcione ProductIdentifier (el identificador de producto de Marketplace de 25 caracteres) y TenancyModel (MULTI_TENANToSINGLE_TENANT). Si se omite en el momento de la creación, la atribución se aplica a todo el consumo medido con el Revenue Attribution ID, independientemente del producto de Marketplace que haya comprado el cliente, lo que resulta útil cuando una sola implementación abarca más de un listado de Marketplace.

  • Tags— hasta 200 pares clave-valor para la organización de los recursos. Las claves de las etiquetas deben ser únicas en la solicitud.

Práctica recomendada: envíala MarketplaceProduct.ProductIdentifier siempre que tu oferta esté vinculada a un anuncio específico 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 Partner Account Connection (PAC) y muestra lo resuelto ProductCode y ProductType (por ejemploSaaS,AMI,ML) en la respuesta. Si el producto no es propiedad de una cuenta autorizada, la API se devuelve ValidationException con el motivoPRODUCT_NOT_FOUND_OR_NOT_OWNED.

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

Añadir entradas de asignación de costes mensuales

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

Cada entrada de asignación especifica:

  • ID de oferta o ID de oportunidad: el identificador único de la oferta que se está asociando. Si una oferta de Marketplace ya está vinculada a una oportunidad ACE, los socios solo tienen que proporcionar el identificador de la oferta; los ingresos AWS se atribuyen automáticamente a la oportunidad vinculada.

  • Mes de facturación: mes natural al que se aplica la asignación de costes (por ejemplo,2026-04).

  • % de asignación de costes: parte del AWS consumo total del producto atribuible a esta oferta en este mes de facturación. Necesario para los productos SaaS multiusuario, incluidos los componentes alojados por socios para implementaciones híbridas, en las que los clientes comparten infraestructura.

  • ID de AWS cuenta de cliente: la AWS cuenta del cliente que consume el producto. Necesario para los productos SaaS multiusuario.

El porcentaje total de asignación de costes en 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 asíncrona con un código de error por registro.

Validación sincrónica: StartRevenueAttributionAllocationsTask realiza la validación de formas básicas 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 (controles de límites, reglas de inmutabilidad, búsquedas de dependencias en Marketplace y ACE) se ejecuta de forma asíncrona y se descubren los resultados por registro. GetRevenueAttributionAllocationsTask

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

  • TaskStatus— IN_PROGRESSCOMPLETED, o FAILED (error en una tarea de nivel superior).

  • RecordResults— para cada registro de entrada: el asignado AllocationId (si se ha realizado correctamente), el estado por registro (SUCCEEDEDoFAILED) y un código de error estructurado y un mensaje si el registro ha fallado.

Los socios deben recuperar los resultados de las tareas con prontitud. Una vez completada la tarea, se pueden conciliar los resultados por registro y cualquier entrada fallida se puede corregir y volver a enviar en una nueva tarea.

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

Los registros de asignación de costes se gestionan por mes de facturación con estas reglas:

  • Los socios pueden añadir una nueva entrada mensual para el mes de facturación actual o para cualquier mes futuro en cualquier momento.

  • Los socios pueden actualizar una entrada mensual para el mes de facturación actual o para cualquier mes futuro en cualquier momento.

  • Los socios pueden actualizar la entrada del mes anterior hasta el día 7 del mes actual. Esta ventana permite a los socios revisar el uso real en AWS Cost Explorer antes de finalizar la asignación del mes anterior.

Después del día 7 del mes actual, la atribución del mes de facturación anterior ya no se puede modificar. 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 retroactivamente.

Las actualizaciones de las entradas de asignación se envían mediante la misma acción de la StartRevenueAttributionAllocationsTask API y Operation se establece 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 un 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í mismo es inmutable (Name,MarketplaceProduct,) y los valores de etiquetar al crear no se pueden cambiar una vez creados. Para volver a etiquetar el recurso, usa las operaciones de AWS etiquetado estándar en el ARN de la atribución.

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

  • Catalog— AWS o. Sandbox

  • Identifier— el ra- ID de la atribución que se va a actualizar.

  • Version— la versión actual de la atribución para un bloqueo optimista.

Los socios pueden proporcionar opcionalmente:

  • Description— la descripción de texto libre actualizada. Máximo 1024 caracteres.

  • ClientToken— un token de idempotencia para la actualización.

Bloqueo optimista: el Version 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 envía un mensaje con los números de versión actual y enviada. La mejor práctica es recuperar la última versión GetRevenueAttribution antes de cada actualización.

Ver los detalles del ID de atribución de ingresos

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

Metadatos del recurso:

  • Identificador único (Id) y nombre de recurso de Amazon (Arn).

  • El lugar Catalog en el que existe la atribución.

  • Name y Description.

  • La recuperada Version y la LatestVersion (utilice la última para las actualizaciones posteriores).

Atributos de los productos de Marketplace (si MarketplaceProduct se establecieron en el momento de la creación):

  • ProductId— el identificador de producto de Marketplace proporcionado por el socio.

  • ProductCode— el código de producto de AWS Marketplace resuelto desdeProductId.

  • ProductType—SaaS,AMI, ContainerML,Data, oProfessional Services.

  • TenancyModel— MULTI_TENANT oSINGLE_TENANT.

Información de auditoría:

  • CreatedDate y LastModifiedDate.

Los socios pueden, si lo desean, proporcionar una información específica Version en la solicitud para recuperar una versión histórica de la atribución. Omita Version devolver la última.

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

Mostrar los identificadores de atribución de ingresos

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 atribuciones con funciones de filtrado y clasificación.

Los socios pueden filtrar los resultados por:

  • Catalog— AWS o Sandbox (obligatorio).

  • Identifiers— una lista de hasta 100 ra- identificaciones específicas para recuperar.

  • CreatedAfter/CreatedBefore— filtrar por intervalo de marcas de tiempo de creación (incluido).

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

  • SortBy— CreatedDate oLastModifiedDate.

  • SortOrder— ASCENDING oDESCENDING.

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

Utilice MaxResults (por defecto 25, máximo 100) y NextToken para paginar conjuntos de resultados de gran tamaño. 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 costes mensuales para un identificador 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 por:

  • MarketplaceOfferId— enumerar solo las entradas asociadas a una oferta de Marketplace específica.

  • AwsPartnerCentralOpportunityId— enumere únicamente las entradas asociadas a una oportunidad específica de Partner Central.

  • BillingMonth— enumerar únicamente las entradas de un mes natural específico.

La respuesta incluye información resumida para cada entrada: el AllocationId identificador de oferta o de oportunidad asociado, el identificador de 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 fechas de auditoría.

Creación de un panel de control: la combinación de ListRevenueAttributions y ListRevenueAttributionAllocations está diseñada para facilitar la creación del panel de control de los socios. Los socios pueden crear vistas como las siguientes:

  • Todos los ID de atribución de ingresos creados en los últimos 30 días, ordenados por fecha de creación.

  • Todas las entradas de asignación de costes mensuales para una oferta de Marketplace específica en varios ID de atribución de ingresos.

  • Todos los registros de asignación de costes del mes de facturación actual, para validar que los totales no superen el 100% por atribución.

  • Todos los ID de atribución de ingresos que tengan al menos una entrada de asignación activa (). TotalRevenueAttributionAssociationCount > 0