Fehlerbehebung bei TotalConnect-Datenströmen

Im Protokoll für TotalConnect-Datenströme werden alle Dateien gespeichert, die in den Datenstrom integriert wurden, wobei jede Datei über ein eigenes sekundäres Protokoll verfügt.

Gängige Fehler und deren mögliche Lösungen:

Fehler: MISSING_FIELD "In der hochgeladenen Datei fehlt ein Pflichtfeld"

In Ihrem Datenstrom fehlt ein Pflichtfeld. Der Fehler Missing Field (Feld fehlt) kann in zwei Szenarien verursacht werden.

• In der Datei fehlt eine Spalte.
• Eine Spaltenüberschrift wurde umbenannt oder falsch geschrieben.

Bestätigen Sie den Fehler:

• Laden Sie die Datei herunter, die den im Protokoll des Datenstroms aufgeführten Fehler verursacht, und vergleichen Sie die zugeordneten Felder im Datenstrom mit den heruntergeladenen Dateifeldern. Wenn Felder fehlen, wenden Sie sich an einen Administrator, der mit den Dateien vertraut ist.
• Suchen Sie nach Kopfzeilennamen, die sich von denen aus den vorherigen Dateien unterscheiden, die fehlerfrei verarbeitet wurden.

Mögliche Lösung:

• Wenden Sie eine Zuordnungsformel mit der COALESCE-Funktion an, um allen Kopfzeilennamen aus den früheren und aktuellen Versionen gerecht zu werden.
• Laden Sie die Datei in einen neuen Datenstrom hoch. Kopfzeilenprobleme sind in der ursprünglichen Datei nicht immer sichtbar. Indem Sie die Datei in einem separaten Datenstrom auf die Plattform hochladen, können Sie nachvollziehen, wie die Datei durch die Plattform verarbeitet wird.

Fehler: DATE_FORMAT_IS_INVALID "Ungültiges Datumsformat"

Datumswerte sind für das Hochladen von Messwertdaten in Marketing Cloud Intelligence obligatorisch. Ein ungültiges Datumsformat führt dazu, dass der Datenstrom fehlschlägt. Der Fehler "Ungültiges Datumsformat" kann in zwei Szenarien verursacht werden:

• Das Datumsfeld wird als Text und nicht als Datum gelesen.
• Datumswerte werden anders formatiert als in den vorherigen Dateien.

Mögliche Lösung:

• Wenden Sie eine PARSEDATE-Funktion auf das Feld "Datum" in der Zuordnung an und nehmen Sie dabei alle möglichen Variationen der Datumsformate in eine Wenn-Anweisung auf.
• Setzen Sie die Datei auf ihre ursprünglichen Einstellungen zurück – die ursprüngliche Dateierweiterung oder das ursprüngliche Datumsformat. Wenn Sie die Datei nicht zurücksetzen können, wenden Sie sich an Ihren Kundenbeauftragten, um Unterstützung zu erhalten.

Fehler: INVALID_DATE_RANGE "Ungültiger Datumsbereich"

Ein Fehler vom Typ "Ungültiger Datumsbereich" tritt auf, wenn der Datumsbereich einer Datei viele Jahre enthält. Die Plattform erkennt, dass der Datumsbereich unangemessen ist, und lädt die Datei nicht hoch. In Marketing Cloud Intelligence können nur Daten innerhalb eines Zeitraums von 15 Jahren verarbeitet werden. Daten, die älter als 15 Jahre sind, führen zu einem Fehler vom Typ "Ungültiger Datumsbereich".

Mögliche Lösung:

• Beziehen Sie nur die Daten der letzten 15 Jahre ein.
• Ein Fehler vom Typ "Großer Datumsbereich" kann auch auf einen Datenformatfehler zurückgehen. Sie sollten auch das Datenformat in fehlgeschlagenen Streams überprüfen.

Fehler: FORMULA_EVALUATION_FAILED "Formelauswertung fehlgeschlagen"

Eine Formel, die nicht wie vorgesehen funktioniert, kann dazu führen, dass ein Datenstrom fehlschlägt. Der Fehler "Formelauswertung fehlgeschlagen" kann durch folgendes Szenario verursacht werden:

• Die auf den Datenstrom angewendete Formel kann nicht für alle Daten ausgeführt werden, auf die sie angewendet ist. Beispielsweise teilen sich einige der Daten in der Formel in einen Nullwert.

Bestätigen Sie den Fehler:

