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. |