Show Menu
THEMEN×

DFA-Integration

Bei der Konfiguration der DFA-Integration sind folgende Aufgaben enthalten:

Konfigurieren der DFA-Integration

Gehen Sie die DFA-Data Connectors-Integration schrittweise durch.
Auf den Konfigurationsseiten erhalten Sie einen Überblick über die Integration sowie praktische Links für weitere Informationen. Für diese Integration fallen sowohl Adobe- als auch DoubleClick-Gebühren an. Wenden Sie sich an die jeweiligen Verkaufsmitarbeiter der beiden Unternehmen und versichern Sie sich, dass Sie die Zusammensetzung der Gebühren verstehen.
  1. Log in to the Adobe Analytics.
  2. Click Admin > Data Connectors .
  3. Locate DoubleClick DFA , then click Add New .
    Geben Sie auf den Seiten des Integrationsassistenten die jeweiligen Informationen an und klicken Sie auf Weiter . In der folgenden Tabelle werden die Informationen näher erläutert, die für den Abschluss der Integration mithilfe des Assistenten erforderlich sind.
Assistentenseite Nr. Feld Beschreibung
1 Integrationsname Der Integrationsname, den Genesis in der Liste der aktiven Integration der Report Suite anzeigt.
1 Integrations-E-Mail-Adresse Die E-Mail-Adresse, an die sämtliche Benachrichtigungen zu dieser Integration gesendet werden.
2 Benutzername Der für diese Integration zu verwendende DFA-API-Benutzername. Überprüfen Sie das API-Attribut in der DFA-Oberfläche, um Benutzern die API-Anmeldung zu ermöglichen. Nach der Aktivierung der API-Anmeldung wird ein Feld angezeigt, in dem ein Passwort für den Benutzer angegeben werden muss. Dieses Passwort muss zur Authentifizierung gemeinsam mit dem Benutzernamen beim Assistenten eingegeben werden.
2 Passwort Das DFA-API-Passwort
2 Advertiser-ID
Die DFA-Advertiser- bzw. übergeordnete Floodlight-Konfigurations-ID Data Connectors verwendet diese ID, um den zu trackenden DFA-Advertiser zu identifizieren (Version 1.5 der Integration). Diese Advertiser-ID wird in Version 2.0 der Integration nicht verwendet. Die übergeordnete Floodlight-Konfigurations-ID wird nachgeschlagen und verwendet. Anweisungen werden auf dem Bildschirm angezeigt.
3 DFA-Anzeigenvariable Die Analytics-eVar, die Daten zum DFA-Kampagnenattribut, Impressionen und Klicks empfängt Dabei handelt es sich im Normalfall um die Trackingcode-eVar ( s.campaign ), but you can choose any available eVar. Data Connectors fügt außerdem die folgenden DFA-bezogenen Classifications zur ausgewählten eVar hinzu:
Kampagnen : Eine Sammlung an Anzeigen mit gemeinsamer Botschaft, die auf mehreren Sites bereitgestellt werden
Sitename : Die Site, auf der die Anzeige bereitgestellt wurde
Anzeigenname : Der in Ihrem DFA-Konto festgelegte Anzeigenname
Siteplatzierungsname : Die Website und Seite, auf der die Anzeige bereitgestellt wurde
Bereitstellungswerkzeug : DoubleClick for Advertisers
Kanal : Banneranzeige
Kostenzusammensetzung : CPM, CPC oder fest, je nach Kostenzusammensetzung der Anzeige
Creative-Name : Der Name der kreativen Inhalte im Zusammenhang mit einer Anzeige/Platzierung/Creative-ID
DFA > SearchCenter-Deduplizierung : Legt fest, dass DFA Werte in SearchCenter-Variablen eingibt, wenn DFA-Clickthrough- oder Durchsichtsaktionen ausgeführt werden. .
4 Impressionen Das benutzerspezifische Ereignis, an das DFA-Impressionsmetrikdaten gesendet werden. Impressionen stellen die Anzahl an Bereitstellungen der Anzeige dar.
4 Klicks Wählen Sie das benutzerspezifische Ereignis, an das DFA-Klickmetrikdaten gesendet werden. Klicks geben an, wie oft Besucher auf die Anzeige geklickt haben, gemessen an der Umleitung durch DFA. Die Klickmetrik steht in Zusammenhang mit der Analytics-Clickthrough-Metrik.
Hinweis: DFA-Klicks und Analytics-Clickthroughs stimmen aufgrund von Unterschieden in der Erfassungsart der Daten unter Umständen nicht genau überein. .
5 Durchsichtsvariable
Die Analytics-eVar, an die DFA-Durchsichtsdaten gesendet werden Mithilfe der Durchsichtsvariable können Sie erfahren, auf welche Weise Durchsichten die Konversionsraten auf Ihrer Site beeinflussen.
Data Connectors fügt dieselben DFA-bezogenen Classifications zu dieser eVar hinzu wie zur DFA-Anzeigenvariable (weitere Informationen finden Sie oben).
5 Zeit seit letzter Ansicht (Durchsichtszeit-Behältervariable) Die Analytics-eVar, an die die Daten bezüglich der DFA-Zeit seit der letzten Ansicht gesendet werden Die Zeit seit der letzten Ansicht gibt an, wie viel Zeit seit der letzten Anzeigendurchsicht verstrichen ist.
5 Durchsichten Das benutzerspezifische Ereignis, an das DFA-Durchsichtsmetrikdaten gesendet werden Verwenden Sie das Durchsichtsereignis mit der Durchsichtsvariable, um zu sehen, welche Kampagnen keinen direkten Clickthrough beeinflusst haben, aber möglicherweise eine Rolle dabei gespielt haben, den Traffic zu einem späteren Zeitpunkt zur Site zu leiten.
Data Connectors benennt das ausgewählte benutzerdefinierte Ereignis in "Durchsichten"um.
6 Fehlgeschlagene DFA-Abfrage (Optional) Die Analytics-eVar, an die alle gemeldeten Benachrichtigungscodes zu fehlgeschlagenen DFA-Abfragen gesendet werden Mögliche DFA-Benachrichtigungscodes sind unter anderem:
  • nc : Kein DoubleClick-Cookie (No Cookie)
  • oo : Benutzer ist abgemeldet (Opted Out)
  • nh : Kein Kampagnenverlauf (No History)
  • qe : Abfragefehler (Zeitüberschreitung, Serverausfall usw. – Query Error)
