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<Object, Exception> 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<Integer, Exception> callback)
Ottieni lo stato dell'API Measurement. |
void
|
registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra un'origine di attribuzione (clic o visualizzazione). |
void
|
registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registrare le origini di attribuzione(clic o visualizzazione) da un contesto di app. |
void
|
registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra un attivatore (conversione). |
void
|
registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra un'origine di attribuzione(clic o visualizzazione) dal contesto web. |
void
|
registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> 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<Object, Exception> 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<Integer, Exception> 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<Object, Exception> 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<Object, Exception> 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<Object, Exception> 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<Object, Exception> 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<Object, Exception> 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 . |