Ölçüm Yöneticisi

public class MeasurementManager
extends Object

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


MeasurementManager, kaynağı yönetmek ve kayıtları tetiklemek için API'ler sağlar.

Özet

Sabitler

int MEASUREMENT_API_STATE_DISABLED

Bu durum, Measurement API'lerinin kullanılamadığını gösterir.

int MEASUREMENT_API_STATE_ENABLED

Bu durum, Measurement API'lerinin etkinleştirildiğini gösterir.

Herkese açık yöntemler

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

Önceki kayıtları silin.

static MeasurementManager get(Context context)

MeasurementManager örneği oluşturmak için kullanılan fabrika yöntemi.

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

Measurement API durumunu öğrenin.

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

Bir ilişkilendirme kaynağı kaydedin (tıklayın veya görüntüleyin).

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

Bir uygulama bağlamından ilişkilendirme kaynaklarını kaydedin(tıkla veya görüntüle).

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

Tetikleyici (dönüşüm) kaydedin.

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

Web bağlamından bir ilişkilendirme kaynağı kaydedin(tıkla veya görüntüle).

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

Web bağlamından bir ilişkilendirme tetikleyicisi(tıklama veya görüntüleme) kaydedin.

Devralınan yöntemler

Sabitler

MEASUREMENT_API_STATE_DEVRE DIŞI

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public static final int MEASUREMENT_API_STATE_DISABLED

Bu durum, Measurement API'lerinin kullanılamadığını gösterir. Bu öğeler çağrıldığında UnsupportedOperationException

Sabit Değer: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public static final int MEASUREMENT_API_STATE_ENABLED

Bu durum, Measurement API'lerinin etkinleştirildiğini gösterir.

Sabit Değer: 1 (0x00000001)

Herkese açık yöntemler

deleteKayıtları

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Önceki kayıtları silin. Silme işlemi başarılı olursa geri çağırmanın OutcomeReceiver.onResult(R) özelliği null ile çağrılır. Hata durumunda Exception geri arama OutcomeReceiver#onError üzerinden gönderildi. Hem başarı hem başarısızlık geri bildirim, sağlanan Executor üzerinde yürütülür.

Parametreler
deletionRequest DeletionRequest: Verileri silme isteği. Bu değer null olamaz.

executor Executor: Geri çağırmayı çalıştıracak yürütücü. Bu değer null olamaz. Geri çağırma ve işleyici etkinlikleri bu Executor kullanılır. Etkinlikleri oluşturmak için Context.getMainExecutor() Aksi takdirde, uygun bir ileti dizisine yönlendiren bir Executor sağlayın.

callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmeyi amaçlar. Bu değer null olamaz.

get

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 6'da da
public static MeasurementManager get (Context context)

MeasurementManager örneği oluşturmak için kullanılan fabrika yöntemi.

Parametreler
context Context: Kullanılacak Context Bu değer null olamaz.

İlerlemeler
MeasurementManager MeasurementManager örneği Bu değer null olamaz.

getMeasurementApiStatus

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<IntegerException> callback)

Measurement API durumunu öğrenin.

Geri çağırmanın Integer değeri, MeasurementApiState değerlerinden biridir.
. AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION gerektirir

Parametreler
executor Executor: Sonuçları göndermek için geri çağırma tarafından kullanılır. Bu değer null olamaz. Geri çağırma ve işleyici etkinlikleri bu Executor kullanılır. Etkinlikleri oluşturmak için Context.getMainExecutor() Aksi takdirde, uygun bir ileti dizisine yönlendiren bir Executor sağlayın.

callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmeyi amaçlar. Bu değer null olamaz.

recordSource

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Bir ilişkilendirme kaynağı kaydedin (tıklayın veya görüntüleyin).
. AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION gerektirir

Parametreler
attributionSource Uri: Platform, meta verileri getirmek için bu URI'ye bir istek gönderir. ilişkilendirme kaynağıyla ilişkilidir. Kaynak meta veriler cihazda saklanır. Bu da gelecekteki tetikleyicilerle eşleştirilmeye uygun olabilir. Bu değer null olamaz.

