Termos e condições Guia de integração Guia de implementação técnica Documentação técnica Solução de problemas

AWS Marketplace Serviço de análise de comércio

O AWS Marketplace Commerce Analytics Service permite que você acesse programaticamente dados de produtos e clientes por meio de. AWS Marketplace Depois de se inscrever no serviço, você pode acessar seus relatórios de uso, assinatura e cobrança por meio do. AWS SDK

Commerce Analytics Service Overview.

Os dados que você solicita usando as SDK ferramentas são entregues a você Conta da AWS como conjuntos de dados. A maioria dos conjuntos de dados corresponde aos mesmos dados dos relatórios baseados em texto disponíveis no Portal de gerenciamento do AWS Marketplace. Você pode solicitar conjuntos de dados para uma data específica, e os dados serão entregues ao bucket do Amazon S3 fornecido. A notificação da entrega de dados é fornecida pelo Amazon Simple Notification Service (AmazonSNS).

Termos e condições

Estes Termos e Condições do AWS Marketplace Commerce Analytics Service (estes “CASTermos”) contêm os termos e condições específicos de seu uso e acesso ao AWS Marketplace Commerce Analytics Service (“Serviço da CA”) e entram em vigor a partir da data em que você clica no botão “Aceito” ou na caixa de seleção apresentada com estes CAS Termos ou, se for anterior, quando você usar qualquer oferta do CA Service. Estes CAS Termos são um adendo aos Termos e Condições para AWS Marketplace Vendedores (os “Termos do AWS Marketplace Vendedor”) entre você e a Amazon Web Services AWS, Inc. (”,” “nós” ou “nosso”), cujos termos estão aqui incorporados. No caso de um conflito entre estes CAS Termos e os Termos do AWS Marketplace Vendedor, os termos e condições destes CAS Termos se aplicam, mas somente na medida do conflito e somente com relação ao seu uso do Serviço da CA. Os termos em maiúsculas usados aqui, mas não definidos aqui, terão os significados estabelecidos nos Termos do AWS Marketplace Vendedor.

Serviços e CAS dados da CA. Para se qualificar para o acesso ao Serviço da CA, você deve ser um AWS Marketplace vendedor vinculado aos Termos do AWS Marketplace Vendedor existentes. As informações e os dados que você recebe ou aos quais tem acesso em conexão com o Serviço da CA (“CASDados”) constituem Informações do Assinante e estão sujeitos às restrições e obrigações estabelecidas nos Termos do AWS Marketplace Vendedor. Você pode usar CAS os Dados de forma confidencial para melhorar e direcionar o marketing e outras atividades promocionais relacionadas ao Seu AWS Marketplace Conteúdo, desde que (a) divulgue CAS Dados a terceiros; (b) use quaisquer CAS Dados de qualquer forma inconsistente com as políticas ou leis de privacidade aplicáveis; (c) entre em contato com um assinante para influenciá-lo a fazer uma compra alternativa fora do AWS Marketplace; (d) menosprezar a nós, nossas afiliadas ou qualquer um de seus respectivos produtos; ou (e) direcionar comunicações de qualquer tipo com base no o destinatário pretendido é um AWS Marketplace assinante.
Limitações e segurança do serviço CA. Você só acessará (ou tentará acessar) o serviço CA pelos meios descritos na documentação do serviço CA. Você não vai deturpar nem encobrir a sua identidade ou a identidade do seu cliente ao usar o serviço CA. Reservamos o direito, a nosso critério, de definir e impor limites para o uso do serviço CA, incluindo, sem limitação, em relação ao número de conexões, chamadas e servidores permitidos para acessar o serviço CA durante qualquer período. Você concorda com, e não tentará contornar tais limitações. Reservamo-nos o direito de restringir, suspender ou rescindir seu direito de acessar o Serviço da CA se acreditarmos que você possa estar violando estes CAS Termos ou fazendo uso indevido do Serviço da CA.
Confidencialidade e segurança de credenciais do serviço CA. As credenciais do CA Service (como senhas, chaves e clienteIDs) devem ser usadas por você para identificar seu API cliente. Você é o único responsável por manter suas credenciais confidenciais e tomará todas as medidas razoáveis para evitar a divulgação, disseminação ou uso não autorizado de tais credenciais, incluindo, no mínimo, as medidas executadas para proteger suas próprias informações confidenciais semelhantes. As credenciais do serviço CA não podem ser incorporadas em projetos de código aberto. Você é o único responsável por todo e qualquer acesso ao serviço CA com suas credenciais.
Modificação. Podemos modificar estes CAS Termos a qualquer momento publicando uma versão revisada no AWS Site ou enviando um aviso a você de acordo com os Termos do AWS Marketplace Vendedor. Os termos modificado entrarão em vigor após a publicação ou, se você receber uma notificação por e-mail, conforme indicado na mensagem de e-mail. Ao continuar usando ou acessando o Serviço da CA após a data de vigência de qualquer modificação a estes CAS Termos, você concorda em se comprometer com os termos modificados.
Terminação. Estes CAS Termos e os direitos de uso dos CAS Dados aqui concedidos serão rescindidos, com ou sem aviso prévio, após a rescisão dos Termos do AWS Marketplace Vendedor por qualquer motivo. Além disso, poderemos parar de fornecer os serviços CA ou encerrar o seu acesso aos serviços CA a qualquer momento por qualquer ou nenhum motivo.

