Postback e webhook delle installazioni, spiegati
Un postback dice a un network pubblicitario che il suo clic è diventato un’installazione. Un webhook lo dice al tuo server. Come funzionano entrambi e come riceverli in sicurezza.
Network pubblicitari e piattaforme di affiliazione pagano per installazione, quindi devono venire a sapere di ognuna. Il tuo provider di attribuzione glielo comunica chiamando un URL fornito da loro: un postback. Punta la stessa chiamata al tuo backend ed è un webhook.
Andata e ritorno di un click ID
Network pubblicitario
Appy
- 01Il clic
GET acme.appy.to/spring?clickid=a1b2c3Il network aggiunge il suo click ID al tuo link.
- 02L’installazione
install → /spring clickid = a1b2c3Il primo avvio viene collegato a quel clic.
- 03Il postback
GET postback.network.example/install ?click_id=a1b2c3Lo stesso ID torna indietro. Il network conta una conversione.
Postback
- A un network pubblicitario
- GET, valori nell’URL
- Porta il click ID del network
Webhook
- Al tuo server
- POST, body JSON
- Porta installazione, link ed evento
Un endpoint sicuro controlla quattro cose
Verificare un webhook di Appy
Node.js
import crypto from 'node:crypto';
export function verifyAppySignature(header, rawBody, secret) {
const parts = Object.fromEntries(header.split(',').map((part) => part.split('=')));
const age = Math.abs(Date.now() / 1000 - Number(parts.t));
if (!parts.t || !parts.v1 || age > 300) return false;
const expected = crypto.createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex');
if (parts.v1.length !== expected.length) return false;
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}Quando il tuo endpoint è giù
- timeout per richiesta
- 10 s
- tentativi su 429, 5xx o timeout
- 5
- attesa prima dell’ultimo
- 12 h
- log delle consegne
- 30 giorni
timeout per richiesta
tentativi su 429, 5xx o timeout
attesa prima dell’ultimo
log delle consegne
Dove Appy manda le installazioni
Nel piano Enterprise, fino a 10 postback per app, ognuno provato dalla dashboard prima di attivarlo.
Nuova installazione
firmato e ritentato
- Network di affiliazione o CPIIl suo click ID, indietro
- Il tuo backendWebhook JSON completo
- Il tuo CRMSolo acquisti
- Ottimizzazione Meta o GoogleNon supportato
Leggi anche
Domande
Cos’è un postback S2S?
Una chiamata server-to-server che dice a un network pubblicitario che un clic è diventato un’installazione, con il suo click ID.
Come evito i conteggi doppi?
I nuovi tentativi riusano lo stesso ID di consegna. Ignora gli ID che hai già elaborato.
Come so che un webhook arriva davvero da Appy?
Controlla l’header Appy-Signature e rifiuta tutto quello che ha più di cinque minuti.
Posso mandare postback a Meta o Google Ads?
Non per ottimizzare le campagne. I postback servono per network di affiliazione, strumenti per influencer e i tuoi sistemi.
Continua a esplorare
Attribuzione Apple Ads senza MMP
Apple ti dice quale campagna e quale keyword hanno portato un’installazione: un token dall’app, una chiamata dal tuo server, niente IDFA.
Come decifrare il Meta Install Referrer su Android
Campagna, gruppo di inserzioni e inserzione dietro ogni installazione da Facebook e Instagram, visualizzazioni comprese.
Deferred deep linking senza SDK: come funziona davvero sotto il cofano
Puoi portare il contesto di un link oltre l’installazione senza incorporare un SDK di attribution. Ecco cosa sopravvive davvero al confine dello store su Android e iOS, cosa si rompe e quanto costa in privacy ogni scorciatoia.
Cerchi altro? Sfoglia tutti gli argomenti su il blog.
Ogni installazione dove deve arrivare
Appy attribuisce le installazioni da link, QR code, Apple Ads, Google Ads e Meta, e le inoltra una per una, firmate e con tentativi automatici.