google.
Bu sınıf, reklamları görüntülemek için kullanılan kapsayıcıyı temsil eder. SDK, video ve yer paylaşımlı reklamları barındırmak için otomatik olarak containerElement parametresinin içinde yapılar oluşturur.
Bu sınıfın bir örneği oluşturulduğunda, containerElement'te bir IFRAME oluşturur ve SDK temelini yükler. SDK'nın düzgün çalışabilmesi için bu IFRAME korunmalıdır. Tüm reklamlar oynatıldıktan sonra SDK'ya artık ihtiyaç duyulmuyorsa SDK'yı kaldırmak için destroy() yöntemini kullanın.
containerElement parametresi, DOM'da yer alan bir öğe olmalıdır. Reklamların doğru şekilde gösterilmesi için containerElement'in doğru şekilde konumlandırılması gerekir. Video oynatıcıyı, video oynatıcının üst kısmına yerleştirip tüm video oynatıcıyı kapsayacak şekilde boyutlandırmanız önerilir. Önerilen uygulamalarla ilgili ayrıntılar için SDK belgelerine bakın.
Not: Bir kullanıcı işlemi (ör. tıklama veya dokunma) tarafından doğrudan çağrılan kodda initialize() yönteminin çağrılması her zaman gereklidir.
Marka
ReklamGörüntülüKapsayıcı
yeni AdDisplayKapsayıcı(containerElement, videoElement, clickTrackingElement)
Parametre |
|
|---|---|
|
containerElement |
Reklamların gösterileceği öğe. AdDisplayKapsayıcı oluşturulmadan önce öğenin DOM'a eklenmesi gerekir. Değer boş olmamalıdır. |
|
video Öğesi |
İsteğe bağlı Alternatif video reklam oynatma öğesini belirtir. İçerik video oynatıcınızı her zaman iletmenizi öneririz. Değer boş olmamalıdır. |
|
tıklamaİzlemeÖğesi |
İsteğe bağlı Alternatif video reklam tıklama öğesini belirtir. SDK'nın tıklamaları işlemesine izin vermek için bu değeri boş bırakın. Sağlanmış olsa bile SDK, özel tıklama izleme öğesini yalnızca AdSense/AdX olmayan reklam öğeleri bir video oynatıcı (örneğin, iPhone veya 4.0 öncesi Android) ile yer paylaşımlı kullanıcı arayüzü öğelerini desteklemeyen ortamlarda görüntülendiğinde kullanır. SDK'nın oluşturduğu kullanıcı arayüzü öğelerine yapılan tıklamalara müdahale edebileceğinden özel tıklama izleme öğesi hiçbir zaman video oynatıcıda oluşturulmamalıdır. Ayrıca SDK'nın, özel tıklama izleme öğesinin görünürlüğünü değiştirmeyeceğini unutmayın. Bu, özel bir tıklama izleme öğesinin sağlanması durumunda, doğrusal reklam oynatıldığında öğenin düzgün bir şekilde görüntülenmesi gerektiği anlamına gelir. Özel tıklama izleme öğenizin gösterilip gösterilmeyeceğini belirlemek için ima.AdEvent.Type.STARTED etkinliği tetiklendiğinde ima.AdsManager.isCustomClickTrackingUsed öğesini kontrol edebilirsiniz. Kullanıcı arayüzünüz için uygunsa ima.AdEvent.Type.CONTENT_RESUME_REQUESTED etkinliği tetiklendiğinde tıklama izleme öğesini gizlemeniz gerekir. Değer boş olmamalıdır. |
Yöntemler
destroy
yok et()
Dahili durumu ve daha önce oluşturulan DOM öğelerini yok eder. IMA SDK kaldırılır ve API'lere çağrı yapılmaması gerekir.
ilk kullanıma hazırlamak
initialize()
Dahili video öğelerini oynatma için başlatır. Tarayıcının video öğesini kullanıcı tarafından başlatıldı olarak işaretleyebilmesi için bu yöntemi bir kullanıcı işleminin doğrudan sonucu olarak çağırmanız gerekir.
Videonun sesi kapalıysa bazı tarayıcılar kullanıcı etkileşimleri olmadan video oynatmaya izin verir. Bu davranış için AdsRequest.setAdWillPlayMuted(true) yöntemini kullanın ve AdsManager.start() tarihinden önce bu yöntemi çağırın.