Diretório de artigos
1. Introdução ao negócio
1.1 Introdução do Produto
GeTui é um provedor de serviços de nuvem push de mensagens de aplicativo móvel de nível comercial. O SDK do cliente suporta plataformas Android e iOS. Depois de integrar o SDK, os desenvolvedores podem enviar mensagens push por meio do poderoso web end e interfaces abertas de API ricas do GeTui. Analisar estatisticamente os efeitos de push. Ele pode efetivamente melhorar a atividade do aplicativo e aumentar a taxa de retenção de usuários.
1.2 Definição de termos
1.3 Processo de envio de mensagens
2. Criação de aplicativos
Se você ainda não possui uma conta GeTui, pode concluir o registro da conta no site oficial da GeTui.
Se você ainda não possui um aplicativo push, consulte [Adicionar serviço] nas instruções do Developer Center para concluir a criação de um aplicativo push de mensagens.
3. Integração do SDK do cliente
Se você precisar usar o serviço de envio de mensagens Personal Push em seu dispositivo móvel, primeiro deverá concluir a integração do SDK do cliente.
3.1Android
Pacote principal Android GeTui: GeTui fornece um SDK push seguro e estável para aplicativos Android. Após a integração do pacote principal, apenas "push online" pode ser usado.
Pacote de vários fornecedores Android: GeTui coopera com os principais fabricantes de Android para integrar o SDK push do fabricante. Depois de configurar os parâmetros de vários fornecedores no plano de fundo do GeTui Developer Center e integrar o pacote de vários fornecedores, "push offline" pode ser usado no ao mesmo tempo, o que pode melhorar o desempenho dos fabricantes de Android.Taxa de chegada de mensagens no dispositivo.
Conclusão do relatório de notícias do fabricante: Como nenhuma impressão é retornada por meio de envio pessoal, Huawei, Honor, OPPO e vivo não possuem relatórios completos de relatório de cliques off-line. Para facilitar a visualização de estatísticas de dados de envio mais completas no back-end do envio pessoal, recomendamos que você relate a conclusão no lado do cliente.
3.2 iOS
Pacote principal iOS GeTui: GeTui fornece um SDK push seguro e estável para aplicativos iOS. Após a integração do pacote principal, apenas "push online" pode ser usado.
Certificado push iOS: A função de notificação push suportada pelo iOS. Depois de exportar o certificado do site oficial do desenvolvedor da Apple e configurá-lo em segundo plano no Personal Push Developer Center, você pode usar "offline push" ao mesmo tempo, o que pode melhorar o taxa de chegada de mensagens em dispositivos iOS.
4. Envio de servidor
Os desenvolvedores podem enviar mensagens da página chamando o servidor RestAPI V2 ou fazendo login no GeTui Developer Center. (Se você deseja enviar para um único usuário cid, o cid deve ser obtido primeiro do cliente)
4.1 Processo de entrega de mensagens do servidor (deve ser lido)
Quando o CID está online (ou seja, o aplicativo está aberto e em execução em primeiro plano):
A mensagem é enviada ao cliente através de um canal push.
Especificamente, no código RestAPI-V2 do servidor, o conteúdo de notificação (notificação) ou transmissão (transmissão transparente) em push_message é passado ao cliente.
Nota: O sistema iOS não exibe mensagens de notificação push online, portanto, quando o usuário push é iOS, apenas a transmissão pode ser usada em push_message. O cliente iOS exibirá a barra de notificação por si só ao receber online.
Quando o CID está offline (ou seja, o aplicativo está em segundo plano, a tela está bloqueada e o processo é fechado):
Se a função offline do fabricante correspondente estiver habilitada, a mensagem será solicitada através do push side ao servidor do fabricante correspondente.
Especificamente no código RestAPI-V2 do lado do servidor, ou seja, o conteúdo da notificação em push_channel é passado para o fabricante, e a mensagem real é enviada ao cliente através do servidor do fabricante; para aqueles que não possuem a função do fabricante correspondente ativada ativado, a mensagem será armazenada em uma biblioteca push offline, aguarde até que o CID fique online e, em seguida, envie-o ao cliente através do canal push.
Nota: Se o servidor push_channel não passar um valor, as mensagens offline não poderão ser recebidas.
4.2 Back-end do Centro do Desenvolvedor
Faça login no GeTui Developer Center e entre na página push dos de mensagens do GeTui. Você pode [Criar Push] das 2 maneiras a seguir.
https://dev.getui.com/
Após a conclusão do registro, entre na mensagem push service:
crie um novo aplicativo de teste. Após a conclusão da construção, você pode obter as informações do aplicativo em Meu -> Gerenciamento de aplicativos:
as informações aqui estará no servidor mais tarde. Será usado na chamada. Amigos interessados podem baixar a demonstração do SDK do servidor, que é de grande valor para pesquisa.
4.3 Código push
Não vou acrescentar outros detalhes e informações do cliente, há boas explicações e explicações na documentação do site oficial do GeTui.
https://docs.getui.com/getui/server/rest_v2/service_sdk/
Adicione dependências:
<dependency>
<groupId>com.getui.push</groupId>
<artifactId>restful-sdk</artifactId>
<version>1.0.0.1</version>
</dependency>
GtApiConfiguration apiConfiguration = new GtApiConfiguration();
//填写应用配置
apiConfiguration.setAppId("-----");
apiConfiguration.setAppKey("-----");
apiConfiguration.setMasterSecret("-----");
// 接口调用前缀,请查看文档: 接口调用规范 -> 接口前缀, 可不填写appId
apiConfiguration.setDomain("https://restapi.getui.com/v2/");
// 实例化ApiHelper对象,用于创建接口对象
ApiHelper apiHelper = ApiHelper.build(apiConfiguration);
// 创建对象,建议复用。目前有PushApi、StatisticApi、UserApi
PushApi pushApi = apiHelper.creatApi(PushApi.class);
//推送
//根据cid进行单推
PushDTO<Audience> pushDTO = new PushDTO<Audience>();
// 设置推送参数
pushDTO.setRequestId(System.currentTimeMillis() + "");
PushMessage pushMessage = new PushMessage();
pushDTO.setPushMessage(pushMessage);
GTNotification notification = new GTNotification();
pushMessage.setNotification(notification);
notification.setTitle("测试标题" + new Date());
notification.setBody("哈哈哈");
notification.setClickType("url");
notification.setUrl("https://www.getui.com");
// 设置接收人信息
Audience audience = new Audience();
pushDTO.setAudience(audience);
audience.addCid("77b5b288038f1a418d071-----------");
// 进行cid单推
ApiResult<Map<String, Map<String, String>>> apiResult = pushApi.pushToSingleByCid(pushDTO);
if (apiResult.isSuccess()) {
// success
System.out.println(apiResult.getData());
} else {
// failed
System.out.println("code:" + apiResult.getCode() + ", msg: " + apiResult.getMsg());
}
Resultado dos testes:
5. Descrição dos parâmetros
https://docs.getui.com/getui/server/rest_v2/common_args/
Espere, você pode baixar o projeto oficial do SDK para visualizar