AdConfig
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Panggilan adConfig() mengomunikasikan konfigurasi game saat ini ke
Ad Placement API. Ad Placement API dapat menggunakan ini untuk menyesuaikan cara memuat iklan terlebih dahulu dan memfilter jenis iklan yang dimintanya agar sesuai (misalnya, iklan video yang memerlukan suara).
Tanda tangan fungsi:
adConfig({
preloadAdBreaks: 'on|auto', // Ad preloading strategy
sound: 'on|off' // This game has sound
onReady: () => {}, // Called when API has initialised and adBreak() is ready
});
Parameter adConfig
| Nama |
Jenis |
Deskripsi |
sound |
string |
(OPSIONAL) Apakah game sedang memutar suara. Nilai:
- on (default)
- off
Panggilan ini menentukan apakah game Anda memiliki kemampuan suara, dan apakah suara diaktifkan (yaitu tidak dibisukan) sebelum panggilan ke adBreak(). Hal ini membantu Ad Placement API memilih jenis iklan yang tepat untuk game Anda.
Panggil fungsi ini segera setelah status suara game Anda berubah, karena Ad Placement API mungkin harus meminta materi iklan baru, dan hal ini memberikan waktu maksimum untuk melakukannya.
Nilai defaultnya adalah suara aktif. Jadi, sebagian besar game perlu melakukan panggilan ke adConfig() saat dimulai untuk menyatakan bahwa game tersebut mengaktifkan suara. |
preloadAdBreaks |
string |
(OPSIONAL) Apakah iklan harus selalu dimuat sebelumnya sebelum panggilan pertama ke adBreak(). Nilai:
- on
- auto (default)
Nilai default auto menyerahkan keputusan kepada Ad Placement API. preloadAdBreaks hanya dapat ditetapkan satu kali dengan adConfig(), dan nilai lebih lanjut yang diteruskan ke preloadAdBreaks tidak akan berpengaruh.
Menetapkan preloadAdBreaks setelah panggilan pertama ke adBreak() tidak akan berpengaruh. |
onReady |
string |
(OPSIONAL) Dipanggil saat API telah diinisialisasi dan telah selesai memuat iklan terlebih dahulu (jika Anda meminta pemuatan terlebih dahulu menggunakan preloadAdBreaks di atas). |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-26 UTC."],[[["`adConfig()` is used to inform the Ad Placement API about the game's settings, such as sound and ad preloading preferences, for better ad selection and delivery."],["The API uses this information to optimize ad preloading and ensure ads are suitable for the game's context, like avoiding sound-based ads in silent games."],["Developers can specify whether the game has sound enabled using the `sound` parameter and control ad preloading behavior with `preloadAdBreaks`."],["An optional `onReady` callback can be provided to notify the game when the API is initialized and ad preloading is complete, if requested."]]],["The `adConfig()` function communicates the game's settings to the Ad Placement API. It accepts parameters to configure ad behavior: `sound` (specifying if sound is 'on' or 'off'), `preloadAdBreaks` ('on' or 'auto' for preloading ads), and `onReady` (a callback after initialization). `sound` informs the API of the game's sound capability and status, influencing ad selection. `preloadAdBreaks` dictates ad preloading strategy, set only once.\n"]]