• Bestimmen Sie anhand des Protokolls mit den fehlgeschlagenen Aufträgen die fehlgeschlagene Formel.
• Überprüfen Sie die Rohdatendateien und zeigen Sie an, auf welche Daten die fehlgeschlagene Formel angewendet wurde.

Mögliche Lösung:

• Bearbeiten Sie die Formel und verarbeiten Sie die Dateien erneut.

Fehler: MAPPING_VALIDATION/Zuordnungswarnungen

In einer Zuordnungsvalidierung oder Zuordnungswarnung werden bestimmte Probleme bei den Beziehungen zwischen den Feldern in der hochgeladenen Datei hervorgehoben, beispielsweise wenn demselben Kampagnenschlüssel mehrere Kampagnennamenswerte zugeordnet sind. Durch die Zuordnungsvalidierung und die Zuordnungswarnung können Aggregationsprobleme verursacht werden.

Mögliche Lösungen:

• Jedem zugeordneten Attributfeld muss auch sein Schlüsselfeld zugeordnet werden. Wenn Sie beispielsweise das Feld "Social Post-Domäne" zuordnen, muss auch "Social Post-Schlüssel" zugeordnet werden. Überprüfen Sie die fehlgeschlagenen Aufträge in den Protokollen und bestimmen Sie, welche Dimension problematisch ist.
• Stellen Sie sicher, dass Einheiten, die in einer 1:1-Beziehung zugeordnet sind. Beispielsweise "Kampagne" und "Medienkauf" – das Feld "eine" (in diesem Fall "Kampagne") weist nur einen Wert auf, der dem Feld "viele" ("Medienkauf") entspricht. Sie können dies mithilfe einer Pivot-Tabelle überprüfen:

  

• Bestätigen Sie, dass jede Entität, beispielsweise "Media Buy Key" (Schlüssel für den Medienkauf), unter jedem Attributfeld nur über einen Wert verfügt, beispielsweise "Media Buy Size" (Größe des Medienkaufs). In der Abbildung sehen Sie, dass der Entität zwei Attribute zugeordnet sind, was zu einem Fehler vom Typ MAPPING_VALIDATION oder "Zuordnungswarnungen" führt.

  

• In Datensets, in denen nur n:n-Beziehungen vorhanden sind, können Sie in der Zuordnung eine Verkettung erstellen, um zum Erstellen eines realisierbaren Schlüssels verschiedene Felder zu verketten.

Fehler: Security Error: invalid value "...path may contain malicious code" (Sicherheitsfehler: Ungültiger Wert – Pfad kann bösartigen Code enthalten)

Der Fehler "ungültiger Wert" tritt auf, wenn ein Seitenpfad als Code identifiziert wird, und wird aus Sicherheitsgründen blockiert.

Mögliche Lösung:

• Der Pfad ist kein bösartiger Code. Sie können mithilfe der folgenden Formel dafür sorgen, dass seine Blockierung verhindert wird: STRIP_HTML(csv['page_path']) im Seitenpfad und den zugehörigen Unterkategorien (Seitenpfadebene 1 und 2).
• Verarbeiten Sie nach dem Anwenden der Formel die fehlgeschlagenen Tage erneut.

Fehler: Die Formeln enthalten einen Zirkelbezug der Marketing Cloud Intelligence-Felder: Zirkelbezug erkannt

Ein fehlerhafter Zirkelbezug in der Formel tritt häufig auf, wenn VLOOKUP-Funktionen und der falsche Feldtyp verwendet werden.

Marketing Cloud Intelligence verweist in Formeln auf diese Feldtypen:

• CSV: Felder in der hochgeladenen Datei. Transformatoren wirken sich auf diese Werte aus, Formeln jedoch nicht.
• Dat: Ein Datenstrom ändert ein Feld in der "transformierten" Datei. Die Formelmanipulation wirkt sich auf diese Werte aus.
• Datenmodellfelder (wird als [Media_Buy_Name] angezeigt): Felder in der Marketing Cloud Intelligence-Datenbank, die Werte enthalten, die durch vorhandene Datenströme auf die Plattform geladen werden.

Bei Verwendung von VLOOKUP ist es üblich, Werte aus Feldern zu suchen und abzurufen, die durch andere Datenströme in der Arbeitsumgebung hochgeladen wurden. Datenmodellfelder mit eckigen Klammern werden verwendet, um die Werte abzurufen, mit denen Sie auf Werte zugreifen können, die in der Marketing Cloud Intelligence-Datenbank vorhanden sind.

