Como Usar um SDK de Notificações Push iOS para seu Aplicativo (Com Código)

Um SDK de notificações push para iOS faz dois trabalhos: ele cuida da infraestrutura entre seu aplicativo e o serviço de Notificação Push da Apple, e conecta essa infraestrutura a uma plataforma de campanha para que sua equipe de marketing possa realmente usá-la. Este guia abrange ambos — as etapas reais de integração com o código que você enviará, e o que se torna possível no painel depois que o SDK é instalado. Ele reflete o SDK PushEngage para iOS 1.0, a versão atual.

Por que usar um SDK de notificações push para iOS em seu aplicativo

Você pode falar diretamente com a APNs — registrar um token de dispositivo, criar um remetente, lidar com os retornos de chamada de entrega você mesmo. O que você obtém da APNs bruta é a entrega; o que você não obtém é tudo o que o marketing precisa: segmentação, campanhas agendadas e acionadas, testes A/B, análises e atribuição de receita. Um SDK como o da PushEngage conecta seu aplicativo a essa camada uma vez, para que as campanhas sejam criadas em um painel em vez de um projeto Xcode. O resultado prático: após a semana de integração, as campanhas push deixam de ser tickets de engenharia.

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

Você precisará de iOS 12+, Xcode 15+, uma chave APNs carregada em seu painel PushEngage e cerca de uma tarde. O SDK é enviado como dois módulos: PushEngage para o seu alvo de aplicativo e PushEngageExtension para alvos de extensão de notificação.

Etapa 1: Adicionar o pacote

No Xcode, vá para Arquivo → Adicionar Dependências de Pacote e insira a 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

Etapa 2: Configurar o Grupo de Aplicativos

Adicione a capacidade Grupos de Aplicativos ao seu alvo de aplicativo e a todos os alvos de extensão de notificação, usando 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>

O aplicativo e suas extensões compartilham o estado do assinante através deste contêiner. Ignorá-lo é o erro de integração mais comum — sem ele, suas extensões iniciam em branco a cada entrega.

Etapa 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 */ }
}

Onde você coloca essa chamada de permissão importa mais do que qualquer outra coisa neste guia — o iOS concede exatamente um prompt nativo. O guia de priming de permissão cobre o padrão de solicitação suave que o protege.

Como enviar notificações push ricas para aplicativos iOS

Imagens, botões de ação e sons personalizados exigem uma Extensão de Serviço de Notificação — um pequeno alvo que intercepta cada notificação e anexa mídia antes da exibição. Adicione o alvo no Xcode, vincule o 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í, rich media é um recurso do painel: sua equipe de marketing anexa a imagem do produto ou o gráfico principal ao criar a campanha, e a extensão a renderiza. Nenhuma alteração adicional no app por campanha.

Como criar notificações push personalizadas para iOS

A personalização é baseada no que o SDK sabe sobre cada assinante. Identifique seu usuário 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 de identify com dados inalterados são atalhos locais, portanto, chamá-lo a cada inicialização é seguro. Assim que os atributos fluem, a segmentação acontece no painel — “compradores de roupas de luxo no Texas” se torna um público salvo, não uma solicitação SQL.

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

Cada toque na campanha deve levar à tela prometida. Defina o manipulador de abertura de notificação uma vez, roteie 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; seu manipulador cuida do roteamento. 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 do app

A chamada trackEvent do SDK 1.0 transforma qualquer comportamento dentro do app em um gatilho de campanha — um carrinho abandonado, uma etapa de integração concluída, uma categoria visualizada:

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 você 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 traz retorno mais rápido: proteja 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 aplicativos de comércio), adicione o rastreamento de metas para que cada campanha relate receita em vez de aberturas e, em seguida, construa o ciclo de vida — série de integração na frente, recuperação na parte de trás. O guia de marketing push para aplicativos cobre essa camada de estratégia de ponta a ponta, e a documentação de configuração percorre cada tela do painel. Todos os planos pagos têm garantia de devolução do dinheiro em 14 dias — e o SDK é licenciado sob a licença MIT no GitHub, para que você possa ler exatamente o que está enviando.