{i>MeasurementManager<i}

public class MeasurementManager
extends Object

java.lang.Object
   ↳ android.adservices.measurement.MeasurementManager

MeasurementManager menyediakan API untuk mengelola pendaftaran sumber dan pemicu.

Ringkasan

Konstanta

int MEASUREMENT_API_STATE_DISABLED

Status ini menunjukkan bahwa Measurement API tidak tersedia.

int MEASUREMENT_API_STATE_ENABLED

Status ini menunjukkan bahwa Measurement API diaktifkan.

Metode publik

void deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback)

Menghapus pendaftaran sebelumnya.

static MeasurementManager get(Context context)

Metode factory untuk membuat instance MeasurementManager.

void getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)

Mendapatkan status Measurement API.

void registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)

Mendaftarkan sumber atribusi (klik atau penayangan).

void registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)

Mendaftarkan sumber atribusi(klik atau penayangan) dari konteks aplikasi.

void registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)

Mendaftarkan pemicu (konversi).

void registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)

Mendaftarkan sumber atribusi(klik atau penayangan) dari konteks web.

void registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)

Mendaftarkan pemicu atribusi(klik atau penayangan) dari konteks web.

Metode turunan

Konstanta

MEASUREMENT_API_STATE_DISABLED

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public static final int MEASUREMENT_API_STATE_DISABLED

Status ini menunjukkan bahwa Measurement API tidak tersedia. Memanggilnya akan menghasilkan UnsupportedOperationException.

Nilai Konstanta: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public static final int MEASUREMENT_API_STATE_ENABLED

Status ini menunjukkan bahwa Measurement API diaktifkan.

Nilai Konstanta: 1 (0x00000001)

Metode publik

deleteRegistrations

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

Menghapus pendaftaran sebelumnya. Jika penghapusan berhasil, OutcomeReceiver.onResult(R) callback dipanggil dengan null. Jika terjadi kegagalan, Exception akan dikirim melalui OutcomeReceiver#onError callback. Keberhasilan dan kegagalan masukan dijalankan di Executor yang disediakan.

Parameter
deletionRequest DeletionRequest: Permintaan untuk menghapus data. Nilai ini tidak boleh null.
executor Executor: Eksekutor untuk menjalankan callback. Nilai ini tidak boleh null. Peristiwa callback dan pemroses dikirim melalui ini Executor, yang menyediakan cara mudah untuk mengontrol thread mana data Untuk mengirim peristiwa melalui thread utama metode Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.
callback OutcomeReceiver: dimaksudkan untuk memberi tahu hasil API secara asinkron. Nilai ini tidak boleh null.

get

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 6 
public static MeasurementManager get (Context context)

Metode factory untuk membuat instance MeasurementManager.

Parameter
context Context: Context yang akan digunakan Nilai ini tidak boleh null.
Hasil
MeasurementManager Instance MeasurementManager Nilai ini tidak boleh null.

getMeasurementApiStatus

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<Integer, Exception> callback)

Mendapatkan status Measurement API.

Nilai Integer callback adalah salah satu dari MeasurementApiState.
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
executor Executor: digunakan oleh callback untuk mengirim hasil. Nilai ini tidak boleh null. Peristiwa callback dan pemroses dikirim melalui ini Executor, yang menyediakan cara mudah untuk mengontrol thread mana data Untuk mengirim peristiwa melalui thread utama metode Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.
callback OutcomeReceiver: dimaksudkan untuk memberi tahu hasil API secara asinkron. Nilai ini tidak boleh null.

registerSource

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