6 Timeout-Ereignis
Das Analytics-Zählerereignis, dessen Wert bei jedem Ablauf von s.maxDelay timer expires, and no response was received from the DFA servers. Use this event to configure the s.maxDelay variable Tuning s.maxDelay .)

Websiteaktualisierungen für die DFA-Integration

Sobald Ihre Analytics-Report Suite für die DFA-Integration von Genesis konfiguriert wurde, müssen Sie Ihre Website und DFA-Umgebung anhand folgender Schritte konfigurieren, damit die Integration unterstützt wird:

Aktualisierung Ihres DFA-Abfragestringparameters

Wenn Sie vor der DFA-Integration Werbekampagnen mit Adobe Analytics getrackt haben, kann es sein, dass für alle Kampagnen (E-Mail, Suche, Banner) derselbe Abfragestringparameter zur Identifizierung der jeweiligen Kampagnen-ID auf der Landingpage verwendet wird.
Zur Erkennung des richtigen Zeitpunkts für Durchsichts- und Clickthrough-Datenabfragen von DFA-Daten für Ihre DFA-Werbekampagnen muss Data Connectors identifizieren können, wann Besucher auf eine DFA-Kampagnenbanneranzeige geklickt haben. Um dies zu ermöglichen, müssen Sie der Landingpage-URL der DFA-Werbekampagne einen differenzierten Abfragezeichenfolgenparameter hinzufügen, damit Data Connectors zwischen DFA-Werbekampagnen-Seiten und anderen Werbekampagnen-Seiten unterscheiden kann, die Sie möglicherweise auf Ihrer Website haben. Das dfa_overrideParam im JavaScript-Plug-in, das für DFA verwendet wird.
Obwohl die Kampagnenvariable für andere Kampagnen verwendet werden kann, sollten Sie sie nicht für DFA-Kampagnen verwenden. Wenn Sie eine DFA-Kampagnenlandingpage für die Kampagnenvariable festlegen, können Impressionen und Klicks nicht von Adobe zu DFA-Kampagnen-Clickthroughs zugeordnet werden. Pro Besuch überprüfen die Adobe-Erfassungsserver die DFA-Server auf vorhandene Clickthrough- oder Durchsichtsaktionen. Fügen Sie daher den DFA-Plug-in-Code nur auf gängigen Landingpages ein, um unnötige Umleitungen zu vermeiden, die die Seitenladezeit verlangsamen können, insbesondere für Benutzer mit langsameren Internetverbindungen.

