ad_id è l’identificatore univoco della piattaforma pubblicitaria per un singolo oggetto annuncio.
Formato
Un ad_id è una stringa numerica lunga assegnata dalla piattaforma, non un nome che scegli tu. Gli ID di Meta hanno in genere 17–18 cifre (120203456789012345), anche quelli di Google Ads e TikTok sono numerici, e alcune piattaforme li espongono come stringhe opache.
Ne seguono due conseguenze:
- Salvalo come stringa, mai come numero. Un valore di 17 cifre supera il più grande intero che JavaScript rappresenta esattamente (2^53 ≈ 9,007×10^15): un campo numerico JSON arrotonda le ultime cifre e il join si rompe in silenzio.
- Non interpretarlo. Le cifre non contengono nulla: né campagna, né data, né creatività. Ogni contesto arriva dall’API di reporting della piattaforma, con quella stringa come chiave.
Dove trovarlo
Tre posti affidabili, in ordine di preferenza:
| Fonte | Come si ottiene |
|---|---|
| API di reporting | GET /act_<account_id>/ads sulla Marketing API di Meta restituisce id per ogni annuncio; la stessa chiamata esiste su TikTok e Google Ads |
| Ads manager, livello annuncio | l’ID compare nella lista annunci e nell’URL dell’annuncio aperto (selected_ad_ids=…) |
| Report esportato | il report di campagna porta una colonna Ad ID accanto a spesa e risultati |
Il valore che serve è quello che la piattaforma usa quando riporta la spesa, perché è a quella tabella che l’ad ID deve fare join. Il nome di un file creatività o un nome di annuncio che sembra un ID non lo sono.
Perché è la chiave di join
L’attribuzione deve collegare due tabelle che vengono da sistemi diversi:
| Lato | Viene da | Chiave |
|---|---|---|
| Spesa | la piattaforma pubblicitaria | ad_id |
| Lead | il tuo tracking | il click ID, che risolve a un ad_id |
ad_id è l’unico identificatore su cui entrambi i lati possono concordare. I nomi delle campagne cambiano, i nomi dei file creatività sono convenzioni, ma ad_id è stabile ed è quello che la piattaforma usa quando riporta la spesa.
Perché le mappature manuali si rompono
Se gli annunci vengono creati a mano, il legame tra un file creatività e il suo ad_id vive in un foglio di calcolo o in una convenzione di naming. Si rompe quando:
- qualcuno duplica un annuncio e modifica il copy, tenendo lo stesso nome;
- un annuncio viene rinominato nella piattaforma dopo la creazione;
- la stessa creatività viene usata in più annunci con pubblici diversi;
- la persona che manteneva il foglio di calcolo se ne va.
Quando lo strumento che misura l’annuncio è anche quello che lo crea, la mappatura è scritta dal sistema e non può derivare.
Termini correlati
- Click ID — come un lead trova il suo annuncio
- Attribuzione creativa — perché esiste questo livello