Parametri

I parametri sono proprietà che possono essere accoppiate a qualsiasi evento per ottenere un impatto sulle performance di una campagna. Alcuni parametri sono obbligatori, mentre altri sono altamente consigliati per migliorare le performance.

Scopri di più sulla documentazione per gli sviluppatori per l’implementazione dei parametri.

Parametri disponibili:

• content_type: il valore deve essere impostato su “product” o “product_group”. Se usi sku_id come “content_ids” o “content_id”, usa “product”, se usi item_group_id come “content_ids” o “content_id”, usa “product_group”. Questo campo è obbligatorio per i Video Shopping Ads (VSA).

• contents: un elenco di oggetti di contenuti che rappresentano prodotti pertinenti in un evento Web con informazioni sui prodotti. Il valore deve essere un array di oggetti. Questo campo è obbligatorio per i Video Shopping Ads (VSA).

• content_ids: ID univoco o array di ID multipli di prodotti o contenuti, ad esempio [“987”,“654”]. Devi includere la “s” in “content_ids”, sia per l’invio di un singolo ID che di un array di ID. Consigliamo di usare sku_id o item_group_id, che dovrebbe corrispondere al parametro sku_id/item_group_id configurato nel catalogo (se disponibile). Questo campo è obbligatorio per i Video Shopping Ads (VSA).

• delivery_category: puoi indicare il metodo di consegna per gli acquisti online utilizzando il parametro delivery_category. Questo parametro permette di monitorare gli acquisti in base al metodo di consegna, ad esempio pick-up all’esterno, pick-up in negozio o consegna a domicilio.

• price e value: il prezzo di un singolo articolo e il valore rappresentano il prezzo totale dell’ordine. Ad esempio, se disponi di due articoli, ciascuno venduto per 10 $, il parametro price passerà 10 e il parametro value passerà 20. Il tipo di valore deve essere un numero. Questo campo è obbligatorio per il ROAS e l’ottimizzazione basata sul valore (VBO).

• num_item: usalo per specificare la quantità di articoli all’inizio del pagamento.

• content_name: nome della pagina, prodotto. Il tipo di valore deve essere una stringa.

• content_category: categoria della pagina/del prodotto. Il tipo di valore deve essere una stringa.

• currency: codice ISO 4127. Nella sezione successiva è presente un elenco delle valute attualmente supportate. Il tipo di valore deve essere enum(string). Questo campo è obbligatorio per il ROAS.

• search_string: la stringa immessa dall’utente per la ricerca, utilizzata con l’evento Cerca.

• description: una stringa di descrizione dell’articolo o della pagina.

• status: stato di un ordine, articolo o servizio. Il tipo di valore deve essere una stringa.

  • Nota: a seconda dell’utilizzo del parametro “status”, potrebbe essere necessaria l’API eventi per condividere le modifiche allo stato su TikTok.

Valuta attualmente supportata da TikTok: AED, ARS, AUD, BDT, BHD, BIF, BOB, BRL, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DZD, EGP, EUR, GBP, GTQ, HKD, HNL, HUF, IDR, ILS, INR, ISK, JPY, KES, KHR, KRW, KWD, KZT, MAD, MOP, MXN, MYR, NGN, NIO, NOK, NZD, OMR, PEN, PHP, PKR, PLN, PYG, QAR, RON, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, VES, VND, ZAR

Puoi impostare valori dinamici che trasmettono valori dinamici relativi agli eventi a TikTok. Verifica la possibilità di configurare valori dinamici con lo sviluppatore del tuo sito Web o utilizza lo strumento Creatore eventi self-service di TikTok. Questo codice dinamico determinerà automaticamente i valori corretti del tuo evento, come il prezzo di acquisto, invece di utilizzare un valore impostato. Puoi anche utilizzare la nostra guida tecnica per configurare valori dinamici con il codice.

Ad esempio, se un utente visita il tuo sito Web e aggiunge un abito al carrello, ecco di seguito come apparirà il valore statico o impostato:

Per rendere dinamici questi valori, sostituisci i valori impostati con il codice che trametterà automaticamente i valori corretti come “dress” o “8”.