Aktualisierung des Datenerfassungscodes Ihrer Website

Für die Genesis-Integration für DFA wird die DFA Floodlight-Konfigurations-ID (dfa_SPOTID) verwendet, wodurch die Berichtskonsistenz zwischen DFA und dem Adobe-Datenerfassungssystem verbessert wird.
Der Begriff Spotlight wurde in einer kürzlich veröffentlichten Version von Google DFA in Floodlight geändert. Die Benennung des JavaScript-Parameters dfa_SPOTID basiert auf der Spotlight-Terminologie, wird aber für beide Versionen verwendet.
Aktualisieren Sie durch Hinzufügen folgender Elemente Ihren JavaScript-Datenerfassungscode, um die DFA-Integration auf Ihrer Website zu aktivieren:
  • Integrate-Modul für DFA
  • Zusatz zu Ihrem Erfassungscode

Integrate-Modul für DFA

The DFA integration leverages the Adobe Experience Cloud Integrate Module, which adds functionality to your core JavaScript data collection code ( s_code.js ). Das Integrate-Modul wird als Teil der ZIP-Datei angezeigt, wenn Sie den AppMeasurement for JavaScript-Code aus dem Code-Manager herunterladen. Wenden Sie sich an Ihren Adobe-Berater, wenn Sie weitere Hilfe benötigen, um ihn zu finden.
Insert the Integrate Module code in the Modules section of your website's s_code.js file.

Zusatz zu Ihrem Erfassungscode

Basierend auf Ihren Einstellungen bei der Aktivierung der DFA-Integration im Integrationsassistenten wird von Data Connectors ein benutzerdefinierter Zusatz zu Ihrem JavaScript-Datenerfassungscode erstellt, den Sie per E-Mail erhalten. Geben Sie diesen Code in den Hauptabschnitt der Datei s_code.js (nicht in die Funktion doPlugins oder andere Funktionen) ein.
Der unten gezeigte Code dient nur zu Anschauungszwecken. Verwenden Sie den Code, den Sie nach Abschluss des Data Connectors-Integrationsassistenten per E-Mail erhalten haben.
Der Erfassungscode besteht aus folgenden Elementen:
  • DFA Integrate-Einstellungen
  • Für die Integration erforderliche Plug-ins
DFA Integrate-Einstellungen
/************************** DFA VARIABLES **************************/ 
var dfaConfig = { 
   CSID:              "1234567", 
   SPOTID:            "29876543", 
   tEvar:             "eVar17", 
   errorEvar:         "eVar59", 
   timeoutEvent:      "event76", 
   requestURL:         "http://fls.doubleclick.net/ 
json?spot=[SPOTID]&src=[CSID]&var=[VAR]&host=integrate.112.2o7.net%2 
Fdfa_echo%3Fvar%3D[VAR]%26AQE%3D1%26A2S%3D1&ord=[RAND]", 
 
   maxDelay:          "1500", 
   visitCookie:       "s_dfa", 
   clickThroughParam: "CID", 
   searchCenterParam: "s_kwcid", 
   newRsidsProp:      undefined 
}; 
/************************ END DFA Variables ************************/ 

