Infos über Parameter

Parameter sind Eigenschaften, die mit jedem Ereignis gekoppelt werden können, um die Kampagnen-Performance zu beeinflussen. Bestimmte Parameter sind erforderlich, während andere zur Verbesserung der Performance dringend empfohlen werden.

Erfahre in unserer Entwicklerdokumentation mehr über das Implementieren von Parametern.

Verfügbare Parameter:

• content_type: Der Wert für den Inhaltstyp muss entweder „product“ oder „product_group“ sein. Wenn du als „content_ids“ oder „content_id“ den Parameter „sku_id“ nutzt, verwende „product“. Wenn du den Parameter „item_group_id“ nutzt, verwende „product_group“. Dieses Feld ist für Video Shopping Ads (VSAs) erforderlich.

• contents: Eine Liste mit Inhaltsobjekten, die relevante Produkte in einem Web-Ereignis mit Produktinformationen zeigen. Der Wert muss ein Array von Objekten sein. Dieses Feld ist für Video Shopping Ads (VSAs) erforderlich.

• content_ids: Eine eindeutige ID oder ein Array mehrerer IDs der Produkte oder des Inhalts, z. B. ['987','654']. Der Parameter „content_ids“ muss immer mit Plural-s geschrieben werden, egal, ob du eine oder mehrere IDs sendest. Wir empfehlen, die in deinem Katalog eingerichtete sku_id oder item_group_id zu verwenden, falls verfügbar. Dieses Feld ist für Video Shopping Ads (VSAs) erforderlich.

• delivery_category: Mit diesem Parameter kannst du die Auslieferungsmethode für Online-Käufe angeben. Damit werden Käufe nach Auslieferungsmethode getrackt, wie Abholung vor oder im Geschäft oder Lieferung nach Hause.

• price und value: „price“ bezieht sich auf den Preis eines Einzelartikels und „value“ auf den Gesamtwert der Bestellung. Beispiel: Wenn du zwei Artikel zum Einzelpreis von 10 US-Dollar verkaufst, würde im price-Parameter 10 und im value-Parameter 20 übergeben werden. Der Wert muss eine Zahl sein. Dieses Feld ist für den ROAS und die wertbasierte Optimierung (VBO) erforderlich.

• num_item: Hiermit gibst du die Anzahl der Artikel bei der Initiierung des Zahlungsvorgangs an.

• content_name: Der Name der Seite/des Produkts. Der Wert muss eine Zeichenfolge sein.

• content_category: Die Kategorie der Seite/des Produkts. Der Wert muss eine Zeichenfolge sein.

• currency: Der Währungscode ISO 4127. Im nächsten Abschnitt sind die derzeit unterstützten Währungen aufgelistet. Der Werttyp muss „enum(string)“ sein. Dieses Feld ist für den ROAS erforderlich.

• search_string: Die benutzerseitig für das Ereignis „Suche“ eingegebene Zeichenfolge.

• description: Eine Beschreibung des Artikels oder der Seite in Form einer Zeichenfolge.

• status: Der Status einer Bestellung, eines Artikels oder einer Dienstleistung. Der Wert muss eine Zeichenfolge sein.

  • Hinweis: Abhängig davon, wie du „status“ nutzt, kann die Events-API erforderlich sein, um Statusänderungen an TikTok weiterzuleiten.

TikTok unterstützt derzeit die folgenden Währungen: 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

Du kannst dynamische Werte einrichten, die dynamische ereignisbezogene Werte an TikTok übergeben. Wende dich an deine(n) Website-Entwickler*in, um dynamische Werte einzurichten, oder verwende das Self-Service-Tool „Event Builder“ von TikTok. Dieser dynamische Code ermittelt automatisch die richtigen Werte deines Ereignisses (z. B. den Kaufpreis), statt einen festgelegten Wert zu verwenden. In unserem technischen Leitfaden erfährst du, wie du dynamische Werte mithilfe von Code einrichtest.

Hier ein Beispiel, wie der statische oder festgelegte Wert aussieht, wenn Besucher*in deiner Website ein Kleid in ihren Warenkorb legen.

Um aus diesen Werten dynamische Werte zu machen, ersetze die festgelegten Werte durch Code, der automatisch die richtigen Werte – wie „dress“ oder „8“ – übergibt.