Guia de integração

Você deve configurar seu Conta da AWS e Serviços da AWS para usar o AWS Marketplace Commerce Analytics Service.

Para usar o AWS Marketplace Commerce Analytics Service

Configure seu Conta da AWS com permissões.
Criar um bucket do Amazon S3 de destino.
Configurar um SNS tópico da Amazon para notificações de resposta.
Inscreva-se no programa Serviço de análise de comércio.
Verificar sua configuração.

Configure seu Conta da AWS com permissões

AWS Marketplace recomenda fortemente o uso de funções AWS Identity and Access Management (IAM) para fazer login em Portal de gerenciamento do AWS Marketplace vez de usar as credenciais da sua conta raiz. Consulte Políticas e permissões para vendedores do AWS Marketplace para obter IAM permissões específicas para as permissões AWS Marketplace do Commerce Analytics Service. Ao criar usuários individuais para as pessoas que acessam a sua conta, você pode dar a cada usuário um conjunto exclusivo de credenciais de segurança. Você também pode conceder permissões diferentes para cada usuário . Se necessário, você poderá alterar ou revogar as permissões de um usuário do a qualquer momento.

Criar um bucket do Amazon S3 de destino

O Serviço de análise de comércio fornecerá os dados que você solicitar a um bucket do Amazon S3 que você especificar. Se você já tem um bucket do Amazon S3 para ser usado, passe para a próxima etapa.

Se você não tiver um bucket do Amazon S3 ou desejar criar um bucket do Amazon S3 especificamente para esses dados, consulte as orientações em Como criar um bucket do S3.

O Commerce Analytics Service fornece notificações de resposta usando a AmazonSNS. O serviço publicará mensagens nesse tópico para informar quando seus conjuntos de dados estiverem disponíveis ou quando tiver ocorrido um erro. Se você já tem um SNS tópico da Amazon para essa finalidade, vá para a próxima etapa.

Se você não tiver um SNS tópico da Amazon configurado para esse serviço, configure um agora. Para obter instruções, consulte Criar um tópico.

Registre o tópico Amazon Resource Name (ARN) para o tópico que você criou, pois ARN é necessário chamar o serviço.

Inscreva-se no programa Serviço de análise de comércio

O Commerce Analytics Service acessa o bucket do Amazon S3 e o tópico SNS da Amazon depois que você configura o serviço com ARN o para o tópico e o nome do bucket.

Para habilitar o acesso

Faça login no Portal de gerenciamento do AWS Marketplacecom o Conta da AWS que você usa para gerenciar seus AWS Marketplace produtos.
Verifique se você tem as IAMpermissões necessárias para se inscrever no AWS Marketplace Commerce Analytics Service.
Navegue até a página de inscrição no Serviço de análise de comércio.
Insira o nome do bucket do Amazon S3 e o SNS tópico da Amazon e escolha ARN Inscrever-se.
Na página de permissões, escolha Allow (Permitir).
No Portal de gerenciamento do AWS Marketplace, registre o nome da função ARN na mensagem de sucesso. Você precisa ligar ARN para o serviço.

nota

A integração com o Commerce Analytics Service cria uma IAM função em seu Conta da AWS. A IAM função permite AWS Marketplace gravar no bucket do Amazon S3 e publicar notificações no tópico da AmazonSNS. AWS Marketplace usa a conta 452565589796 para realizar essas ações associadas a essa função. IAM

