Come integrare SDK di eventi in-app di TikTok
Prima di iniziare
Per usare SDK di eventi in-app di TikTok per Android e iOS, occorre avere un account pubblicitario di TikTok e un ID app di TikTok. Puoi usare la tua app esistente oppure crearne una nuova.
Nota: SDK di eventi in-app di TikTok ora supporta la configurazione ibrida con MMP nello stesso account. Per integrare SDK, puoi creare un nuovo account pubblicitario TikTok o utilizzare il tuo account MMP esistente.
Come integrare SDK di eventi in-app di TikTok
Passaggio 1: crea un’app o usane una esistente e genera un ID app di TikTok e un App Secret
Opzione 1: aggiungi l’SDK a un’app collegata a un MMP (configurazione ibrida)
Accedi a TikTok Ads Manager.
Fai clic sulla scheda Strumenti, quindi su Gestore eventi.
Seleziona Fonti di dati e scegli l’app per cui desideri aggiungere il collegamento a SDK.
Vai alla scheda Impostazioni e fai clic su Scegli un partner in SDK di eventi in-app di TikTok.
Segui la procedura e aggiungi l’SDK all’account. Genera il tuo ID app di TikTok e l’App Secret.
Opzione 2: aggiungi l’SDK a un’app di nuova creazione
Accedi a TikTok Ads Manager.
Fai clic sulla scheda Strumenti, quindi su Gestore eventi.
Seleziona Collega fonte di dati in alto a sinistra sulla barra di navigazione, quindi seleziona App.
Seleziona SDK TikTok per collegare la tua app.
Fornisci i dettagli dell’app e crea la tua app. Segui la procedura e genera il tuo ID app di TikTok e l’App Secret.
Passaggio 2: segui le istruzioni riportate nella guida del Centro per sviluppatori di TikTok per integrare SDK di eventi in-app di TikTok
Per avviare l’SDK, devi già disporre dell’ID app, dell’ID app di TikTok e dell’App Secret del passaggio 1
Demo dell’ID app e dell’ID app di TikTok:
Demo dell’App Secret:
Scarica l’SDK in GitHub. Al momento, sono supportati SDK nativi per iOS, SDK nativi per Android e SDK Unity.
Passaggio 3: postback degli eventi tramite SDK
Per un elenco completo degli eventi nell’app standard che puoi registrare e per gli eventi registrati automaticamente, vai a Eventi standard.
Gli eventi registrati automaticamente sono elencati di seguito. Nota: la registrazione automatica degli eventi può essere disattivata. Per saperne di più, consulta la documentazione per sviluppatori di SDK di eventi in-app.
LaunchApp: l’app è in fase di avvio.
InstallApp: l’app viene avviata per la prima volta.
2DRetention: l’app è stata riaperta il giorno successivo alla prima apertura.
Purchase: pagamenti completati correttamente per abbonamenti, articoli di consumo e altri tipi di articoli.
Prima di abilitarlo, assicurati che il post-back degli acquisti con registrazione automatica sia conforme ai requisiti aziendali. Vedi maggiori dettagli sull’evento di acquisto con registrazione automatica per iOS e sull’evento di acquisto con registrazione automatica per Android.
Chiamata speciale per l’evento di acquisto con registrazione automatica: l’SDK è in grado di rilevare automaticamente le transazioni effettuate tramite StoreKit (iOS) o Google Play Billing (Android). Per trasmettere più proprietà e parametri oppure se non utilizzi il gateway di pagamento nativo di Apple o Google, ti consigliamo di utilizzare il postback degli acquisti manuale.
Passaggio 4: [iOS] misura gli eventi SKAN
In ambienti SKAdNetwork (SKAN), si consiglia di affidare la rendicontazione dei valori di conversione a un solo SDK. Se usi un MMP o un altro SDK per aggiornare i valori di conversione in SKAdNetwork, assicurati di aggiungere disableSKAdNetworkSupport() alla configurazione per evitare conflitti nell’aggiornamento.
Stabilisci se è necessario abilitare la misurazione SKAN per l’SDK di TikTok:
Se disponi di un MMP:
SDK MMP aggiorna il valore di conversione e intendi utilizzare lo schema SKAN di MMP: disattiva il supporto per SKAdNetwork nell’SDK di TikTok e non caricare uno schema su Gestore eventi di TikTok (il tuo MMP sarà l’unica fonte di riferimento per lo schema e gli aggiornamenti del valore di conversione).
Se NON disponi di un MMP:
Assicurati che un solo SDK dell’app aggiorni il valore di conversione SKAN.
Un altro SDK non-MMP consiste nell’aggiornamento del valore di conversione: disattiva il supporto per SKAdNetwork nell’SDK di TikTok ma carica uno schema in Gestore eventi di TikTok (TikTok non utilizzerà il tuo schema ma non eseguirà aggiornamenti del valore di conversione superflui).
L’SDK di TikTok è responsabile dell’aggiornamento del valore di conversione: abilita il supporto per SKAdNetwork nell’SDK di TikTok e carica uno schema in Gestore eventi di TikTok (TikTok diventa il gestore principale degli aggiornamenti del valore di conversione SKAN).
Per maggiori dettagli, fai riferimento alla documentazione per sviluppatori di SDK di eventi in-app.
Passaggio 5: verifica i postback in tempo reale con la modalità di debug
Dalla versione SDK 1.5.0, gli utenti hanno a disposizione due metodi per verificare l’integrazione SDK prima del rilascio:
(Consigliata) Una modalità di eventi di test basata su token, che viene effettuata interamente all’interno di Gestore eventi di TikTok e non richiede la modifica del codice.
Modalità debug manuale, che richiede una modifica. Quando si utilizza il debug manuale, ricorda di disattivare la modalità debug prima del rilascio dell’app. Gli eventi generati quando si utilizza uno qualsiasi di questi strumenti vengono sottoposti a una procedura di test e non possono essere utilizzati per i report.
Modalità di debug: ON
Modalità di debug: OFF
Passaggio 6: lancia la nuova versione dell’app con SDK di TikTok nell’App Store (iOS) o nel Play Store (Android)
Puoi vedere l’evento SDK mostrato nella scheda Report di Gestore eventi una volta che TikTok inizia a ricevere il tuo segnale in tempo reale dall’SDK. I segnali in modalità di test non verranno mostrati qui.
Passaggio 7: pubblica le tue campagne con l’SDK di TikTok
Per problemi relativi all’integrazione di SDK di eventi in-app, puoi inviare un ticket al supporto clienti. Verifica di selezionare Misurazione, quindi SDK di eventi in-app come categoria del problema.
