Descripción general

Esta guía cubre las señales de atribución específicas para móviles que se superponen a las mecánicas compartidas de S2S: Apple Search Ads, los install referrers de Google Play y Meta, el seguimiento de desinstalaciones y el recibo de instalación de iOS. Aplica a integraciones de apps iOS y Android que reportan sesiones y eventos server-to-server.

Atribución de Apple Search Ads

Integración de Search Ads en iOS

Apple Search Ads es una Self-Attributing Network (SAN) que requiere una implementación de atribución específica de la plataforma mediante los frameworks de Apple.

Soporte de frameworks:

• AdServices (iOS 14.3 y posteriores): framework de AdServices. Ruta de integración actual y recomendada.
• iAd (iOS 14.2 y anteriores): framework de iAd. Framework heredado, obsoleto según Apple; no se recomienda para nuevas integraciones.

Guía completa: Documentación de integración de Apple Search Ads

Implementación del framework AdServices

Recupera y envía el token de atribución mediante el framework AdServices para iOS 14.3 y posteriores.

Paso 1: Recuperar el token de atribución

#import <AdServices/AdServices.h>

NSError *error = nil;
Class AAAttributionClass = NSClassFromString(@"AAAttribution");
if (AAAttributionClass) {
    NSString *attributionToken = [AAAttributionClass attributionTokenWithError:&error];
    if (!error && attributionToken) {
        // Handle attributionToken
    }
}

Paso 2: Enviar a Singular

Codifica el token en URL y agrégalo al endpoint SESSION como parámetro attribution_token en la primera sesión después de cada instalación y reinstalación.

Install Referrer de Google Play

Atribución de instalación en Android

El Install Referrer de Google Play proporciona la atribución de instalación más precisa en Android, ya que contiene información sobre el origen del usuario antes de llegar a la Play Store.

Más información: Documentación del Install Referrer de Google

Pasos de implementación:

1. Recupera el install referrer en la primera apertura de la app usando la Play Install Referrer API
2. Reporta la sesión a través del endpoint SESSION incluyendo el parámetro JSON install_ref con los atributos requeridos

Atributos de install_ref:

Install Referrer de Meta

Mejora de la atribución de Facebook

El Referrer de Meta es una solución de medición específica de Android que proporciona datos de atribución granulares a nivel de usuario para las instalaciones de apps, combinando las tecnologías del Install Referrer de Google Play y del Install Referrer de Meta.

Más información: FAQ del Referrer de Meta

Pasos de implementación:

1. Recupera el install referrer de Meta en la primera apertura de la app según la documentación de Meta
2. Reporta la sesión a través del endpoint SESSION incluyendo el parámetro JSON meta_ref con los atributos requeridos

Atributos de meta_ref:

Seguimiento de desinstalaciones

Configuración de notificaciones push silenciosas

Realiza el seguimiento de las desinstalaciones mediante notificaciones push silenciosas del dispositivo, enviando el push token con cada notificación de sesión.

Requisitos de configuración:

1. Sigue la configuración de seguimiento de desinstalaciones específica de la plataforma:
   • Configuración del seguimiento de desinstalaciones en iOS
   • Configuración del seguimiento de desinstalaciones en Android
2. Agrega el token específico de la plataforma a la solicitud SESSION:
   • iOS: apns_token (token de dispositivo APNs)
   • Android: fcm (token de dispositivo FCM)

Recibo de instalación de iOS

Validación del recibo

Pasa el recibo de instalación de iOS en el parámetro install_receipt al reportar una sesión de iOS.

import Foundation
import StoreKit

class ReceiptManager {
    static func getInstallReceipt() -> String? {
        if #available(iOS 18.0, *) {
            let semaphore = DispatchSemaphore(value: 0)
            var result: String?

            Task {
                do {
                    let transaction = try await AppTransaction.shared
                    result = transaction.jwsRepresentation
                    semaphore.signal()
                } catch {
                    debugPrint("Failed to get app transaction: \(error.localizedDescription)")
                    semaphore.signal()
                }
            }

            semaphore.wait()
            return result

        } else {
            guard let receiptURL = Bundle.main.appStoreReceiptURL else {
                debugPrint("Receipt URL not found")
                return nil
            }

            do {
                let receiptData = try Data(contentsOf: receiptURL, options: .uncached)
                return receiptData.base64EncodedString(options: [])
            } catch {
                debugPrint("Failed to read receipt: \(error.localizedDescription)")
                return nil
            }
        }
    }
}