Verificar sua configuração

A última etapa é verificar se a configuração está sendo executada conforme o esperado.

Para testar sua configuração

Baixe, instale e configure a interface de linha de AWS comando (AWS CLI).

Usando o AWS CLI, execute este comando.



aws marketplacecommerceanalytics generate-data-set \
--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \
--data-set-publication-date "{TODAY'S-DATE}" \
--role-name-arn "{YOUR-ROLE-NAME-ARN}" \
--destination-s3-bucket-name "{amzn-s3-demo-bucket}" \
--destination-s3-prefix "TEST_PREFIX" \
--sns-topic-arn "{YOUR-SNS-TOPIC-ARN}"

Para--data-set-publication-date, {TODAY'S DATE} substitua pela data atual usando o formato ISO -8601,, onde YYYY é o ano de quatro dígitosYYYY-MM-DDT00:00:00Z, é o mês de dois dígitos e MM é o dia de dois dígitos. DD
Para--role-name-arn, {YOUR-ROLE-NAME-ARN} substitua pela ARN função que você recebeu do processo de inscrição emInscreva-se no programa Serviço de análise de comércio.
Para --destination-s3-bucket-name, substitua {amzn-s3-demo-bucket} pelo nome do bucket do Amazon S3 em que você criou. Criar um bucket do Amazon S3 de destino
Para — sns-topic-arn, substitua {YOUR- SNS - TOPIC -ARN} pelo SNS tópico da Amazon em que você criouConfigurar um SNS tópico da Amazon para notificações de resposta.

Se você receber uma resposta incluindo a resposta de dataSetRequestID do serviço, você concluiu o processo de integração. Uma resposta bem-sucedida é parecida com esta:



{
   "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"
}

Guia de implementação técnica

O AWS Marketplace Commerce Analytics Service é fornecido por meio do AWSSDK. Este guia demonstra como interagir com o serviço usando a AWS CLI e o AWS SDK for Java.

IAMpolíticas para o Commerce Analytics Service

Para permitir que os usuários usem o Serviço de análise de comércio, as seguintes permissões são necessárias.

Use a política de IAM permissões a seguir para se inscrever no AWS Marketplace Commerce Analytics Service.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iam:ListRoles",
                "iam:CreateRole",
                "iam:CreatePolicy",
                "iam:AttachRolePolicy",
                "aws-marketplace-management:viewReports"
            ],
            "Resource": "*"
        }
    ]
}

Use a política de IAM permissões a seguir para permitir que um usuário faça solicitações ao AWS Marketplace Commerce Analytics Service.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "marketplacecommerceanalytics:GenerateDataSet",
            "Resource": "*"
        }
    ]
}

Para obter mais informações, consulte Criação de políticas no IAM console no Guia IAM do usuário.

Fazendo solicitações com o AWS CLI

Para começar, faça download do AWS CLI. O AWS CLI exemplo a seguir faz uma solicitação para o conjunto de dados de assinaturas horárias/mensais de 1º de outubro de 2017. Esse conjunto de dados é publicado no bucket de demonstração do bucket Amazon S3 usando o prefixo demo-prefix, e a mensagem de notificação é entregue ao tópico de demonstração do tópico Amazon. SNS



aws marketplacecommerceanalytics generate-data-set \
--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \
--data-set-publication-date "2017-10-01T00:00:00Z" \
--role-name-arn "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole" \
--destination-s3-bucket-name "demo-bucket" \
--destination-s3-prefix "demo-prefix" \
--sns-topic-arn "arn:aws:sns:us-west-2:123412341234:demo-topic"

Essa solicitação retorna um identificador exclusivo para cada solicitação. Você pode usar esse identificador para correlacionar solicitações com notificações publicadas em seu SNS tópico da Amazon. Veja o exemplo a seguir desse identificador.



{
   "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"
}

Como fazer solicitações com o AWS SDK for Java

Para começar, baixe o AWSJava SDK. O AWS SDK for Java exemplo a seguir faz uma solicitação para o conjunto de dados de assinaturas horárias/mensais de 1º de outubro de 2015. Esse conjunto de dados é publicado no bucket de demonstração do bucket Amazon S3 usando o prefixo demo-prefix, e a mensagem de notificação é entregue ao tópico de demonstração do tópico Amazon. SNS



