DokumentationExperience PlatformAnleitung zu Quell-Connectoren

[Beta]{class="badge informative"}

TikTok Ads

Letzte Aktualisierung: 26. Oktober 2026

Erstellt für:

  • Entwicklerin/Entwickler
NOTE
Die TikTok Ads-Quelle befindet sich in der Beta-Phase. Weitere Informationen zur Verwendung von Betagekennzeichneten Connectoren finden ​ unter „Quellen - Übersicht“ .
IMPORTANT
Die TikTok Ads ist als Teil der Customer Journey Analytics SKU verfügbar.

Die TikTok Ads ist ein Paid Media-Connector von Adobe Experience Platform. Verbinden Sie damit Ihre TikTok-Werbekonten und nehmen Sie Kampagnen-, Anzeige- und Leistungsdaten wie Interaktionsmetriken in Experience Platform auf.

Der Connector veröffentlicht die erfassten Daten in Paid-Media-Datensätzen. Customer Journey Analytics verwendet diese Datensätze, um Einblicke in Ihre TikTok Marketing-Kampagnen zu erhalten.

Um Ihr Konto zu verbinden, melden Sie sich bei TikTok an und autorisieren Sie Experience Platform, auf Ihr Advertiser-Konto zuzugreifen. API-Anmeldeinformationen müssen nicht manuell generiert oder bereitgestellt werden.

Funktionsweise

Nachdem Sie einen TikTok Ads Datenfluss erstellt und das Advertiser-Konto für das Targeting ausgewählt haben, führt Experience Platform die folgenden Aufträge automatisch aus.

  • Wenn für Ihre Organisation noch keine Paid-Media-Datensätze vorhanden sind, werden diese von Experience Platform erstellt.
  • Ein einmaliger Aufstockungsvorgang wird ausgeführt, nachdem Sie den Datenfluss erstellt haben.
  • Ein inkrementeller Auftrag wird einmal täglich ausgeführt, beginnend am Tag nach der Erstellung des Datenflusses.

Voraussetzungen

Bevor Sie TikTok Ads mit Experience Platform verbinden, stellen Sie Folgendes sicher:

  • Eine vorhandene TikTok for Business-Entwickler-App mit dem hinzugefügten Produkt „Marketing-API“.
  • App-Genehmigung von TikTok. Apps starten im Sandbox-Modus und erfordern, dass TikTok die App überprüfen und genehmigen, bevor sie auf Produktions- und Kontodaten zugreifen kann.
  • Geschäftsüberprüfung. Dies ist ein separater Genehmigungsprozess von der App-Überprüfung und ist für höhere Limitstufen erforderlich.
  • Die folgenden App-Berechtigungsgruppen werden gewährt, bevor Sie Ihr Konto zum ersten Mal autorisieren. TikTok ermöglicht es Ihnen nicht, diese Berechtigungen später ohne erneute Autorisierung zu erweitern: Anzeigen-, Reporting, Anzeigen- und Zielgruppen-Management.
  • Ein Quotenbegrenzungskontingent, das für Ihr Aufstockungsvolumen geeignet ist. Die standardmäßige Sandbox-Ebene wird aggressiv gedrosselt. Fordern Sie daher eine Erhöhung an, bevor Sie eine große Aufstockung ausführen.
  • Kampagnen und Anzeigen sind bereits in Ihrem TikTok-Werbekonto eingerichtet. Der Connector liest aus diesen vorhandenen Werbedaten. Es werden keine TikTok Kampagnen, Anzeigen oder anderen Ressourcen erstellt, geändert oder gelöscht.

Bereitstellung von Schemata und Datensätzen

Die TikTok Ads weist automatisch einen Zieldatensatz, ein Schema und eine Feldzuordnung zu. Sie wählen beim Erstellen des Datenflusses keinen Zieldatensatz aus und ordnen auch keine Felder nicht selbst zu.

Der Connector stellt einen Paid-Media-Datensatz pro Entitätstyp bereit: Konto-, Kampagnen-, Anzeigengruppen-, Anzeigen-, Asset- und Zusammenfassungsmetriken. Dies sind dieselben kanonischen Schemata, die die Quellen Meta Ads und Google Ads bereits füllen. Im folgenden Abschnitt finden Sie die Core-Identitätsfelder, die der Connector für jede Entität zuordnet.

XDM-Schema TikTok Ads

In diesem Abschnitt finden Sie Informationen zu den Core-Identitäts- und Statusfeldern, die die TikTok Ads jedem Paid-Media-Schema zuordnet. Jeder zugeordnete Datensatz enthält auch einen entityType, der die Entität identifiziert, und einen paidMedia.adNetwork Wert von tiktok.

Kontofelder

Das Kontoschema speichert die Details Ihres TikTok Advertiser-Kontos.

TikTok
XDM-Feld
Beschreibung
advertiser_id
paidMedia.accountID
Die eindeutige Kennung für das Advertiser-Konto in TikTok.
name
paidMedia.metadata.name
Der Anzeigename des Advertiser-Kontos.
status
paidMedia.metadata.status
Der Kontostatus, z. B. aktiv.
currency
paidMedia.metadata.currency
Die Währung, in der das Konto gemeldet wird.
create_time
paidMedia.metadata.createdTime
Der Zeitstempel der Kontoerstellung.