inputEvent InputEvent: ya bir InputEvent nesnesi (tıklama etkinliği için) veya null (görünüm için) etkinliği) ekleyebilirsiniz.

executor Executor: Sonuçları göndermek için geri çağırma tarafından kullanılır. Bu değer null olabilir. Geri çağırma ve işleyici etkinlikleri bu Executor kullanılır. Etkinlikleri oluşturmak için Context.getMainExecutor() Aksi takdirde, uygun bir ileti dizisine yönlendiren bir Executor sağlayın.

callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmeyi amaçlar. Bu değer null olabilir.

Fırlatma
IllegalArgumentException attributionSource şeması HTTPS değilse

recordSource

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

Bir uygulama bağlamından ilişkilendirme kaynaklarını kaydedin(tıkla veya görüntüle). Bu API işlemeyecek tüm kayıt URL'leri istekle birlikte sağlanmalıdır.
. AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION gerektirir

Parametreler
request SourceRegistrationRequest: Uygulama kaynağı kayıt isteği Bu değer null olamaz.

executor Executor: Sonuçları göndermek için geri çağırma tarafından kullanılır Bu değer null olabilir. Geri çağırma ve işleyici etkinlikleri bu Executor kullanılır. Etkinlikleri oluşturmak için Context.getMainExecutor() Aksi takdirde, uygun bir ileti dizisine yönlendiren bir Executor sağlayın.

callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmeyi amaçlar Bu değer null olabilir.

tescil Tetikleyicisi

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Tetikleyici (dönüşüm) kaydedin.
. AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION gerektirir

Parametreler
trigger Uri: API, tetikleyici olur. Tetikleyici meta verileri cihaz üzerinde depolanır ve eşleştirilmeye uygundur. kaynakları hakkında bilgi edindiniz. Bu değer null olamaz.

executor Executor: Sonuçları göndermek için geri çağırma tarafından kullanılır. Bu değer null olabilir. Geri çağırma ve işleyici etkinlikleri bu Executor kullanılır. Etkinlikleri oluşturmak için Context.getMainExecutor() Aksi takdirde, uygun bir ileti dizisine yönlendiren bir Executor sağlayın.

callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmeyi amaçlar. Bu değer null olabilir.

Fırlatma
IllegalArgumentException trigger şeması HTTPS değilse

recordWebSource

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Web bağlamından bir ilişkilendirme kaynağı kaydedin(tıkla veya görüntüle). Bu API hiçbir tüm kayıt URL'leri istekle birlikte sağlanmalıdır. Şunlardan en az biri: appDestination veya webDestination parametrelerinin sağlanması gerekiyor. Kayıt başarılı olursa callback öğesinin OutcomeReceiver#onResult değeri null ile çağrılır. İçinde başarısızlık durumunda callback OutcomeReceiver.onError(E) üzerinden bir Exception gönderilir. Hem başarı hem de başarısızlık geri bildirimi sağlanan Executor
. AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION gerektirir

Parametreler
request WebSourceRegistrationRequest: kaynak kayıt isteği Bu değer null olamaz.

executor Executor: Sonuçları göndermek için geri çağırma tarafından kullanılır. Bu değer null olabilir.

callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmeyi amaçlar. Bu değer null olabilir.

registerWebTetikleyici

API düzeyi 34'e eklendi
Ayrıca Ad Services Extensions 4'e de eklendi
public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Web bağlamından bir ilişkilendirme tetikleyicisi(tıklama veya görüntüleme) kaydedin. Bu API işlemeyecek tüm kayıt URL'leri istekle birlikte sağlanmalıdır. Kayıt başarılı olursa callback öğesinin OutcomeReceiver#onResult değeri null ile çağrılır. İçinde başarısızlık durumunda callback OutcomeReceiver.onError(E) üzerinden bir Exception gönderilir. Hem başarı hem de başarısızlık geri bildirimi sağlanan Executor
. AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION gerektirir

Parametreler
request WebTriggerRegistrationRequest: kayıt isteğini tetikle Bu değer null olamaz.

executor Executor: Sonuçları göndermek için geri çağırma tarafından kullanılır Bu değer null olabilir.

callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmeyi amaçlar Bu değer null olabilir.