/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.TimeZone;
import com.amazonaws.AmazonClientException;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.regions.Region;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.marketplacecommerceanalytics.AWSMarketplaceCommerceAnalyticsClient;
import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetRequest;
import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetResult;
/**
* This sample demonstrates how to make basic requests to the AWS Marketplace Commerce 
* Analytics service using the AWS SDK for Java.
* <p>
* <b>Prerequisites:</b> Follow the on-boarding guide: {URL OR SOMETHING}
* <p>
* Fill in your AWS access credentials in the provided credentials file
* template, and be sure to move the file to the default location
* (~/.aws/credentials) where the sample code will load the credentials from.
* <p>
* <b>WARNING:</b> To avoid accidental leakage of your credentials, DO NOT keep
* the credentials file in your source directory.
* <p>
* http://aws.amazon.com/security-credentials
*/
public class MarketplaceCommerceAnalyticsSample {
public static void main(String[] args) throws ParseException {
/*
* The ProfileCredentialsProvider will return your [default]
* credential profile by reading from the credentials file located at
* (~/.aws/credentials).
*/
AWSCredentials credentials = null;
try {
credentials = new ProfileCredentialsProvider().getCredentials();
} catch (Exception e) {
throw new AmazonClientException("Cannot load the credentials from the credential profiles "
+ "file. Make sure that your credentials file is at the correct "
+ "location (~/.aws/credentials), and is in valid
format.", e);
}
AWSMarketplaceCommerceAnalyticsClient client = new AWSMarketplaceCommerceAnalyticsClient(credentials);
Region usEast1 = Region.getRegion(Regions.US_EAST_1);
client.setRegion(usEast1);
System.out.println("===============================================================");
System.out.println("Getting Started with AWS Marketplace Commerce Analytics Service"); 
System.out.println("===============================================================\n");
// Create a data set request with the desired parameters
GenerateDataSetRequest request = new GenerateDataSetRequest();
request.setDataSetType("customer_subscriber_hourly_monthly_subscriptions");
request.setDataSetPublicationDate(convertIso8601StringToDateUtc("2014-06-09T00:00:00Z"));
request.setRoleNameArn("arn:aws:iam::864545609859:role/MarketplaceCommerceAnalyticsRole");
request.setDestinationS3BucketName("awsmp-goldmine-seller");
request.setDestinationS3Prefix("java-sdk-test");
request.setSnsTopicArn("arn:aws:sns:us-west-2:864545609859:awsmp-goldmine-seller-topic");
System.out.println(
String.format("Creating a request for data set %s for publication date %s.",
request.getDataSetType(), request.getDataSetPublicationDate()));
try {
// Make the request to the service
GenerateDataSetResult result = client.generateDataSet(request);
// The Data Set Request ID is a unique identifier that you can use to correlate the
// request with responses on your Amazon SNS topic 
System.out.println("Request successful, unique ID: " + result.getDataSetRequestId());
} catch (AmazonServiceException ase) {
System.out.println("Caught an AmazonServiceException, which means your request made it "
+ "to the AWS Marketplace Commerce Analytics service, but was rejected with an " 
+ "error response for some reason.");
System.out.println("Error Message: " + ase.getMessage());
System.out.println("HTTP Status Code: " + ase.getStatusCode());
System.out.println("AWS Error Code: " + ase.getErrorCode());
System.out.println("Error Type: " + ase.getErrorType());
System.out.println("Request ID: " + ase.getRequestId());
} catch (AmazonClientException ace) {
System.out.println("Caught an AmazonClientException, which means the client encountered "
+ "a serious internal problem while trying to communicate with the AWS Marketplace"
+ "Commerce Analytics service, such as not being able to access the "
+ "network.");
System.out.println("Error Message: " + ace.getMessage());
}
}
private static Date convertIso8601StringToDateUtc(String dateIso8601) throws ParseException {
TimeZone utcTimeZone = TimeZone.getTimeZone("UTC");
DateFormat utcDateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssX");
utcDateFormat.setTimeZone(utcTimeZone);
return utcDateFormat.parse(dateIso8601);
}
}

Espere obter resultados semelhantes a este exemplo.



===============================================================
Getting Started with AWS Marketplace Commerce Analytics Service 
===============================================================
Creating a request for data set customer_subscriber_hourly_monthly_subscriptions for publication
date Sun Jun 08 17:00:00 PDT 2014.
Request successful, unique ID: c59aff81-6875-11e5-a6d8-fd5dbcaa74ab

Documentação técnica

O serviço expõe um método, GenerateDataSet, que permite solicitar conjuntos de dados que serão publicados em seu bucket do Amazon S3. A tabela a seguir relaciona os parâmetros de GenerateDataSet.

Parâmetros do conjunto de dados
Campo	Descrição
Tipo do conjunto de dados	Esse conjunto de dados será retornado como resultado da solicitação.
Data da publicação do conjunto de dados	A data em que um conjunto de dados foi publicado. Para conjuntos de dados diários, forneça uma data com granularidade em nível de dia para o dia desejado. Para conjuntos de dados mensais, forneça uma data com granularidade em nível de mês para o mês desejado. O valor day é ignorado.
Nome da função ARN	A ARN da função com uma política de permissões anexada que fornece ao serviço acesso aos seus recursos.
Nome do bucket do Amazon S3 de destino	O nome (o nome amigável, não oARN) do bucket Amazon S3 de destino. Seus conjuntos de dados serão publicados nesse local.
Prefixo do Amazon S3 de destino	(Opcional) O prefixo do Amazon S3 para o conjunto de dados publicado, semelhante a um caminho de diretório em sistemas de arquivos padrão. Por exemplo, se o nome do bucket `mybucket` e o prefixo `myprefix/mydatasets` forem fornecidos, o arquivo de saída será publicado em `s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile`. Se a estrutura do diretório do prefixo não existir, ela será criada. Se nenhum prefixo for fornecido, o conjunto de dados será publicado na raiz do bucket do Amazon S3.
SNSTópico ARN	O ARN SNS tópico da Amazon que é notificado quando o conjunto de dados é publicado ou ocorre um erro.

Respostas

O AWS Marketplace Commerce Analytics Service retorna duas respostas. A primeira é síncrona, que é retornada imediatamente, e a segunda é assíncrona, que é retornada usando a Amazon. SNS A resposta síncrona é semelhante a este exemplo.

Parâmetros do conjunto de dados
Campo	Descrição
Data Set Request ID (ID da solicitação do conjunto de dados)	Um identificador exclusivo que representa uma solicitação específica ao serviço. Esse identificador pode ser usado para correlacionar uma solicitação com notificações sobre o SNS tópico da Amazon.

A resposta assíncrona é publicada como um JSON documento formatado em seu SNS tópico da Amazon e é semelhante a este exemplo.

Parâmetros do conjunto de dados
Campo	Descrição
Data Set S3 Location (Local do S3 do conjunto de dados)	O nome do bucket e a chave do conjunto de dados entregue.
Data Set Meta Data S3 Location (Local do S3 dos metadados do conjunto de dados)	O nome do bucket e a chave do arquivo de metadados do conjunto de dados entregue.
Data Set Request ID (ID da solicitação do conjunto de dados)	Um identificador exclusivo que representa uma solicitação específica ao serviço. Esse identificador pode ser usado para correlacionar uma solicitação com notificações sobre o SNS tópico da Amazon.
Bem-sucedida	"True" se a operação tiver sido bem-sucedida, caso contrário, "false".
Message	(Opcional) Se ocorrer um erro (por exemplo, "Success" for "false"), essa mensagem conterá informações sobre a falha.

Exemplo de resposta JSON assíncrona formatada



