1. Crie um aplicativo Login with Amazon
Integração: visão geral | 1. Criar cliente LwA | 2. Solicitar acesso à API | 3. Atribuir acesso
Etapa 1: Crie um Login com o aplicativo Amazon
A primeira etapa na integração à API do Amazon Ads é criar um client application do Login with Amazon (LwA) , que será usado posteriormente para fazer solicitações à API.
Depois de ter sido aprovado para acessar a API, você atribuirá seu acesso a este aplicativo LwA em uma etapa posterior.
Para saber mais sobre a função que o LwA desempenha na API de anúncios da Amazon, consulte:
Já tem login com credenciais da Amazon?
Mesmo se você já tiver login com credenciais da Amazon - por exemplo, se você usa atualmente a Selling Partner API - você ainda criará um novo perfil de segurança LwA para usar com a Amazon Ads API. Se você já estiver conectado ao Amazon Developer, prossiga para Crie um novo perfil de segurança LwA .
Registre-se com o Amazon Developer
Para criar um aplicativo do Login with Amazon, você deve se registrar como desenvolvedor em developer.amazon.com.
Para se registrar como desenvolvedor, clique em Sign In .
Na tela de login, faça o seguinte:
- digite seu endereço de e-mail e senha para entrar com uma conta Amazon existente ou
- escolha Create your Amazon Developer account para criar uma nova conta por meio do Amazon Developer.
Você será redirecionado para a página de registro do desenvolvedor. Preencha o formulário, aceite o contrato de serviços do desenvolvedor da Amazon e selecione Submit .
Importante
Nesta fase, você pode se registrar como desenvolvedor usando uma conta Amazon existente ou criando uma nova conta por meio do Amazon Developer. Se estiver criando um aplicativo associado a uma empresa, recomendamos que você use um endereço de e-mail gerenciado por várias pessoas em sua organização.
Isso ocorre porque o endereço de e-mail associado ao seu registro de desenvolvedor LwA também será associado às suas permissões de API do Amazon Ads assim que você for aprovado. Além disso, assim que você for aprovado para acesso à API e aceitar o contrato de licença, não poderá alterar o aplicativo LwA associado a este e-mail, portanto, é altamente recomendável que todos os indivíduos associados ao endereço de e-mail saibam qual aplicativo LwA associar ao endereço de e-mail.
Crie um novo perfil de segurança LwA
Depois de fazer login no site
Amazon Developer
usando a conta criada acima,
clique em Developer Console.
No console do desenvolvedor,
clique em Login with Amazon
na barra de menus.
Clique em Create a New Security Profile.
Você é redirecionado para a página Security Profile Management . No formulário digite:
- Security Profile Name
- Security Profile Description
- Consent Privacy Notice URL
Para obter mais informações sobre esses campos, consulte a documentação LwA.
Selecione o botão Save quando tiver inserido essas informações.
Nota
O URL do aviso de privacidade de consentimento deve ser o URL da política de privacidade da sua empresa, se disponível. Esse URL será exibido posteriormente como um link no site de autorização LwA que os anunciantes visitarão para conceder permissões ao seu aplicativo.
Para Anunciantes diretos que acessam seus próprios dados, isso não é essencial para o processo de integração e qualquer URL pode ser inserido.
Recupere suas credenciais de segurança
Depois de criar um novo perfil, você
será redirecionado para a página
Login with Amazon.
Esta página inclui uma tabela que lista o
security profile name e
OAuth2 credentials
Localize o nome do perfil de segurança
que você criou anteriormente e clique em
Show Client ID and Client Secret.
Observe esses valores, pois são credenciais essenciais para acessar a API de anúncios da Amazon. O ID do cliente é passado em todas as solicitações para a API, e tanto o ID quanto o segredo do cliente são usados para gerar tokens de acesso para a API. Esses valores podem ser recuperados desse painel a qualquer momento.
Posso usar mais de um ID de cliente com a API?
Não. Como política, o Amazon Ads permite o acesso à API para um ID de cliente por empresa . Não há necessidade de vários IDs de cliente, pois um número ilimitado de usuários pode usar o mesmo ID de cliente em uma empresa. Permissões de usuário adicionais podem ser gerenciadas posteriormente no Amazon Developer console. No entanto, apenas o criador original da conta de desenvolvedor da Amazon pode concluir a sequência inicial de integração.
Próximos passos
Depois de concluir essas etapas, continue na próxima etapa do processo de integração: Inscreva-se para acesso à API de publicidade .
Suporte técnico
Se você tiver dificuldade para se conectar à API de anúncios da Amazon, visite nossa página de suporte técnico para obter informações.
Updated over 1 year ago