Im DFA Integrate-Einstellungsblock werden die Variablen festgelegt, die für die DFA-Integration erforderlich sind. Die Werte für diese Variablen stammen aus folgenden Quellen:
CSID : Client-Site-ID. Wird nach dem Abschluss des Integrationsassistenten von DFA erstellt Diese Variable wird von Data Connectors mit Ihrer DFA-CSID ausgefüllt. Sie erhalten diesen Wert außerdem in der Einrichtungs-E-Mail nach Abschluss des Integrationsassistenten. Diese Variable ist nicht erforderlich, wenn in Ihrem Konto das erweiterte AdServing aktiviert ist.
SPOTID : Floodlight-Konfiguration (früher Spotlight-ID) Diese Variable wird auf Basis der von Ihnen im Integrationsassistenten angegebenen DFA-Kontoinformationen von Data Connectors mit Ihrer DFA Floodlight-Konfigurations-ID ausgefüllt.
tEvar : Übertragungsvariable Diese Variable wird von Data Connectors mit dem Analytics-Variablennamen ausgefüllt, den Sie im Integrationsassistenten für die Durchsichtsvariable festgelegt haben. Ändern Sie diesen Wert nicht, ohne dies vorher sorgfältig mit Adobe Engineering oder Engineering Services abzuklären.
errorEvar : Fehlervariable Diese Variable wird von Data Connectors mit dem Analytics-Variablennamen ausgefüllt, den Sie im Integrationsassistenten für die DFA-Abfragefehlervariable festgelegt haben.
timeoutEvent : Timeoutereignis Diese Variable wird von Data Connectors mit dem Analytics-Variablennamen ausgefüllt, den Sie im Integrationsassistenten für die Timeoutereignisvariable festgelegt haben.
requestURL : DFA-Remotehost zur Abfrage von Anzeigeninformationen Ändern Sie diesen Wert nur, wenn Sie eine entsprechende Anweisung von Adobe erhalten.
maxDelay : Anzahl der Millisekunden, die der JavaScript-Datenerfassungscode auf eine Reaktion vom DFA Floodlight-Server wartet. Adobe empfiehlt, mit diesem Wert zu experimentieren, um den optimalen Wert basierend auf dem Traffic Ihrer Site zu ermitteln. Generell werden durch das Erhöhen dieses Werts zum Beispiel mehr DFA-Daten erfasst, aber dabei steigt das Risiko, grundlegende Besucherdaten zu verlieren, wenn Besucher die Site während der Verzögerungsphase verlassen. Wenn Sie diesen Wert reduzieren, sinkt das Risiko, Trefferdaten zu verlieren, dadurch kann sich allerdings auch die Anzahl der DFA-Daten verringern, die mit den Adobe-Trefferdaten gesendet werden.
visitCookie : Name des Cookies, mit dem DFA-Aufrufe auf einen pro Besuch beschränkt werden.
clickThroughParam : Abfragestring, der normalerweise in allen Anzeigen enthalten ist und dem Integrate-Modul vermittelt, wenn ein Klick stattgefunden hat. Dieser Parameter im Abfragestring führt dazu, dass die Abfrage vom DFA Floodlight-Server stattfindet, auch wenn die Abfrage des Besuchers in den letzten 30 Minuten bereits stattgefunden hat.
newRsidsProp : (Optional) Einer nicht verwendeten Datenverkehrseigenschaftsvariablen zugeordnet Dieser Wert wird von der DFA-Integration im Besuchercookie erfasst und gespeichert, um so die Report Suites zu identifizieren, die Daten zu einem speziellen Besucher erfasst haben. Diese Eigenschaft ist nur für benutzerdefinierte Implementationen für Adobe Engineering Services erforderlich.
Für die Integration erforderliche Plug-ins
Der Erfassungscodezusatz enthält zusätzliche Plug-ins, die die Funktion der DFA-Integration verbessern:
  • DFA-Abfragen werden auf eine pro Besuch beschränkt.
  • Flexibilität bei Cookienamen ist gewährleistet. Die meisten Organisationen verwenden s_dfa, Sie können für die DFA-Integration aber jeden beliebigen zulässigen Cookienamen verwenden.
  • Unnötige Weiterleitungen werden vermieden. Adobe-Erfassungsserver und DFA können praktisch bei jeder Seitenansicht Daten austauschen, da die Durchsichtsdaten in Echtzeit erfasst werden. Dieser Datenaustausch wird vom Plug-in verhindert, wenn die Informationen nicht notwendig sind.
