MeasurementManager
public
class
MeasurementManager
extends Object
java.lang.Object | |
🎞 | android.adservices.measurement.MeasurementManager |
MeasurementManager fornisce le API per gestire l'origine e attivare le registrazioni.
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)
Elimina le registrazioni precedenti. |
static
MeasurementManager
|
get(Context context)
Metodo di fabbrica 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 attribuzione (clic o visualizzazione). |
void
|
registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra le origini dell'attribuzione(clic o visualizzazione) dal contesto di un'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 dell'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_DISABLED
public static final int MEASUREMENT_API_STATE_DISABLED
Questo stato indica che le API di misurazione non sono disponibili. Il richiamo 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)
Elimina le registrazioni precedenti. Se l'eliminazione va a buon fine, il valore OutcomeReceiver.onResult(R)
del callback viene richiamato con un valore null. In caso di errore, viene restituito un Exception
inviato tramite il OutcomeReceiver#onError
del callback. Successo e fallimento
vengono eseguiti feedback sull'elemento 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 listener vengono inviati tramite questo
Executor , che consente di controllare facilmente quale thread
in uso. Per inviare eventi tramite il thread principale del tuo
puoi utilizzare
Context.getMainExecutor() .
In caso contrario, specifica un valore Executor che effettui l'invio a un 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 fabbrica per la creazione di un'istanza di MeasurementManager.
Parametri | |
---|---|
context |
Context : Context da usare
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 listener vengono inviati tramite questo
Executor , che consente di controllare facilmente quale thread
in uso. Per inviare eventi tramite il thread principale del tuo
puoi utilizzare
Context.getMainExecutor() .
In caso contrario, specifica un valore Executor che effettui l'invio a un 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 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 vengono archiviati sul dispositivo,
idonea per essere abbinata ad attivatori futuri.
Questo valore non può essere null . |
inputEvent |
InputEvent : un oggetto InputEvent (per un evento di clic) o nullo (per una vista
). |
executor |
Executor : utilizzato dal callback per inviare i risultati.
Questo valore può essere null .
Gli eventi di callback e listener vengono inviati tramite questo
Executor , che consente di controllare facilmente quale thread
in uso. Per inviare eventi tramite il thread principale del tuo
puoi utilizzare
Context.getMainExecutor() .
In caso contrario, specifica un valore Executor che effettui l'invio a un thread appropriato. |
callback |
OutcomeReceiver : destinato a notificare in modo asincrono il risultato dell'API.
Questo valore può essere null . |
Lanci | |
---|---|
IllegalArgumentException |
se lo schema per attributionSource non è HTTPS |
registrySource
public void registerSource (SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra le origini dell'attribuzione(clic o visualizzazione) dal contesto di un'app. Questa API non elaborerà
eventuali reindirizzamenti, tutti gli URL di registrazione devono essere forniti con la richiesta.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
Parametri | |
---|---|
request |
SourceRegistrationRequest : richiesta di registrazione dell'origine dell'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 listener vengono inviati tramite questo
Executor , che consente di controllare facilmente quale thread
in uso. Per inviare eventi tramite il thread principale del tuo
puoi utilizzare
Context.getMainExecutor() .
In caso contrario, specifica un valore Executor che effettui l'invio a un thread appropriato. |
callback |
OutcomeReceiver : destinato a notificare in modo asincrono il risultato dell'API
Questo valore può essere null . |
registraTrigger
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 al
trigger. I metadati di trigger vengono memorizzati sul dispositivo e possono essere abbinati
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 listener vengono inviati tramite questo
Executor , che consente di controllare facilmente quale thread
in uso. Per inviare eventi tramite il thread principale del tuo
puoi utilizzare
Context.getMainExecutor() .
In caso contrario, specifica un valore Executor che effettui l'invio a un thread appropriato. |
callback |
OutcomeReceiver : destinato a notificare in modo asincrono il risultato dell'API.
Questo valore può essere null . |
Lanci | |
---|---|
IllegalArgumentException |
se lo schema per trigger non è HTTPS |
registryWebSource
public void registerWebSource (WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra un'origine dell'attribuzione(clic o visualizzazione) dal contesto web. Questa API non elaborerà
reindirizzamenti, tutti gli URL di registrazione devono essere forniti con la richiesta. Almeno uno di
È necessario specificare i parametri appDestination o webDestination. Se la registrazione
ha esito positivo, OutcomeReceiver#onResult
di callback
è richiamato con null. Nella
in caso di errore, viene inviato un Exception
tramite OutcomeReceiver.onError(E)
di callback
. I feedback di esito positivo e negativo vengono eseguiti
Executor
.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
Parametri | |
---|---|
request |
WebSourceRegistrationRequest : richiesta di registrazione di 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 . |
registraWebTrigger
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à
eventuali reindirizzamenti, tutti gli URL di registrazione devono essere forniti con la richiesta. Se la registrazione
ha esito positivo, OutcomeReceiver#onResult
di callback
è richiamato con null. Nella
in caso di errore, viene inviato un Exception
tramite OutcomeReceiver.onError(E)
di callback
. I feedback di esito positivo e negativo vengono eseguiti
Executor
.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
Parametri | |
---|---|
request |
WebTriggerRegistrationRequest : attiva 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 . |