Mendaftarkan sumber atribusi (klik atau penayangan).
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
attributionSource Uri: platform mengirimkan permintaan ke URI ini untuk mengambil metadata yang terkait dengan sumber atribusi. Metadata sumber disimpan di perangkat, sehingga dan memenuhi syarat untuk dicocokkan dengan pemicu di masa mendatang. Nilai ini tidak boleh null.
inputEvent InputEvent: objek InputEvent (untuk peristiwa klik) atau null (untuk tampilan peristiwa).
executor Executor: digunakan oleh callback untuk mengirim hasil. Nilai ini dapat berupa null. Peristiwa callback dan pemroses dikirim melalui ini Executor, yang menyediakan cara mudah untuk mengontrol thread mana data Untuk mengirim peristiwa melalui thread utama metode Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.
callback OutcomeReceiver: dimaksudkan untuk memberi tahu hasil API secara asinkron. Nilai ini dapat berupa null.
Menampilkan
IllegalArgumentException jika skema untuk attributionSource bukan HTTPS

registerSource

public void registerSource (SourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

Mendaftarkan sumber atribusi(klik atau penayangan) dari konteks aplikasi. API ini tidak akan memproses pengalihan apa pun, semua URL pendaftaran harus disediakan bersama permintaan.
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
request SourceRegistrationRequest: permintaan pendaftaran sumber aplikasi Nilai ini tidak boleh null.
executor Executor: digunakan oleh callback untuk mengirim hasil Nilai ini dapat berupa null. Peristiwa callback dan pemroses dikirim melalui ini Executor, yang menyediakan cara mudah untuk mengontrol thread mana data Untuk mengirim peristiwa melalui thread utama metode Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.
callback OutcomeReceiver: dimaksudkan untuk memberi tahu hasil API secara asinkron Nilai ini dapat berupa null.

registerTrigger

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

Mendaftarkan pemicu (konversi).
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
trigger Uri: API mengeluarkan permintaan ke URI ini untuk mengambil metadata yang terkait dengan pemicu. Metadata pemicu disimpan di perangkat dan memenuhi syarat untuk dicocokkan dengan sumber selama proses atribusi. Nilai ini tidak boleh null.
executor Executor: digunakan oleh callback untuk mengirim hasil. Nilai ini dapat berupa null. Peristiwa callback dan pemroses dikirim melalui ini Executor, yang menyediakan cara mudah untuk mengontrol thread mana data Untuk mengirim peristiwa melalui thread utama metode Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.
callback OutcomeReceiver: dimaksudkan untuk memberi tahu hasil API secara asinkron. Nilai ini dapat berupa null.
Menampilkan
IllegalArgumentException jika skema untuk trigger bukan HTTPS

registerWebSource

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

Mendaftarkan sumber atribusi(klik atau penayangan) dari konteks web. API ini tidak akan memproses pengalihan, semua URL pendaftaran harus disediakan bersama permintaan. Setidaknya salah satu Parameter appDestination atau webDestination harus diberikan. Jika pendaftaran berhasil, OutcomeReceiver#onResult callback dipanggil dengan null. Di beberapa jika gagal, Exception akan dikirim melalui OutcomeReceiver.onError(E) callback. Masukan keberhasilan dan kegagalan dieksekusi di Executor.
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
request WebSourceRegistrationRequest: permintaan pendaftaran sumber Nilai ini tidak boleh null.
executor Executor: digunakan oleh callback untuk mengirim hasil. Nilai ini dapat berupa null.
callback OutcomeReceiver: dimaksudkan untuk memberi tahu hasil API secara asinkron. Nilai ini dapat berupa null.

registerWebTrigger

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

Mendaftarkan pemicu atribusi(klik atau penayangan) dari konteks web. API ini tidak akan memproses pengalihan apa pun, semua URL pendaftaran harus disediakan bersama permintaan. Jika pendaftaran berhasil, OutcomeReceiver#onResult callback dipanggil dengan null. Di beberapa jika gagal, Exception akan dikirim melalui OutcomeReceiver.onError(E) callback. Masukan keberhasilan dan kegagalan dieksekusi di Executor.
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
request WebTriggerRegistrationRequest: permintaan pendaftaran pemicu Nilai ini tidak boleh null.
executor Executor: digunakan oleh callback untuk mengirim hasil Nilai ini dapat berupa null.
callback OutcomeReceiver: dimaksudkan untuk memberi tahu hasil API secara asinkron Nilai ini dapat berupa null.