Einer der Mechanismen, die das Plug-in zur Beseitigung unnötiger DFA-Abfragen verwendet, ist ein domänenbasiertes Besuchscookie. Eine Integrations-Report Suite, die mehrere Domänen umfasst, erhöht die Clickthrough- und Durchsichtsdaten, wenn Besucher nach einer DFA-basierten Durchsichts- oder Clickthrough-Aktion die Domäne wechseln.

Bestätigung einer erfolgreichen DFA-Integration befolgen

Nachdem Sie alle notwendigen Websiteaktualisierungen vorgenommen haben, können Sie einen Viewer für den Datenverkehr im Netzwerk wie Charles*, Chrome Developer Tools oder Firebug* verwenden, um zu überprüfen, ob DFA mit den Adobe-Erfassungsservern kommuniziert.
Verwenden Sie den Viewer für den Datenverkehr im Netzwerk, nachdem Sie die DFA-aktivierte s_code.js -Datei bereitgestellt haben, um die Anfragen zwischen DFA und den Adobe-Datenerfassungsservern anzuzeigen und nach Folgendem zu suchen:
  • A request to DFA's fls.doubleclick.net/json service. Die Reaktion dieses Service kann je nach verwendeter DFA-Version unterschiedlich ausfallen. Mit DFA-Integrationsversion 1.5:
    • HTTP-302-Weiterleitung auf ad.doubleclick.net Dadurch wird mit der Reaktion ein „Ort:“-Tag gesendet, in dem Informationen zum Anzeigenbesucher enthalten sind.
    • This Location tag causes a redirect to integrate.112.2o7.net/dfa_echo. Mit diesem Service werden die Informationen über Anzeigenbesucher in einen verschlüsselten JSON-String (JavaScript Object Notation) übertragen. Diese Daten werden mit einer HTTP-200-Reaktion „OK“ zurückgegeben.
  • DFA-Integrationsversion 2.0 (erweitertes AdServing aktiviert):
    • fls.doubleclick.net gibt direkt 200 „OK“ zurück.
In jedem Fall erzeugt eine erfolgreich durchgeführte Anfrage eine Abfrage der Adobe-Datenerfassungsserver, die den Parameter vX enthält. X ist dabei die Durchsichts-eVar-Nummer. Dieser Parameterwert liegt in diesem Format vor: DFA-XXXX-XXXX- XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX. Dieser String enthält Informationen zum letzten Klick und zur letzten Impression für den aktuellen Besucher.

Abstimmung von s.maxDelay

