Questa guida è rivolta ai publisher interessati ad aggiungere annunci companion all'implementazione IMA per Android.
Prerequisiti
- un'applicazione Android con l'SDK IMA integrato. Consulta BasicExample se non hai ancora un'app con l'SDK integrato.
- Un tag annuncio configurato per restituire un annuncio companion.
- Se hai bisogno di un esempio, consulta le nostre Domande frequenti.
Istruzioni utili
Se devi ancora implementare l'SDK IMA nella tua app, consulta la nostra Guida introduttiva.
Aggiungi annunci companion alla tua app
Crea un gruppo di visualizzazioni per visualizzare il companion
Prima di richiedere un companion, devi creare uno spazio nel layout. Nel file XML di layout, aggiungi un elemento ViewGroup
. In questo
esempio viene utilizzato un elemento LinearLayout
. In un passaggio successivo passerai un
riferimento a questo elemento a AdDisplayContainer
.
Se esegui l'integrazione nell'app BasicExample, aggiungila a
activity_my.xml
sotto com.google.android.exoplayer2.ui.PlayerView
.
activity_my.xml
<LinearLayout android:id="@+id/companionAdSlot" android:layout_width="match_parent" android:layout_height="250dp" android:layout_gravity="center_horizontal" android:gravity="center" android:orientation="vertical" android:textAlignment="center" />
Crea un'area annuncio companion
Il passaggio successivo consiste nel creare un oggetto CompanionAdSlot
, che viene
aggiunto a un ArrayList<CompanionAdSlot>
.
AdDisplayContainer
crea un elenco di aree annuncio companion per consentirti di visualizzare più annunci companion contemporaneamente. Dovrai creare un'istanza di ImaSdkFactory
per creare CompanionAdSlot
.
ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance(); ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot); CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(); companionAdSlot.setContainer(companionViewGroup); companionAdSlot.setSize(300, 250); ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>(); companionAdSlots.add(companionAdSlot);
Crea un'area annuncio companion per ogni dimensione dell'annuncio companion che intendi mostrare nella tua app.
L'SDK IMA completa l'area annuncio companion con eventuali companion provenienti dalla risposta VAST con dimensioni corrispondenti all'altezza e alla larghezza della visualizzazione. L'SDK IMA supporta inoltre l'utilizzo di compagni con dimensioni flessibili.
Dopo aver creato companionAdSlots
, devono essere aggiunti a
AdsLoader
. I seguenti esempi mostrano come eseguire questa operazione a seconda che utilizzi l'IMA Android BasicExample, che usa l'estensione Exoplayer-IMA, oppure altre implementazioni IMA che non utilizzano l'estensione.
BasicExample
adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();
Altre implementazioni
adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);
E con questo è tutto! La tua applicazione ora mostra annunci companion.
Mostra annunci companion flessibili
Ora IMA supporta gli annunci companion flessibili. Questi annunci companion possono essere ridimensionati per adattarsi alle dimensioni dell'area annuncio. Riempiono il 100% della larghezza della vista principale, poi ridimensionano la propria altezza per adattarsi ai contenuti dell'annuncio companion. Vengono impostate utilizzando la dimensione companion Fluid
in Ad Manager. Vedi l'immagine di seguito per sapere dove impostare questo valore.
![Immagine che mostra le impostazioni degli annunci companion di Ad Manager. Evidenzia l'opzione relativa alle dimensioni companion.](https://developers.google.cn/static/interactive-media-ads/images/ad_manager_fluid_companion.png?authuser=5&hl=it)
Aggiorna le app Android per creare companion flessibili
Per dichiarare un'area companion flessibile, aggiorna il metodo CompanionAdSlot.setSize()
in modo da utilizzare CompanionAdSlot.FLUID_SIZE
come entrambi i parametri.
ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance(); ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot); CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(); companionAdSlot.setContainer(companionViewGroup); companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE); ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>(); companionAdSlots.add(companionAdSlot);
Domande frequenti
- Ho seguito la guida, ma non visualizzo annunci companion. Che cosa devo fare?
- Innanzitutto, verifica che il tuo tag restituisca davvero delle creatività companion. Per farlo, apri il tag in un browser web e cerca un tag CompanionAds. In questo caso, verifica che le dimensioni dell'annuncio companion restituito siano uguali a quelle trasferite nell'oggetto
CompanionAdSlot
. - Che aspetto avrà la mia area annuncio companion quando seguo questa guida?
-
L'immagine seguente è stata creata da
BasicExample
e presenta il video di contenuti in alto con l'annuncio companion riportato di seguito.