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<ObjectException> 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<IntegerException> callback)

Ottieni lo stato dell'API Measurement.

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

Registra un'origine attribuzione (clic o visualizzazione).

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

Registra le origini dell'attribuzione(clic o visualizzazione) dal contesto di un'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 dell'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_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<ObjectException> 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<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 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<ObjectException> 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<ObjectException> 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<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 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<ObjectException> 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<ObjectException> 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.