Zu einer erfolgreichen DFA-Implementierung gehört auch ein optimierter Wert für s.maxDelay auf Ihrer entsprechenden Site.
Im Allgemeinen s.maxDelay besteht die Entscheidung, die Daten zu erhöhen oder zu senken, in einem Kompromiss zwischen dem Abrufen von mehr DFA-Besucherdaten und der Gefährdung der Erfassung von Adobe-Besucherdaten. Increasing s.maxDelay obtains more DFA visitor data, but (placed excessively high) could endanger the collection of Adobe visitor data. Senken Sie s.maxDelay, ist die Erfassung von Adobe-Besucherdaten gewährleistet, aber es können DFA-Besucherdaten verloren gehen.
s.maxDelay beinhaltet mehr als nur die Zeit für die Netzwerkkommunikation zur Kontaktaufnahme mit DFA. Dieser Wert stellt auch Browserverzögerungen dar, die das JavaScript auslösen und evaluieren, auf dem diese Kommunikation basiert. Dies liegt daran, dass das Integrate-Modul den s.maxDelay Timer startet, nachdem es das HTML-Element in das DOM eingefügt hat, das die Daten vom DFA Floodlight-Server abruft. Die Zeit, die der Browser zur tatsächlichen Initiierung der auf diesem neuen HTML-Element basierenden HTTP-Abfrage benötigt, ist abhängig von anderen Bildern oder JavaScript-Dateien, die gleichzeitig geladen werden, der Geschwindigkeit des Besuchercomputers sowie spezifischen Browserimplementationen. Bei Abfrage der JSON-Daten vom DFA Floodlight-Server muss außerdem JavaScript vom Browser evaluiert werden. Dieser Vorgang wird wiederum vollständig vom Browser gesteuert und kann verzögert werden, wenn gleichzeitig eine große Menge an JavaScript-Code ausgeführt wird oder viele asynchrone JavaScript-Abfragen vorliegen.
Beachten Sie diese Informationen und legen Sie den Wert für s.maxDelay also auf Grundlage der Komplexität der Landingpage und der Netzwerkverzögerungen bei DFA fest. Auf einigen Seiten können Sie die Komplexität unter anderem dadurch reduzieren, dass der Adobe-Erfassungscode schon früh im Ladeprozess der Seite ausgelöst wird. So muss der Browser weniger Daten verarbeiten, wenn der Floodlight-Server kontaktiert wird.
Die Timeoutvariable ist bei der Abstimmung von s.maxDelay , because it is incremented every time the s.maxDelay timeout is reached. Bei der Entscheidung, ob eine Erhöhung oder Verringerung vorgenommen werden soll, empfehlen wir s.maxDelay Folgendes:
  1. Erfassen Sie Daten aus mehreren Tagen, wobei Sie einen bestimmten Wert s.maxDelay festlegen.
  2. Führen Sie eine Daily Unique Visitors Report für den Zeitraum aus.
  3. Run the Timeout Event Report to check the number of timeouts that are coming through. Bedenken Sie, dass Timeouts nur einmal pro Besucher gezählt werden.
Verwenden Sie anhand dieser Informationen nun
Timeout Percentage = [Step 3] / [Step 2] * 100

Unter „Timeout Percentage“ (Timeoutprozentsatz) werden alle Besucher der Site berücksichtigt. Einige davon haben keinerlei Bezug zu DFA, daher ist der Timeoutwert irreführend. To improve this computation, another analysis could consider only unique visitors to pages with the clickThroughParam set (for example, ?CID=1 ). Dadurch erhalten Sie genauere Ergebnisse.
Liegt der Timeoutprozentsatz sehr niedrig, sollten Sie s.maxDelay . Liegt er sehr hoch, erhöhen Sie s.maxDelay . When decreasing s.maxDelay , you will want to rerun the Timeout Report to ensure that timeouts have not dramatically increased. Bei einer Erhöhung s.maxDelay sollten Sie eine ausführen, Page Views Report um sicherzustellen, dass Seitenansichten nicht aufgrund verlorener Daten ausfallen. Each time s.maxDelay is changed observe the data for several days in order to ensure that the data represents a trend, and not just a day-to-day fluctuation.
The optimal setting for s.maxDelay is the point at which the timeout percentage is minimized while Page Views do not drop off.
Wenn Sie zu Version 2.0 der Integration wechseln, wird die Anzahl der Timeouts voraussichtlich abnehmen, da die 302-Weiterleitungen wegfallen. Erste Ergebnisse von Beta-Kunden zeigen einen gleichmäßigen Rückgang der Timeouts, wodurch mehr DFA-Daten erfasst werden können.