 {    
   "dataSetS3Location":{
      "bucketName":"demo-bucket",
      "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv"
   },
   "dataSetMetaDataS3Location":{
      "bucketName":"demo-bucket",
      "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json"
   },
   "dataSetRequestId":"f65b7244-6862-11e5-80e2-c5127e17c023",
   "success":true
 }

Outputs

Após uma solicitação bem-sucedida, o conjunto de dados solicitado será entregue para seu bucket do Amazon S3 como um arquivo .csv. Um arquivo JSON de metadados formatado é publicado no mesmo local do arquivo do conjunto de dados. O arquivo de metadados fornece informações úteis sobre o conjunto de dados e os parâmetros da solicitação original. O arquivo de metadados tem o mesmo nome que o conjunto de dados no arquivo, mas termina com a extensão .meta.json. A tabela a seguir relaciona os campos de metadados no arquivo .csv.

Campos de metadados
Campo	Descrição
Data Set Request ID (ID da solicitação do conjunto de dados)	Um identificador exclusivo que representa uma solicitação específica ao serviço. Esse identificador pode ser usado para correlacionar uma solicitação com notificações sobre o SNS tópico da Amazon.
Data Set Coverage Range (Intervalo de cobertura do conjunto de dados)	Define a data/hora de início e a data/hora de término do intervalo de cobertura dos dados. Essas datas estão no formato ISO 8601.
Data Set Request Parameters (Parâmetros da solicitação do conjunto de dados)	Os parâmetros de solicitação originais do método `GenerateDataSet`.
Data Set S3 Location (Local do S3 do conjunto de dados)	O nome do bucket e a chave do conjunto de dados entregue.
Data Set Meta Data S3 Location (Local do S3 dos metadados do conjunto de dados)	O nome do bucket e a chave do arquivo de metadados do conjunto de dados entregue.

Veja a seguir um exemplo de conteúdo JSON de metadados formatados.



{
"dataSetRequestId": "43d7137b-8a94-4042-a09d-c41e87f371c1",
"dataSetCoverageRange": {
"startDateTime": "2014-06-08T00:00:00.000Z",
"endDateTime": "2014-06-08T23:59:59.000Z"
},
"dataSetRequestParameters": {
"sellerAccountId": "123412341234",
"dataSetType": "customer_subscriber_hourly_monthly_subscriptions",
"dataSetPublicationDate": "2014-06-09T00:00:00.000Z",
"roleNameArn": "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole",
"destinationS3BucketName": "demo-bucket",
"destinationS3Prefix": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions",
"snsTopicArn": "arn:aws:sns:us-west-2:123412341234:demo-topic"
},
"dataSetS3Location": {
"bucketName": "demo-bucket",
"key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv"
},
"dataSetMetaDataS3Location": {
"bucketName": "demo-bucket",
"key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json"
}
}

Para obter uma lista completa dos conjuntos de dados disponíveis, incluindo datas de disponibilidade, consulte a AWSSDKdocumentação.

Solução de problemas

Esta seção descreve soluções para problemas que você pode encontrar ao usar o AWS Marketplace Commerce Analytics Service.

Não consigo acessar o serviço devido a um problema de lista de permissões.

Se você ainda não está registrado como vendedor no AWS Marketplace, acesse Portal de gerenciamento do AWS Marketplacepara se cadastrar. Se você já se registrou como vendedor em AWS Marketplace, entre em contato com a equipe de operações do AWS Marketplace vendedor.

Não posso solicitar conjuntos de dados para uma data anterior, embora a SDK documentação diga que eles deveriam estar disponíveis para essa data.

Embora os conjuntos de dados estejam indicados como disponíveis para determinadas datas no passado, só temos dados a partir da data que você ingressou no AWS Marketplace. Se você acredita que isso é um erro, entre em contato com a equipe de Operações do vendedor do AWS Marketplace .

Quando ligo para o serviço, recebo a mensagem de erro “Não foi possível conectar-se ao endpointURL: https://marketplacecom merceanalytics.eu-central-1.amazonaws.com/”

O AWS Marketplace Commerce Analytics Service está disponível somente na região Leste dos EUA (Norte da Virgínia). Todas as chamadas para o Serviço de análise de comércio precisam ser feitas para o endpoint us-east-1.

Se você estiver usando o AWS CLI, adicione o --region sinalizador "a cada chamada e especifique o Região da AWS comous-east-1, conforme mostrado no exemplo a seguir.



aws marketplacecommerceanalytics generate-data-set \
--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \
--data-set-publication-date "2016-04-21T00:00:00Z" \
--role-name-arn "arn:aws:iam::138136086619:role/MarketplaceCommerceAnalyticsRole" \
--destination-s3-bucket-name "marketplace-analytics-service" \
--destination-s3-prefix "test-prefix" \
--sns-topic-arn "arn:aws:sns:eu-central-1:138136086619:Marketplace_Analytics_Service_Notice" \
 --region us-east-1

Quero usar um bucket do Amazon S3 ou um SNS tópico da Amazon diferente dos que selecionei quando passei pelo processo de integração.

Ao se inscrever no AWS Marketplace Commerce Analytics Service, você especificou um bucket do Amazon S3 e um tópico da AmazonSNS. O processo de integração configura suas IAM permissões para permitir que o serviço acesse somente esses recursos específicos. Para usar recursos diferentes, você precisa modificar sua IAM política:

Faça login no AWS Management Console e abra o IAM console em https://console.aws.amazon.com/iam/.
Escolha Funções no lado esquerdo do IAM console.
Escolha MarketplaceCommerceAnalyticsRole.
Expanda a seção Inline Roles (Funções em linha), se ainda não estiver expandida.
Localize a política com um nome que comece com oneClick_MarketplaceCommerceAnalyticsRole e escolha Editar política.
No documento de política, localize a seção que especifica as ações relacionadas ao serviço que você deseja modificar. Por exemplo, para alterar o bucket do Amazon S3, localize a seção que inclui as ações que começam com s3: e altere sua respectiva seleção de Recurso para especificar seu novo bucket do Amazon S3.

Para obter informações adicionais sobre IAM políticas, consulte o guia a seguir: https://docs.aws.amazon.com/IAM/latest/ /access_policies.html UserGuide

Recebo um erro AccessDeniedException quando chamo a ação GenerateDataSet

Isso pode acontecer se o usuário não tiver as permissões necessárias para chamar o GenerateDataSet. O procedimento a seguir descreve as etapas necessárias para criar uma IAM política com essas permissões usando o IAM console e adicionar as permissões aos seus usuários, grupos ou funções.

Para usar o editor JSON de políticas para criar uma política

Faça login no AWS Management Console e abra o IAM console em https://console.aws.amazon.com/iam/.
No painel de navegação à esquerda, escolha Policies (Políticas).

Se essa for a primeira vez que você escolhe Políticas, a página Bem-vindo às políticas gerenciadas será exibida. Escolha Começar.
Na parte superior da página, escolha Criar política.
Na seção Editor de políticas, escolha a JSONopção.

Insira o seguinte documento JSON de política:


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "marketplacecommerceanalytics:GenerateDataSet",
      "Resource": "*"
    }
  ]
}

