Erstellungsanleitung für Expanding-Creatives

Polite Load einrichten

Was ist Polite Load?

Mit Polite Load wird das Laden weiterer Creative-Assets, wie z. B. der untergeordneten SWF-Datei, verzögert, bis die Seite fertig geladen wurde.

3-part polite load image: a) website partly loaded b) website fully loaded c) full ad appears including video

blue letter A Seite zu 20 % geladen: Es wird die übergeordnete Datei angezeigt.

green letter b Seite zu 50 % geladen: Es wird die übergeordnete Datei angezeigt.

red letter c Seite zu 100 % geladen: Es wird die untergeordnete Datei angezeigt.

DoubleClick Studio erfordert nicht, dass Ihre Dateien Polite Load verwenden, die meisten Websites aber schon, wenn sie ein Creative laden, das über 40 KB groß ist. Dadurch können Nutzer Verzögerungen beim Besuch dieser Websites vermeiden.

Wenn Sie Polite Load verwenden, können Sie die Zeitachse Ihres Flash-Clips anhalten, bis die Seite geladen ist, und anschließend steuern, wie mit dem Creative weiter verfahren wird.

Wie richte ich Polite Load ein?

Es gibt zwei Möglichkeiten zum Einrichten eines Polite Loads in Studio-Creatives: mit der Loader-Komponente oder mit der API. Es empfiehlt sich, nur eine dieser beiden Optionen zu verwenden.

Option 1: Loader-Komponente
Mithilfe der Loader-Komponente können Sie ein Polite Load ohne Code abwickeln. Ziehen Sie den Loader in den Anzeigebereich und nehmen Sie einige wenige Einstellungen im Komponentenprüftool vor. Zusätzlicher Content wird in die Loader-Komponente geladen.

So verwenden Sie die Komponente:

Setup section of Loader component inspector in Flash with the "Wait for page load to perform action" checkbox highlighted, labeled A, and the "Load movie" text field highlighted as well and labeled B. "Load movie..." is next to a radio button under the heading "Action to perform."
  1. Ziehen Sie die Komponente in den Anzeigebereich auf eine neue Ebene mit der Bezeichnung "Loader". Achten Sie darauf, die Loader-Komponente auf einer oberen Ebene hinzuzufügen, damit das untergeordnete SWF-Element über dem anderen Content Ihrer Datei geladen wird.
    • Zum Zugriff auf diese Komponente ziehen Sie diese aus dem Komponenten-Steuerungsfeld in Flash und legen Sie ab (Direktzugriff: Strg+F7; Mac: Befehlstaste+F7).
  2. Bearbeiten Sie das Komponentenprüftool:

    Aktivieren Sie die Option Führen Sie die Aktion erst durch, wenn die Seite geladen ist.

    Wählen Sie unter Durchzuführende Aktion: den Befehl Clip laden... aus und geben Sie den Namen des untergeordneten SWF-Elements in das Textfeld ein.

  3. Positionieren Sie die Loader-Komponente dort, wo die untergeordnete Datei geladen werden soll. Die Komponente ist in der veröffentlichten Datei nicht sichtbar, aber die Position des Loaders dient als Basisachse (x:0, x:0) für das untergeordnete SWF-Element.
     
  4. Wenn Sie die Einheit in Flash testen, wartet sie einige Sekunden, um den Polite Load-Prozess zu simulieren, und lädt dann das untergeordnete Element in die Loader-Komponente.
Video über die Loader-Komponente anschauen (5:37)
Option 2: API
Diese Erstellungsanleitung richtet sich an AS3-Nutzer. Wenn Sie AS2 verwenden, lesen Sie AS2 Loader API.

Mithilfe der API können Sie ein Polite Load ausschließlich mittels ActionScript bei geringstmöglicher Ladung abwickeln.

Führen Sie eine Überwachung auf das Ereignis PAGE_LOADED aus dem Enabler durch. Laden Sie dann den untergeordneten Inhalt mithilfe der Klasse Studio Loader. Beim Beispiel unten wird gewartet, bis die Seite geladen wurde, und dann wird child.swf in einen MovieClip namens "holderMC" geladen.

import com.google.ads.studio.HtmlEnabler;
import com.google.ads.studio.events.StudioEvent;
import com.google.ads.studio.display.StudioLoader;
import flash.events.Event;

var enabler:HtmlEnabler = HtmlEnabler.getInstance();
enabler.init(this);

var loadedHandler:Function = function(event:StudioEvent):void {
    var myLoader:StudioLoader = new StudioLoader();
    var req:URLRequest = new URLRequest("child.swf");
    //optional, if you want to listen for load completion:
    myLoader.contentLoaderInfo.addEventListener(Event.COMPLETE, loadComplete);
    myLoader.load(req);
    holderMC.addChild(myLoader);
}

function loadComplete(event:Event):void{
  //child.swf has now loaded
}
enabler.addEventListener(StudioEvent.PAGE_LOADED, loadedHandler);

Jetzt ausprobieren

Richten Sie ein Polite Load in Ihrer übergeordneten Datei ein, indem Sie die Loader-Komponente hinzufügen oder die API verwenden.

Ihre Arbeit testen

Als Erstes veröffentlichen Sie alle Ihre untergeordneten SWF-Dateien in Flash. Anschließend führen Sie die übergeordnete Datei in Flash aus. Die folgenden Einträge sollten im Ausgabefeld erscheinen:

    Enabler: Seitenladevorgang wird simuliert.
    Enabler: Seite geladen