Adattributionkit

Apple AdAttributionKit su iOS: impressioni, copie postback, valori di conversione, migrazione SKAN

di dpearson2699 · dpearson2699/swift-ios-skills

Promosso ★ 9.2/10

Adattributionkit — Apple AdAttributionKit su iOS: impressioni, copie postback, valori di conversione, migrazione SKAN

Cosa fa

Skill di riferimento per l'AdAttributionKit di Apple su iOS 17.4+, che copre la configurazione di Info.plist dell'editore e dell'app pubblicizzata, la registrazione delle visualizzazioni/clic di AppImpression, gli endpoint di copia postback e la verifica JWS, i valori di conversione e il re-engagement. Si attiva quando si collegano impressioni pubblicitarie, si ricevono o si verificano postback di attribuzione, si aggiornano i valori di conversione di installazione vs re-engagement o si migra un'app da SKAdNetwork. Fornisce un file di riferimento di 582 righe con gestione postback lato server, test in modalità sviluppatore e configurazione delle regole di attribuzione.

Rapporto di test

Installato in una HOME temporanea (mktemp -d) — frontmatter analizzato con name+description, e tutti e tre i file referenziati dal corpo hanno restituito HTTP 200 (SKILL.md, references/adattributionkit-patterns.md, evals/evals.json); nessun curl|sh, nessuna esfiltrazione, solo la generazione benigna di chiavi openssl ES256 e le chiavi pubbliche pubblicate da Apple. Frasi di attivazione giudicate: DOVREBBE attivarsi — (1) "La nostra app iOS ha bisogno di copie dei postback di attribuzione vincenti, quali chiavi Info.plist e endpoint server mi servono?", (2) "Stiamo migrando il nostro SDK pubblicitario da SKAdNetwork — come funzionano i valori di conversione nel framework sostitutivo?", (3) "Metti una UIEventAttributionView sopra il nostro banner pubblicitario e registra il tap in modo che l'installazione venga attribuita"; NON DOVREBBE attivarsi — (4) "Configura il tracciamento delle conversioni di Google Analytics 4 per il nostro sito di marketing" (web analytics, nessun framework iOS), (5) "Mostra il prompt di autorizzazione App Tracking Transparency prima degli annunci personalizzati" (consenso ATT/IDFA, un framework diverso — la descrizione enumera solo impressioni/postback/valori di conversione); 5/5 corretto. Test di output: stesso compito di copia postback di app pubblicizzata scritto due volte — la baseline (/tmp/adattributionkit-test/out/baseline.md) ha usato la chiave SKAdNetwork NSAdvertisingAttributionReportEndpoint a livello superiore, ha dato il percorso /.well-known/skadnetwork/report-attribution/ sull'host del sottodominio e ha coperto l'ortografia JSON del re-engagement; l'artefatto seguito dalla skill (out/skill.md) ha nidificato AttributionCopyEndpoint + OptInForReengagementPostbackCopies sotto un dizionario AdAttributionKit, ha dato https://acme-ads.co.uk/.well-known/appattribution/report-attribution/ con la regola del dominio registrabile (sottodominio rimosso) e la distinzione "conversion-type": "re-engagement" vs Swift .reengagement — ho quindi verificato queste esatte affermazioni rispetto al documento "Configuring an advertised app" di Apple, che conferma i nomi delle chiavi, il percorso ben noto di appattribution e la regola del dominio registrabile, quindi la baseline era fattualmente errata dove la skill era corretta. La documentazione perde un punto: SKILL.md ti dice di "Caricare references/adattributionkit-patterns.md per la finestra corrente e la matrice di ritardo", ma il riferimento non ha tale sezione — le normali durate di 0-2/3-7/8-35 giorni appaiono solo come una colonna all'interno della tabella di confronto della modalità sviluppatore.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/dpearson2699/swift-ios-skills.git /tmp/adattributionkit-src
mkdir -p ~/.claude/skills
cp -R /tmp/adattributionkit-src/skills/adattributionkit ~/.claude/skills/adattributionkit
# Places SKILL.md + references/adattributionkit-patterns.md + evals/evals.json under ~/.claude/skills/adattributionkit/
# No runtime deps, no API keys, no scripts. Pure reference skill (markdown only).
# Alternatives from the repo README (not required):
#   npx skills add dpearson2699/swift-ios-skills --skill adattributionkit
#   /plugin marketplace add dpearson2699/swift-ios-skills   (Claude Code plugin marketplace)
# Actually applying the guidance to a real app needs Xcode + an iOS 17.4+ device/ad-network registration; the skill itself needs nothing.

Comandi e prompt di esempio

  • /adattributionkitApple AdAttributionKit su iOS: impressioni, copie postback, valori di conversione, migrazione SKAN

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Replace SKAdNetwork with AdAttributionKit in my app
  • Handle attribution postbacks for ad impressions
  • Update conversion values for re-engagement campaigns