Gestore misurazione

public class MeasurementManager
extends Object

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


MeasurementManager fornisce le API per gestire le registrazioni di origini e trigger.

Riepilogo

Costanti

int MEASUREMENT_API_STATE_DISABLED

Questo stato indica che le API di misurazione non sono disponibili.

int MEASUREMENT_API_STATE_ENABLED

Questo stato indica che le API di misurazione sono abilitate.

Metodi pubblici

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

Eliminare registrazioni precedenti.

static MeasurementManager get(Context context)

Metodo di sviluppo per la creazione di un'istanza di MeasurementManager.

void getMeasurementApiStatus(Executor executor, OutcomeReceiver<IntegerException> callback)

Ottieni lo stato dell'API Measurement.

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

Registra un'origine di attribuzione (clic o visualizzazione).

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

Registrare le origini di attribuzione(clic o visualizzazione) da un contesto di app.

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

Registra un attivatore (conversione).

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

Registra un'origine di attribuzione(clic o visualizzazione) dal contesto web.

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

Registra un attivatore di attribuzione(clic o visualizzazione) dal contesto web.

Metodi ereditati

Costanti

MEASUREMENT_API_STATE_DISABILITATO

public static final int MEASUREMENT_API_STATE_DISABLED

Questo stato indica che le API di misurazione non sono disponibili. La chiamata comporterà un UnsupportedOperationException.

Valore costante: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

public static final int MEASUREMENT_API_STATE_ENABLED

Questo stato indica che le API di misurazione sono abilitate.

Valore costante: 1 (0x00000001)

Metodi pubblici

deleteRegistrations

public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Eliminare registrazioni precedenti. Se l'eliminazione ha esito positivo, il valore OutcomeReceiver.onResult(R) del callback viene richiamato con un valore nullo. In caso di errore, viene inviato un Exception tramite il metodo OutcomeReceiver#onError del callback. Sia il feedback di operazione riuscita che quello di errore vengono eseguiti sul Executor fornito.

Parametri
deletionRequest DeletionRequest: la richiesta di eliminazione dei dati. Questo valore non può essere null.

executor Executor: l'esecutore per eseguire il callback. Questo valore non può essere null. Gli eventi di callback e di listener vengono inviati tramite questo Executor, offrendo un modo semplice per controllare quale thread viene utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un Executor che verrà inviato al thread appropriato.

callback OutcomeReceiver: destinato a notificare in modo asincrono il risultato dell'API. Questo valore non può essere null.

ricevi

public static MeasurementManager get (Context context)

Metodo di sviluppo per la creazione di un'istanza di MeasurementManager.

Parametri
context Context: il valore di Context da utilizzare Questo valore non può essere null.

Ritorni
MeasurementManager Un'istanza MeasurementManager Questo valore non può essere null.

getMeasurementApiStatus

public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<IntegerException> callback)

Ottieni lo stato dell'API Measurement.

Il valore Integer del callback è uno tra MeasurementApiState.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parametri
executor Executor: utilizzato dal callback per inviare i risultati. Questo valore non può essere null. Gli eventi di callback e di listener vengono inviati tramite questo Executor, offrendo un modo semplice per controllare quale thread viene utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un Executor che verrà inviato al thread appropriato.

callback OutcomeReceiver: destinato a notificare in modo asincrono il risultato dell'API. Questo valore non può essere null.

registrySource

public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registra un'origine di attribuzione (clic o visualizzazione).
Richiede AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parametri
attributionSource Uri: la piattaforma invia una richiesta a questo URI per recuperare i metadati associati all'origine dell'attribuzione. I metadati di origine sono archiviati sul dispositivo e sono quindi idonei per essere abbinati ad attivatori futuri. Questo valore non può essere null.

inputEvent InputEvent: un oggetto InputEvent (per un evento di clic) o nullo (per un evento di visualizzazione).

executor Executor: utilizzato dal callback per inviare i risultati. Questo valore può essere null. Gli eventi di callback e di listener vengono inviati tramite questo Executor, offrendo un modo semplice per controllare quale thread viene utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un Executor che verrà inviato al thread appropriato.

callback OutcomeReceiver: destinato a notificare in modo asincrono il risultato dell'API. Questo valore può essere null.

Tiri
IllegalArgumentException se lo schema per attributionSource non è HTTPS

registrySource

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

Registrare le origini di attribuzione(clic o visualizzazione) da un contesto di app. Questa API non elaborerà alcun reindirizzamento, poiché tutti gli URL di registrazione devono essere forniti con la richiesta.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parametri
request SourceRegistrationRequest: richiesta di registrazione dell'origine app Questo valore non può essere null.

executor Executor: utilizzato dal callback per inviare i risultati. Questo valore può essere null. Gli eventi di callback e di listener vengono inviati tramite questo Executor, offrendo un modo semplice per controllare quale thread viene utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un Executor che verrà inviato al thread appropriato.

callback OutcomeReceiver: destinato a notificare in modo asincrono il risultato dell'API. Questo valore può essere null.

registryTrigger

public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registra un attivatore (conversione).
Richiede AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parametri
trigger Uri: l'API invia una richiesta a questo URI per recuperare i metadati associati all'attivatore. I metadati dell'attivatore vengono archiviati sul dispositivo e possono essere abbinati alle origini durante il processo di attribuzione. Questo valore non può essere null.

executor Executor: utilizzato dal callback per inviare i risultati. Questo valore può essere null. Gli eventi di callback e di listener vengono inviati tramite questo Executor, offrendo un modo semplice per controllare quale thread viene utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un Executor che verrà inviato al thread appropriato.

callback OutcomeReceiver: destinato a notificare in modo asincrono il risultato dell'API. Questo valore può essere null.

Tiri
IllegalArgumentException se lo schema per trigger non è HTTPS

registryWebSource

public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registra un'origine di attribuzione(clic o visualizzazione) dal contesto web. Questa API non elaborerà alcun reindirizzamento, pertanto tutti gli URL di registrazione devono essere forniti con la richiesta. Devi fornire almeno uno dei parametri appDestination o webDestination. Se la registrazione ha esito positivo, il valore OutcomeReceiver#onResult di callback viene richiamato con un valore null. In caso di errore, viene inviato un Exception tramite il OutcomeReceiver.onError(E) di callback. Sia il feedback sull'esito positivo sia quello negativo vengono eseguiti sull'elemento Executor fornito.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parametri
request WebSourceRegistrationRequest: richiesta di registrazione dell'origine Questo valore non può essere null.

executor Executor: utilizzato dal callback per inviare i risultati. Questo valore può essere null.

callback OutcomeReceiver: destinato a notificare in modo asincrono il risultato dell'API. Questo valore può essere null.

registryWebTrigger

public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registra un attivatore di attribuzione(clic o visualizzazione) dal contesto web. Questa API non elaborerà alcun reindirizzamento, poiché tutti gli URL di registrazione devono essere forniti con la richiesta. Se la registrazione ha esito positivo, il valore OutcomeReceiver#onResult di callback viene richiamato con un valore null. In caso di errore, viene inviato un Exception tramite il OutcomeReceiver.onError(E) di callback. Sia il feedback sull'esito positivo sia quello negativo vengono eseguiti sull'elemento Executor fornito.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parametri
request WebTriggerRegistrationRequest: attiva la richiesta di registrazione Questo valore non può essere null.

executor Executor: utilizzato dal callback per inviare i risultati. Questo valore può essere null.

callback OutcomeReceiver: destinato a notificare in modo asincrono il risultato dell'API. Questo valore può essere null.