Fehlerbehebung bei der Inhaltsbereitstellung
Wenn Ihre Seite nicht den erwarteten Inhalt anzeigt, gibt es ein paar Schritte, die Sie unternehmen können, um eine Fehlerdiagnose für die Inhaltsbereitstellung vorzunehmen.
- Prüfen Sie den Code für Ihre Aktivität bzw. Kampagne sorgfältig. Ein Tippfehler oder ein anderweitiger Fehler könnte die Ursache dafür sein, dass der erwartete Inhalt nicht angezeigt wird.
- Verwenden Sie zur Fehlerbehebung bei Target-Anforderungen mboxTrace oder mboxDebug.
- Mit Adobe Experience Cloud Debugger erhalten Sie ein intuitives Tool, das für die Fehlerbehebung von Target-Anforderungen fast die gleichen Informationen wie mboxDebug bereitstellt.
mboxDebug ist insbesondere bei der Einrichtung von Target auf Ihrer Seite hilfreich. Es stellt sicher, dass die Zielgruppen-Anforderung ausgelöst und das Cookie eingerichtet wird. Jedoch ist mboxDebug nicht so detailliert, wie es für die Fehlerdiagnose bei der Inhaltsbereitstellung nützlich wäre. Wenn Ihre Aktivität nicht auf Ihrer Seite erscheint oder unerwünschter Inhalt eingeblendet wird, verwenden Sie mboxTrace, um die Seite ausführlich zu untersuchen und Fehler zu diagnostizieren.
Abrufen des Autorisierungstokens zur Verwendung mit Debuggingwerkzeugen section_BED130298E794D1FA229DB7C3358BA54
Da mboxTrace und mboxDebug Kampagnen- und Profildaten für Dritte enthüllen können, ist ein Autorisierungstoken erforderlich. Das Autorisierungstoken kann in der Target-Benutzeroberfläche abgerufen werden. Das Token ist sechs Stunden lang gültig.
Für die Generierung eines Authentifizierungstokens benötigen Sie eine der folgenden Benutzerberechtigungen:
-
Mindestens Editor Berechtigung (oder Approver)
Weitere Informationen für Target Standard-Kunden finden Sie unter Festlegen von Rollen und Berechtigungen für Benutzer. Weitere Informationen für Target Premium-Kunden finden Sie unter Konfigurieren von Enterprise-Berechtigungen.
-
Administratorrolle auf der Ebene Arbeitsbereich/Produktprofil
Arbeitsbereiche stehen nur Target Premium-Kunden zur Verfügung. Weitere Informationen finden Sie unter Konfigurieren von Enterprise-Berechtigungen.
-
Administratorrechte (Berechtigung „Sysadmin“) auf der Adobe Target-Produktebene
So wird das Autorisierungstoken abgerufen:
-
Klicken Sie auf Administration > Implementation.
-
Klicken Sie im Abschnitt Debugger-Tools auf Generate New Authentication Token.
-
Fügen Sie das generierte Token Ihrer URL als Parameter hinzu, um eines der erweiterten Debuggingwerkzeuge zu aktivieren.
mboxTrace section_256FCF7C14BB435BA2C68049EF0BA99E
Mit mboxTrace können Sie an Target-Antworten angehängte Trace-Informationen abrufen. Trace-Informationen spiegeln das Ergebnis eines Target-Aufrufs (z. B. eine Konversion oder eine Impression) sowie alle weiteren Daten wider, die dazu beitragen festzustellen, weshalb es zu diesem Ergebnis gekommen ist, beispielsweise eine Reihe verfügbarer Niederlassungen, zwischen denen während einer Kampagne eine Auswahl getroffen wurde. Verwenden Sie diese Informationen für eine Fehlerdiagnose der Inhaltsbereitstellung.
Die folgenden Parameter stehen zur Verfügung:
?mboxTrace=console
Bei „at.js“ können Sie kein neues Browser-Fenster öffnen oder wie bei „mbox.js“ (inzwischen nicht mehr unterstützt) eine Ausgabe in der Konsole veranlassen. Sie müssen stattdessen die Netzwerkanforderung prüfen und unter „Vorschau“ (Chrome) oder „Antwort“ (Firefox) nachsehen.
?mboxTrace=json
?mboxTrace=window
?mboxTrace=disable
Beispiel für mboxTrace-Aufruf
https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6
Die Ausgabe zeigt detaillierte Informationen über Ihren Inhalt an. mboxTrace zeigt Details über Ihre Kampagne bzw. Aktivität und Ihr Profil an. Außerdem bietet es eine Momentaufnahme des Profils vor der Ausführung sowie eine Momentaufnahme der Änderungen nach der Ausführung. Es zeigt außerdem, welche Kampagnen oder Aktivitäten für jeden Ort ausgewertet wurden.
Ein Teil der Informationen umfasst übereinstimmende und nicht übereinstimmende Segment- und Ziel-IDs:
- SegmentId: IDs von Segmenten, entweder aus der Bibliothek mit den wiederverwendbaren Segmenten oder anonyme Segmente, die für die spezifische Kampagne erstellt wurden.
- TargetId: IDs von Zielen, entweder aus der Bibliothek mit den Zielausdrücken oder anonyme Ziele für beliebige Segmente aus der Kampagne.
- Unmatched: Die Anforderung in diesem Aufruf wurde für diese Segmente oder Ziele nicht zugelassen.
- Matched: Die Anforderung wurde für die angegebenen Segmente oder Ziele zugelassen.
Verwenden von mboxTrace auf Seiten mit Empfehlungen: Wenn Sie mboxTrace als Abfrageparameter auf Seiten mit Empfehlungen hinzufügen, wird das Recommendations-Design der Seite durch ein mboxTrace-Detailfenster ersetzt. In diesem Fenster werden ausführliche Informationen zu Ihren Empfehlungen angezeigt, darunter:
- Zurückgegebene Empfehlungen im Vergleich zu abgefragten Empfehlungen
- Der verwendete Schlüssel und ob er Empfehlungen generiert
- Nach Kriterien erstellte Empfehlungen im Vergleich zu Backup-Empfehlungen
- Kriterienkonfiguration
- Angewendete Aus- und Einschlüsse
- Auflistungsregeln
Sie müssen nicht =console
, =json
oder =window
in den Abfrageparameter einbeziehen. Wenn Sie mit den mboxTrace-Details fertig sind, fügen Sie =disable
hinzu und drücken Sie Enter , um zum normalen Anzeigemodus zurückzukehren.
Die normale Funktionsweise und Erscheinung Ihrer Website wird durch mboxTrace nicht beeinträchtigt. Besucher sehen Ihr normales Recommendations-Design.
mboxDebug mboxdebug
Ergänzen Sie zur Verwendung von mboxDebug Ihre URL um einen mboxDebug-Parameter. Die folgende Tabelle enthält Informationen zu URL-Parametern von Target für Antworten.
mboxDebug=1
Wenn Sie diesen Parameter zu einer URL mit definierten Target-Anforderungen hinzufügen, wird ein Pop-up-Fenster mit hilfreichen Details zur Fehlerbehebung geöffnet. Cookie-Informationen, die PCid und Sitzungs-ID-Werte sind ausgeschrieben und alle URLs sind sichtbar. Klicken Sie auf eine Target-Anforderungs-URL, um die Antwort für diese Target-Anforderung einzublenden. Weitere Details finden Sie unter mbox_debug.pdf.
mboxDisable=1
mboxOverride.browserIp=<Insert IP address>
Mit diesem URL-Parameter wird das Geotargeting getestet. Geben Sie eine IP-Adresse als Wert für dieses Attribut ein. Daraufhin wertet das Test&Target Geotargeting diese IP-Adresse anhand eines Geotargeting- oder Segmentierungssatzes in einer Kampagne aus.
#
wird als Fragmentkennung interpretiert und würde dazu führen, dass die Debugging-Parameter nicht korrekt funktionieren.Adobe Experience Cloud-Debugger section_A2798ED3A431409690A4BE08A1BFCF17
Der Adobe Experience Cloud-Debugger ermöglicht die schnelle und einfache Problembehebung in Ihrer Target-Implementierung. Hier können Sie schnell Ihre Bibliothekskonfiguration anzeigen, Anfragen untersuchen, um sicherzustellen, dass Ihre benutzerspezifischen Parameter ordnungsgemäß übergeben werden, die Konsolenprotokollierung aktivieren sowie alle Target-Anfragen deaktivieren. Nach Ihrer Authentifizierung bei der Experience Cloud können Sie das leistungsstarke Tool „MboxTrace“ verwenden, um Ihre Aktivität und Ihre Zielgruppenqualifikationen sowie Ihr Besucherprofil zu untersuchen.
Weitere Informationen finden Sie in den Schulungsvideos unten:
Weitere Informationen finden Sie unter Debuggen von at.js mit dem Adobe Experience Cloud Debugger.
Topverkäufe werden nicht in Recommendations angezeigt. section_3920C857270A406C80BE6CBAC8221ECD
Der SiteCatalyst: purchase
-Aufruf kann nicht für Traffic-Daten des Einkaufsalgorithmus verwendet werden. Verwenden Sie stattdessen den Aufruf orderConfirmPage
.
Aktivitätspriorität prüfen section_3D0DD07240F0465BAF655D0804100AED
Formularbasierte Aktivitäten, die mit Target Standard/Premium erstellt wurden, kollidieren möglicherweise mit Aktivitäten, die in der Benutzeroberfläche von Target Classic erstellt wurden und die gleiche Target-Anforderung verwenden.
Benutzerdefinierter Code generiert keine erwartungsgemäßen Ergebnisse in Internet Explorer 8. section_FAC3651F19144D12A37A3E4F14C06945
Target unterstützt IE 8 nicht mehr.
Target-Cookie wird nicht gesetzt section_77AFEB541C0B495EB67E29A4475DF960
Wenn Ihre Site eine Unterdomäne besitzt, z. B. us.domain.com, das Target-Cookie aber auf domain.com gesetzt werden muss (anstatt auf us.domain.com), dann müssen Sie die Einstellung cookieDomain
überschreiben. Weitere Informationen finden Sie unter targetGlobalSettings().
Der Target-Inhalt flackert oder wird nicht angezeigt, wenn ein Element ebenfalls Teil einer Personalisierung von Adobe Experience Manager ist. section_9E1DABEB75AB431FB9F09887E6DD07D3
Wenn ein DOM-Element zum Adobe Experience Manager-(AEM)-Personalisierungstargeting und zu einer Target-Aktivität gehört, flackert der Target-Inhalt möglicherweise, oder er wird nicht angezeigt.
Um dies zu beheben, können Sie die AEM-Personalisierung für Seiten deaktivieren, auf denen Target ausgeführt wird.
Umleitungs- und Remote-Angebote können aufgrund einer ungültigen URL nicht bereitgestellt werden. section_7D09043B687F43B39DAEDF17D00375AC
Wenn das Umleitungs- oder Remote-Angebot eine ungültige URL verwendet, kann es möglicherweise nicht bereitgestellt werden.
Bei Umleitungsangeboten kann die Target-Antwort /* invalid redirect offer URL */
enthalten.
Oder
Bei Remote-Angeboten kann die Target-Antwort /* invalid remote offer URL */
enthalten.
Sie können die Target-Antwort im Browser oder mit mboxTrace überprüfen. Weitere Informationen zu gültigen URLs finden Sie unter https://tools.ietf.org/html/std66.
Target-Anforderungen werden auf meiner Site nicht ausgelöst.
at. js löst keine Target-Anforderungen aus, wenn Sie einen ungültigen Doctype verwenden. at.js erfordert den Doctype HTML 5.
Stellen Sie sicher, dass Target-Aktivitäten URLs mit Abfragezeichenfolgen-Parametern korrekt verarbeiten. query-strings
Der Activity URL bestimmt die Seite, die Besucher für die Aktivität qualifiziert, und rendert die Aktivitätserlebnisse für Benutzer. Wenn Sie bei der Aktivitätserstellung dazu aufgefordert werden, stellt das Eingeben der vollständigen URL nicht immer sicher, dass der Inhalt auf dieser Website auch bereitgestellt wird, insbesondere bei URLs, die Abfragezeichenfolgen-Parameter enthalten.
Standardmäßig öffnet der VEC (0) die Seite, die in Ihren Visual Experience Composer-Einstellungen angegeben ist. Visual Experience Composer Sie können während der Erstellung der Aktivität eine andere Seite angeben.
Um nach dem Öffnen des VEC eine andere Seite anzuzeigen, klicken Sie auf Configure gear icon > wählen Sie Page Delivery > und geben Sie dann die gewünschte URL im Feld Activity URL an.
Was aber, wenn die URL Abfragezeichenfolgen-Parameter enthält? Funktioniert es und zeigt den personalisierten Inhalt an? In diesem Szenario können Sie unabhängig von Ihrer Zielgruppe zusätzlich zur Basis-URL Vorlagenregeln hinzufügen, um Ihre Abfrageparameter zu definieren.
Die folgenden Optionen können verwendet werden, um zusätzliche Vorlagenregeln einzuschließen:
Option 1: Replizieren Sie die URL und behalten Sie sie in der Vorlagenregel bei der Option "enthält".
Diese Option stellt sicher, dass diese URL für die Aktivität geeignet ist. Beachten Sie jedoch, dass damit Sonderfälle verbunden sind, die Ihre Berichtsdaten mit zusätzlichen Datensätzen zu URLs beeinflussen können, die die Basis-URL enthalten.
In diesem Szenario lautet die URL https://shopping.mycart.com?type=Summers%20Offers
, und zusätzliche Vorlagenregeln „enthalten“ dieselbe URL, getrennt durch einen OR-Operator:
Option 2: Schränken Sie die URL-Bedingung "enthält"nur mit der Abfragezeichenfolge ein.
Der in der vorherigen Option beschriebene Sonderfall wird in dieser Option angewendet, aber hier ist die bedingte Einrichtung auf die Abfragezeichenfolge beschränkt.
In diesem Szenario lautet die URL https://shopping.mycart.com?type=Summers%20Offers
und zusätzliche Vorlagenregeln „enthalten“ nur die Abfragezeichenfolge, getrennt durch einen OR-Operator:
Option 3: Verwenden Sie anstelle der vollständigen URL einen bestimmten Teil der URL.
In diesem Szenario ist die URL https://shopping.mycart.com?type=Summers%20Offers
und zusätzliche Vorlagenregeln geben einen Query mit type > is (case sensitive) > type=Summers%20Offers an, getrennt durch einen ODER-Operator:
Das Escapen doppelter Anführungszeichen im Profilattributwert Target funktioniert nicht erwartungsgemäß. escape
Wenn Sie Werte senden, die doppelte Anführungszeichen in einem Profilattribut vom Typ Target enthalten, müssen Sie wie unten gezeigt eine doppelte Escape-Sequenz verwenden.
adobe.target.trackEvent({
"mbox": "data-collection",
"params": {
"profile.tagLine": "Escape \\\"Double Quotes\\\" like this."
}
});
Schulungsvideos
In den folgenden Videos erhalten Sie weitere Informationen zu den in diesem Artikel behandelten Konzepten.