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.

Estas funciones asumen que ya tienes implementado el flujo de solicitudes S2S compartido. Para los endpoints, la autenticación y los parámetros comunes sobre los que se construyen, comienza por el hub de fundamentos y las dos referencias de endpoints.

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:

• iOS 14.2 y anteriores: framework iAd
• iOS 14.3 y posteriores: framework AdServices (recomendado)

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

Implementación del framework iAd

Recupera y envía los datos de atribución de Apple Search Ads mediante el framework iAd para iOS 14.2 y anteriores.

Paso 1: Recuperar los datos de atribución

#import <iAd/iAd.h>

Class ADClientClass = NSClassFromString(@"ADClient");

if (ADClientClass) {
    id sharedClient = [ADClientClass performSelector:@selector(sharedClient)];

    if ([sharedClient respondsToSelector:@selector(requestAttributionDetailsWithBlock:)]) {
        [sharedClient requestAttributionDetailsWithBlock:^(NSDictionary *attributionDetails, NSError *error) {
            if (attributionDetails && attributionDetails.count > 0) {
                // REPORT attributionDetails FROM YOUR APP TO YOUR SERVER
            }
        }];
    }
}

Paso 2: Enviar a Singular

Reporta un evento con el nombre reservado __iAd_Attribution__ a través del endpoint EVENT , pasando el JSON de atribución como parámetro e .

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
            }
        }
    }
}