Mögliche Lösung:

• Stellen Sie sicher, dass die VLOOKUP-Formel den richtigen Feldtyp im zweiten und dritten Parameter "searchDimension" und "returnDimension" verwendet.

Fehler: "Arbeitsumgebung hat maximale Anzahl von Zeilen überschritten" oder "Account hat maximale Anzahl von Zeilen überschritten"

Wenn eine Arbeitsumgebung oder ein Account die Obergrenze für die gesamten Zeilen überschreitet, können Datenströme nicht verarbeitet werden und schlagen fehl. Jeder Account verfügt über eine begrenzte Anzahl an Zeilen. Diese Anzahl wird zwischen den Arbeitsumgebungen des Accounts aufgeteilt. Besagter Fehler wird angezeigt, wenn entweder der Account oder eine der zugehörigen Arbeitsumgebungen die zugehörige Zeilenobergrenze erreicht.

Wenn ein Account die zugehörige Zeilenobergrenze erreicht, wird der Fehler "Account hat maximale Anzahl von Zeilen überschritten" angezeigt.

Wenn eine Arbeitsumgebung die zugehörige Zeilenobergrenze erreicht, wird "Arbeitsumgebung hat maximale Anzahl von Zeilen überschritten" angezeigt.

Bestätigen Sie den Fehler:

• Administratoren können in den Account- oder Arbeitsumgebungseinstellungen unter "Data Row Usage" (Datenzeilennutzung) die Zeilennutzung verfolgen.

Mögliche Lösung:

• Löschen Sie Daten aus der Arbeitsumgebung.
  

  Hinweis Es kann bis zu 30 Minuten dauern, bis die Änderungen wirksam werden. Wenden Sie sich an Ihren Kundenbeauftragten, um die Obergrenze für Account- oder Arbeitsumgebungszeilen zu erhöhen.

Problem: Beim Hochladen einer neuen Datei werden null Zeilen hochgeladen.

Anzeigen der bei der letzten Aktualisierung hinzugefügten Zeilen:

• Erweitern Sie Datenströme auf der Registerkarte Verbinden & Kombinieren und klicken Sie dann auf Liste mit Datenströmen.
• In der Spalte Anzahl der zuletzt hinzugefügten Zeilen können Sie die Anzahl der hinzugefügten Zeilen anzeigen.

Wenn 0 Zeilen hinzugefügt wurden, überprüfen Sie, ob eine Messkopfzeile fehlt oder ob sie in der aktuellen Datei unter einem anderen Namen angezeigt wird. Diese Probleme können dazu führen, dass Zeilen nicht hochgeladen werden.

Mögliche Lösung:

• Wenden Sie eine Zuordnungsformel mit der COALESCE-Funktion an, um allen Kopfzeilennamen aus den früheren und aus den aktuellen Versionen gerecht zu werden.
• Laden Sie die Datei in einen neuen Datenstrom hoch. Manchmal sind Kopfzeilenprobleme in der Originaldatei nicht sichtbar. Indem Sie die Datei in seinem separaten Datenstrom auf die Plattform hochladen, können Sie nachvollziehen, wie die Datei durch die Plattform verarbeitet wird.

Problem: Im Protokoll wird "Keine Datei" unter der Spalte "Datei" und "Es wurden keine Dateien abgerufen" unter "Grund" angezeigt.

Diese Situation tritt auf, wenn die Abrufeinstellungen des Datenstroms aktiviert sind, während des Abrufs jedoch keine neuen Dateien verfügbar sind. Diese Meldung bedeutet, dass der Datenstrom ausgeführt wurde, jedoch keine neuen Daten vorhanden waren.

Für TotalConnect-Datenströme gelten Daten-Upload-Einschränkungen. In dieser Tabelle sind die Obergrenzen aufgeführt.

Zusätzliche Hinweise:

• In jeder Arbeitsumgebung können bis zu 15 Aufträge gleichzeitig verarbeitet werden. Alle anderen Aufträge, die gleichzeitig beginnen, werden einer Warteschlange hinzugefügt und erhalten den Status "Ausstehend", bis sie verarbeitet werden.
• Wenn Sie einen geplanten Bericht erstellen, um einen Datenstrom zu füttern, kann die zugehörige E-Mail-Adresse in die Felder "An", "CC" oder "BCC" eingegeben werden.