Escolha Próximo.

nota
Você pode alternar entre as opções Visual e JSONEditor a qualquer momento. No entanto, se você fizer alterações ou escolher Avançar no editor visual, IAM poderá reestruturar sua política para otimizá-la para o editor visual. Para obter mais informações, consulte Reestruturação de políticas no Guia do IAM usuário.
Na página Revisar e criar, insira um Nome de política e uma Descrição (opcional) para a política que você está criando. Revise Permissões definidas nessa política para ver as permissões que são concedidas pela política.
Escolha Criar política para salvar sua nova política.

Para conceder acesso, adicione as permissões aos seus usuários, grupos ou perfis:

Usuários e grupos em AWS IAM Identity Center:

Crie um conjunto de permissões. Siga as instruções em Criação de um conjunto de permissões no Guia do usuário do AWS IAM Identity Center .
Usuários gerenciados IAM por meio de um provedor de identidade:

Crie um perfil para a federação de identidades. Siga as instruções em Criação de uma função para um provedor de identidade terceirizado (federação) no Guia IAM do usuário.
IAMusuários:
- Crie um perfil que seu usuário possa assumir. Siga as instruções em Criação de uma função para um IAM usuário no Guia IAM do usuário.
- (Não recomendado) Vincule uma política diretamente a um usuário ou adicione um usuário a um grupo de usuários. Siga as instruções em Adicionar permissões a um usuário (console) no Guia do IAM usuário.

Meu problema não está indicado aqui.

Entre em contato com a equipe de Operações do vendedor do AWS Marketplace .

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Toolkit do vendedor

AWS Marketplace Programa de demonstração de campo

AWS Marketplace Serviço de análise de comércio

Termos e condições

Guia de integração

Para usar o AWS Marketplace Commerce Analytics Service

Configure seu Conta da AWS com permissões

Criar um bucket do Amazon S3 de destino

Configurar um SNS tópico da Amazon para notificações de resposta

Inscreva-se no programa Serviço de análise de comércio

Para habilitar o acesso

nota

Verificar sua configuração

Para testar sua configuração

Guia de implementação técnica

IAMpolíticas para o Commerce Analytics Service

Fazendo solicitações com o AWS CLI

Como fazer solicitações com o AWS SDK for Java

Documentação técnica

Respostas

Outputs

Solução de problemas

Para usar o editor JSON de políticas para criar uma política

nota