Como usar um SDK de notificações push do iOS para a sua aplicação (com código)

Um SDK de notificações push para iOS desempenha duas funções: gere a infraestrutura entre a sua aplicação e o serviço de notificações push da Apple (APNs) e liga essa infraestrutura a uma plataforma de campanhas para que a sua equipa de marketing a possa realmente utilizar. Este guia abrange ambos os aspetos — os passos reais de integração com o código que irá implementar e o que se torna possível no painel de controlo assim que o SDK estiver instalado. Reflete o SDK PushEngage para iOS 1.0, a versão atual.

Porquê usar um SDK de notificações push para iOS na sua aplicação

Pode comunicar diretamente com o APNs — registar um token de dispositivo, criar um remetente, tratar dos retornos de chamada de entrega. O que obtém do APNs bruto é a entrega; o que não obtém é tudo o que o marketing necessita: segmentação, campanhas agendadas e acionadas, testes A/B, análises e atribuição de receita. Um SDK como o da PushEngage liga a sua aplicação a essa camada uma vez, para que as campanhas sejam criadas num painel de controlo em vez de num projeto Xcode. O resultado prático: após a semana de integração, as campanhas push deixam de ser bilhetes de engenharia.

Como instalar o SDK de notificações push PushEngage para iOS

Precisará de iOS 12+, Xcode 15+, uma chave APNs carregada no seu painel PushEngage e cerca de uma tarde. O SDK é fornecido como dois módulos: PushEngage para o seu alvo de aplicação e PushEngageExtension para alvos de extensão de notificação.

Passo 1: Adicionar o pacote

No Xcode, vá a Ficheiro → Adicionar Dependências de Pacotes e introduza o URL do repositório — ou use o CocoaPods:

# Swift Package Manager
https://github.com/awesomemotive/pushengage-ios-sdk

# CocoaPods
target 'YourApp' do
  pod 'PushEngage', '~> 1.0.0'
end
target 'YourNotificationServiceExtension' do
  pod 'PushEngageExtension', '~> 1.0.0'
end

Passo 2: Configurar o Grupo de Aplicações

Adicione a capacidade Grupos de Aplicações ao seu alvo de aplicação e a todos os alvos de extensão de notificação, utilizando o mesmo ID de grupo, e declare-o no Info.plist de cada alvo:

<key>PushEngage_App_Group_Key</key>
<string>group.com.yourcompany.yourapp</string>

A aplicação e as suas extensões partilham o estado do subscritor através deste contentor. Ignorá-lo é o erro de integração mais comum — sem ele, as suas extensões iniciam em branco a cada entrega.

Passo 3: Inicializar e solicitar permissão

import PushEngage

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        PushEngage.setAppID(id: "YOUR_APP_ID")
        PushEngage.setInitialInfo(for: application, with: launchOptions)
        return true
    }
}

// Later, at a value moment — not on first launch:
PushEngage.requestNotificationPermission { granted, error in
    if granted { /* subscribed */ }
}

O local onde coloca essa chamada de permissão é mais importante do que qualquer outra coisa neste guia — o iOS concede-lhe exatamente um pedido nativo. O guia de pré-solicitação de permissão abrange o padrão de pedido suave que o protege.

Como enviar notificações push ricas para aplicações iOS

Imagens, botões de ação e sons personalizados requerem uma Extensão de Serviço de Notificação — um pequeno alvo que interceta cada notificação e anexa multimédia antes da exibição. Adicione o alvo no Xcode, ligue PushEngageExtension a ele e encaminhe as duas chamadas de ciclo de vida:

import PushEngageExtension

class NotificationService: UNNotificationServiceExtension {
    override func didReceive(_ request: UNNotificationRequest,
                             withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
        PushEngageExtension.didReceiveNotificationExtensionRequest(request,
                                                                   bestContentHandler: contentHandler)
    }

    override func serviceExtensionTimeWillExpire() {
        // hand back the best content prepared so far
    }
}

A partir daí, os rich media são uma funcionalidade do painel: a sua equipa de marketing anexa a imagem do produto ou o gráfico principal ao criar a campanha, e a extensão renderiza-a. Nenhuma alteração adicional na aplicação por campanha.

Como criar notificações push personalizadas para iOS

A personalização baseia-se no que o SDK sabe sobre cada assinante. Identifique o seu utilizador e anexe atributos, e cada campanha pode segmentar e usar modelos com base neles:

// Identify the signed-in user (12 predefined fields supported)
PushEngage.identify(fields: [
    "first_name": "Priya",
    "email": "[email protected]",
    "profile_id": "user-42",
    "city": "Austin"
]) { success, error in }

// Attach custom attributes for segmentation
PushEngage.addSubscriberAttributes([
    "favorite_category": "outerwear",
    "loyalty_tier": "gold"
]) { success, error in }

// On sign-out, clear PII but keep the anonymous subscription
PushEngage.logout(fieldNames: nil) { success, error in }

Repetir chamadas identify com dados inalterados são atalhos locais, pelo que chamá-la em cada lançamento é seguro. Assim que os atributos fluem, a segmentação acontece no painel — “compradores de vestuário de luxo no Texas” torna-se um público guardado, não um pedido SQL.

Como adicionar um deep link em notificações push para iOS

Cada toque na campanha deve aterrar no ecrã prometido. Defina o manipulador de abertura de notificações uma vez, direcione com base no deep link que ele carrega:

PushEngage.setNotificationOpenHandler { result in
    // actionID is nil when the SDK already opened the URL itself
    guard let deepLink = result.notificationAction.actionID else { return }
    DispatchQueue.main.async {
        router.navigate(to: deepLink)   // e.g. myapp://cart
    }
}

O profissional de marketing cola o deep link no formulário da campanha; o seu manipulador trata do encaminhamento. Padrões completos — incluindo universal links e a opção de abertura automática — estão no guia de deep linking.

Como acionar campanhas a partir de eventos da aplicação

A chamada trackEvent do SDK 1.0 transforma qualquer comportamento na aplicação num gatilho de campanha — um carrinho abandonado, um passo de integração concluído, uma categoria consultada:

PushEngage.trackEvent(name: "cart_updated",
                      properties: ["cart_value": 89.50, "item_count": 2],
                      profileId: currentUserId,
                      provider: nil, eventType: nil) { _, _ in }

Instrumente o evento uma vez; o marketing cria e itera as campanhas com base nele indefinidamente. O guia de campanhas acionadas por eventos tem a taxonomia completa e a configuração de carrinho, integração e recuperação.

O que fazer agora que tem um SDK de notificações push para iOS

A integração é o começo, não a linha de chegada. A sequência que compensa mais rapidamente: proteja a sua taxa de opt-in com um fluxo de permissão preparado, envie a sequência de abandono de carrinho (a campanha de maior ROI para aplicações de comércio), adicione o rastreamento de objetivos para que cada campanha reporte receita em vez de aberturas, e depois construa o ciclo de vida — série de integração na extremidade frontal, recuperação na extremidade traseira. O guia de marketing push para aplicações cobre essa camada de estratégia de ponta a ponta, e a documentação de configuração percorre cada ecrã do painel. Cada plano pago tem uma garantia de devolução de dinheiro de 14 dias — e o SDK é licenciado em MIT no GitHub, para que possa ler exatamente o que está a enviar.