DoubleClick Rich Media

Puoi avviare l'espansione o la compressione di una creatività espandibile chiamando la classe Expanding nell'API di DoubleClick Studio. Analogamente, puoi utilizzare il metodo di espansione automatica per avviare una creatività nello stato espanso.

Nei passaggi precedenti, hai imparato ad aggiungere il componente Espansione alla creatività e a utilizzare l'API per impostare una funzione di espansione e una di compressione. Dopo aver impostato l'espansione di base nelle tue unità, puoi configurare la tua creatività per l'espansione automatica.

Come faccio a configurare la funzione di espansione automatica?

Nel file principale oppure all'inizio della sequenza temporale nel riquadro compresso, effettua una chiamata a questo metodo:

Expanding.startExpanded(panelName:String).

PanelName(panelName:String) è facoltativo; viene utilizzato per trasmettere il nome del riquadro secondario specifico che desideri espandere in modo automatico. Ciò è importante se desideri impostare più riquadri secondari nella creatività espandibile. Se non definisci i riquadri, vengono richiamate le azioni principali di espansione della linea temporale.

Per impostazione predefinita, il metodo Expanding.startExpanded() non tiene automaticamente traccia della metrica di espansione dell'annuncio, a differenza del metodo Expanding.expand(). Se desideri tenere traccia della frequenza con cui la funzione di espansione automatica viene attivata, ti consigliamo di impostare anche un contatore insieme al metodo Expanding.startExpanded().

Per ulteriori informazioni sul tracciamento personalizzato, consulta Aggiunta di tracciamento personalizzato.

Inoltre, per rispettare le specifiche del sito relative alle creatività con espansione automatica, potrebbe essere necessario creare un timer per comprimere automaticamente l'unità trascorso un numero specifico di secondi. Per ulteriori informazioni sulla compressione automatica, vedi Impostazione della funzione di compressione automatica in questa Guida allo sviluppo.

Come posso impostare un riquadro a espansione automatica e un riquadro con inizializzazione da parte dell'utente?

Per impostare due riquadri diversi per un'espansione automatica e un'espansione con inizializzazione da parte dell'utente, devi aggiungere due diversi riquadri secondari al componente Espansione. Puoi aggiungere riquadri secondari espansi mentre stai aggiungendo il componente Espansione al file principale. In questo esempio, i due riquadri secondari sono auto e user.

1. Impostazione del riquadro secondario auto per l'espansione automatica

   Apri la finestra Controllo componenti del componente Espansione nel file principale. Assegna il nome "auto" al riquadro secondario che desideri espandere in modo automatico.

   Nel primo frame del riquadro compresso, chiama il metodo di espansione automatica expanding.startExpanded("auto").

   Promemoria di Studio

   Ogni volta che effettui una chiamata alla classe Expanding dall'API di DoubleClick Studio in un nuovo file, ricorda di importare StudioClassAccessor e di acquisire un riferimento alla classe Expanding con questo codice:

   import com.google.ads.studio.utils.StudioClassAccessor;

//Get a reference to the Expanding class
var expanding:Object = StudioClassAccessor.getClass(StudioClassAccessor.CLASS_EXPANDING)["getInstance"]();



2. Impostazione del riquadro secondario user per l'espansione al momento del clic

   Apri la finestra Controllo componenti del componente Espansione nel file principale. Assegna il nome "user" al riquadro secondario che desideri espandere al verificarsi dell' interazione dell'utente.

   Nel riquadro compresso, imposta un oggetto Clic per effettuare una chiamata al metodo di espansione expanding.expand("user").

   Se hai già impostato un pulsante di espansione personalizzato seguendo le istruzioni riportate in Impostazione di un'espansione di base, aggiungi il nome del riquadro secondario "user" alla funzione di espansione esistente.

Prova!