Kampagnenfelder

Das Kampagnenschema speichert Ihre TikTok Kampagnendetails.

TikTok
XDM-Feld
Beschreibung
campaign_id
paidMedia.campaignID
Die eindeutige Kennung der Kampagne in TikTok.
advertiser_id
paidMedia.accountID
Die Kennung des übergeordneten Advertiser-Kontos.
campaign_name
paidMedia.metadata.name
Der Anzeigename der Kampagne.
operation_status
paidMedia.metadata.status
Der Kampagnenstatus, z. B. aktiv oder angehalten.
create_time
paidMedia.metadata.createdTime
Der Zeitstempel der Kampagnenerstellung.
modify_time
paidMedia.metadata.updatedTime
Der Zeitstempel der letzten Kampagnenänderung.

Anzeigengruppenfelder

Das Anzeigengruppenschema speichert die Details Ihrer TikTok Anzeigengruppe.

TikTok
XDM-Feld
Beschreibung
adgroup_id
paidMedia.adGroupID
Die eindeutige Kennung für die Anzeigengruppe in TikTok.
campaign_id
paidMedia.campaignID
Die Kennung der übergeordneten Kampagne.
adgroup_name
paidMedia.metadata.name
Der Anzeigename der Anzeigengruppe.
operation_status
paidMedia.metadata.status
Der Anzeigengruppenstatus, z. B. aktiv oder angehalten.

Felder hinzufügen

Das Anzeigenschema speichert Ihre TikTok Anzeigendetails.

TikTok
XDM-Feld
Beschreibung
ad_id
paidMedia.adID
Die eindeutige Kennung für die Anzeige in TikTok.
adgroup_id
paidMedia.adGroupID
Die Kennung der übergeordneten Anzeigengruppe.
ad_name
paidMedia.metadata.name
Der Anzeigename der Anzeige.
operation_status
paidMedia.metadata.status
Der Anzeigenstatus, z. B. aktiv oder angehalten.

Asset-Felder

Das Asset-Schema speichert Ihre kreativen TikTok- und Videodetails.

TikTok
XDM-Feld
Beschreibung
image_id / video_id
paidMedia.assetID
Die eindeutige Kennung für das Bild- oder Video-Asset in TikTok.
advertiser_id
paidMedia.accountID
Die Kennung des übergeordneten Advertiser-Kontos.

Felder für Zusammenfassungsmetriken

Das Schema Zusammenfassungsmetriken speichert Leistungsdaten für Ihre TikTok Konten, Kampagnen, Anzeigengruppen, Anzeigen und Assets.

Jeder Metrikdatensatz ist der Kennung der Entität zugeordnet, die er misst.

Entität
Zuordnung zum XDM-Feld
Konto
paidMedia.accountID
Campaign
paidMedia.campaignID
Anzeigengruppe
paidMedia.adGroupID
Anzeige
paidMedia.adID
Asset
paidMedia.assetID

Fehlerbehebung

Verwenden Sie die folgende Tabelle, um häufige Probleme mit der TikTok Ads-Quelle zu beheben.

Problem
Ursache
Die Verbindung ist erfolgreich, aber es scheinen keine Advertiser-Konten auszuwählen.
Der autorisierende TikTok hat keinen Zugriff auf Ads Management auf ein Advertiser-Konto oder die App hat die Geschäftsüberprüfung nicht abgeschlossen. Überprüfen Sie den App-Status in der TikTok for Business Developer Portal.
Der Datenfluss wird ausgeführt, aber es landen keine Daten im Datensatz.
Die App befindet sich wahrscheinlich noch im Sandbox-Prüfungsstatus. TikTok gibt Produktionsdaten erst dann zurück, wenn die Überprüfung durch die App erfolgreich war, obwohl die Verbindung selbst erfolgreich ist.
Eine Aufstockung schlägt teilweise aufgrund von Fehlern bei der Ratenbeschränkung fehl.
Die standardmäßige Ratenbegrenzungsstufe der App ist für den angeforderten Datumsbereich zu niedrig. Fordern Sie eine Erhöhung der Ratenbeschränkung von TikTok an, bevor Sie eine große Aufstockung ausführen.
Eine Aufschlüsselung bestimmter Metriken, z. B. die Asset-Leistung, gibt weniger Zeilen als erwartet oder Fehler zurück.
Nicht jede Metrik wird unter jeder Kombination von Berichtsdimensionen unterstützt. Validieren Sie die betroffene Aufschlüsselung mit einem Test-Advertiser-Konto, bevor Sie es in der Produktion verwenden.

Nächste Schritte

Nachdem Sie bestätigt haben, dass Sie über ein geeignetes TikTok Advertiser-Konto mit bestehenden Kampagnen und Anzeigen verfügen, fahren Sie fort, indem Sie TikTok Ads über die Benutzeroberfläche mit Experience Platform verbinden.

Weitere Hilfe zu diesem Thema

recommendation-more-help
experience-platform-help-sources