Estamos sempre publicando atualizações em nossa documentação, mas pode ser que elas ainda não estejam disponíveis em seu idioma. Para ter acesso às informações mais atualizadas, use a ​​versão em inglês.

Configuração de Assinaturas para aplicativos iOS

Para a Adjust se comunicar com a Apple, você precisa fornecer um conjunto de credenciais. Neste artigo, aprenda como:

  1. Configurar as notificações do servidor na sua conta do App Store Connect. Quando você configura as notificações do servidor, a Apple App Store notifica a Adjust sobre as atualizações nas assinaturas do seu aplicativo. Isso permite que a Adjust acione eventos de assinatura em tempo hábil.

  2. Gerar uma chave de compra in-app. Essa chave é necessária para todos os tipos de compras in-app, incluindo assinaturas.

  3. Obter valores do App Store Connect. Esses valores são necessários para conectar sua conta do App Store Connect à Adjust.

    • Chave privada
    • ID da chave
    • ID do emissor

  4. Conectar suas credenciais do App Store Connect ao sistema da Adjust.

Antes de começar

O que você precisa saber antes de começar.

Solução para crescimento:

Assinaturas está disponível como uma das soluções para crescimento da Adjust. Fale com seu representante da Adjust ou entre em contato pelo e-mail sales@adjust.com para que isso seja adicionado ao seu pacote.

Requisitos

  • Aplicativo no App Store Connect;
  • Permissões de administrador no App Store Connect;
  • Permissões de Admin, Editor ou Editor Personalizado na Adjust para conectar suas credenciais do App Store Connect no sistema da Adjust.

Configurar as notificações do servidor no App Store Connect

Você precisa configurar as notificações do servidor em sua conta do App Store Connect. Quando configuradas, a Apple App Store notifica a Adjust sobre atualizações nas assinaturas do seu aplicativo.

  1. Faça login no App Store Connect.

  2. Selecione My Apps (Meus aplicativos).

  3. Selecione o aplicativo que você deseja configurar.

  4. Selecione App Information (Informações do aplicativo).

  5. Em App Store Server Notifications > Production Server URL (Notificações do servidor da App Store > URL do servidor de produção), selecione Set Up URL (Configurar URL).

  6. No campo Production Server URL (URL do servidor de produção), insira https://subscription.adjust.com/v2/appstore/.

    • A Apple dá suporte a apenas uma URL de notificação de servidor. Se quiser receber os dados de assinatura da Apple em seus servidores primeiro, faça um proxy das notificações para nosso endpoint: https://subscription.adjust.com/v2/appstore/.

  7. Selecione Version 2 Notifications (Notificações da versão 2).

    • A Apple descontinuou as notificações da versão 1. Se você tinha uma versão anterior de Assinaturas na Adjust, atualize para as Notificações da versão 2.

  8. Selecione Save (Salvar).

Faça login na sua conta do App Store Connect e selecione My Apps.

1/5

Gerar uma chave de compra in-app

Recomendamos gerar uma chave de compra in-app para verificação de receita in-app pela Adjust. Essa chave autoriza o acesso aos dados do seu aplicativo pela API do servidor da App Store. Se ainda não tiver requisitado o acesso à API na sua conta do App Store Connect, complete a requisição antes de criar uma chave.

  1. Faça login no App Store Connect.
  2. Selecione Users and Access (Usuários e acesso).
  3. Selecione Integrations (Integrações).
  4. Em Key Type (Tipo de chave), selecione In-App Purchase (Compra in-app).
  5. Selecione o ícone + para criar uma chave de compra in-app.
  6. No campo Name (Nome), insira um nome para a chave.
  7. Selecione Generate (Gerar).

Sua chave de compra in-app aparecerá na lista de chaves ativas.

Selecione +.

1/3

Recuperar valores do App Store Connect

  1. Faça login no App Store Connect.

  2. Selecione Users and Access (Usuários e acesso).

  3. Selecione Integrations (Integrações).

  4. Em Key Type (Tipo de chave), selecione In-App Purchase (Compra in-app).

  5. Ao lado de Issuer ID (ID do emissor), selecione Copy (Copiar).

    • Exemplo: 57246542-96fe-1a63-e053-0824d011072a

  6. Na chave gerada, passe o mouse por cima do valor na coluna Key ID (ID da chave). Selecione Copy Key ID (Copiar ID da chave) para copiá-lo.

    • Exemplo: 2X9R4HXF34

  7. Na mesma chave, selecione Download In-App Purchase Key (Baixar chave de compra in-app) e, em seguida, selecione Download (Baixar) para prosseguir.

  8. Copie toda a chave privada do arquivo .p8 baixado.

    • Exemplo:
-----BEGIN PRIVATE KEY-----
MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgNxUqm0R2vt4IrLAQr9gfDPixwSxH9wJZ6NV3X0ax4eWgCgYIKoZIzj0DAQehasda2ANCAAQx53AlofI4Of54lbR04A6D2QMbe0mt8+JtRHkJJCEUesUfySoZsm2jeh3qodLE0pZ2Rayv26qFMKuKEwemB2Op
-----END PRIVATE KEY-----

Copie o ID do emissor

1/3

Conectar a conta do App Store Connect ao sistema da Adjust

Você precisa usar na Adjust as mesmas credenciais da conta do App Store Connect para todos os seus aplicativos incluídos nessa conta. Siga estes passos para adicionar suas credenciais do App Store Connect ao sistema da Adjust.

  1. No DataWorks, selecione Conexões.

  2. Selecione + Nova conexão.

  3. Em Parceiro, selecione App Store Connect (Compra in-app).

  4. Em Serviços, selecione Assinatura.

  5. Insira os valores que você obteve na etapa anterior.

    • ID do emissor
    • ID da chave
    • Chave privada

  6. Selecione Conectar.

➡️ A seguir: Habilite assinaturas para seu aplicativo no sistema da Adjust.