Ölçüm Yöneticisi

public class MeasurementManager
extends Object

java.lang.Object
→ Yönergeler android.adservices.measurement.MeasurementManager

MeasurementManager, kaynak ve tetikleyici kayıtlarını yönetmek için API'ler sağlar.

Özet

Sabitler

int MEASUREMENT_API_STATE_DISABLED

Bu durum, Ölçüm API'lerinin kullanılamadığını gösterir.

int MEASUREMENT_API_STATE_ENABLED

Bu durum, Ölçüm API'lerinin etkin olduğunu gösterir.

Herkese açık yöntemler

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

Önceki kayıtları silin.

static MeasurementManager get(Context context)

MeasurementManager örneği oluşturma için fabrika yöntemi.

void getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)

Measurement API durumunu öğrenin.

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

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

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

Bir uygulama bağlamından ilişkilendirme kaynaklarını kaydetme(tıklama veya görüntüleme).

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

Bir tetikleyici (dönüşüm) kaydedin.

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

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

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

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

Devralınan yöntemler

Sabitler

MEASUREMENT_API_STATE_DEVRE DIŞI

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public static final int MEASUREMENT_API_STATE_DISABLED

Bu durum, Ölçüm API'lerinin kullanılamadığını gösterir. Bunların çağrılması UnsupportedOperationException sonucunu verir.

Sabit Değer: 0 (0x00000000)

MEASUREMENT_API_STATE_ETKİN

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public static final int MEASUREMENT_API_STATE_ENABLED

Bu durum, Ölçüm API'lerinin etkin olduğunu gösterir.

Sabit Değer: 1 (0x00000001)

Herkese açık yöntemler

deleteRegistrations

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

Önceki kayıtları silin. Silme işlemi başarılı olursa geri çağırmanın OutcomeReceiver.onResult(R) değeri null ile çağrılır. Başarısız olması durumunda, geri çağırmanın OutcomeReceiver#onError üzerinden Exception gönderilir. Hem başarılı hem de başarısız geri bildirimi sağlanan Executor üzerinde yürütülür.

Parametreler
deletionRequest DeletionRequest: Veri 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, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz. Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın.
callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmek için kullanılır. Bu değer null olamaz.

get

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 6'ya da eklendi 
public static MeasurementManager get (Context context)

MeasurementManager örneği oluşturma için fabrika yöntemi.

Parametreler
context Context: Kullanılacak Context değeri, null olamaz.
İlerlemeler
MeasurementManager MeasurementManager örneği Bu değer null olamaz.

getMeasurementApiStatus

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<Integer, Exception> 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ı dağıtmak için geri çağırma tarafından kullanılır. Bu değer null olamaz. Geri çağırma ve işleyici etkinlikleri, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz. Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın.
callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmek için kullanılır. Bu değer null olamaz.

kayıtKaynağı

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

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

Parametreler
attributionSource Uri: Platform, ilişkilendirme kaynağıyla ilişkili meta verileri getirmek için bu URI'ye bir istek gönderir. Kaynak meta verileri cihazda depolanır ve gelecekteki tetikleyicilerle eşleştirilebilir. Bu değer null olamaz.
inputEvent InputEvent: InputEvent nesnesi (bir tıklama etkinliği için) veya null (görüntüleme etkinliği için).
executor Executor: Sonuçları dağıtmak için geri çağırma tarafından kullanılır. Bu değer null olabilir. Geri çağırma ve işleyici etkinlikleri, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz. Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın.
callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmek için kullanılır. Bu değer null olabilir.
Dekoratif yastıklar
IllegalArgumentException attributionSource şeması HTTPS değilse

kayıtKaynağı

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

Bir uygulama bağlamından ilişkilendirme kaynaklarını kaydetme(tıklama veya görüntüleme). Bu API, yönlendirmeleri işlemez, istekle birlikte tüm kayıt URL'leri 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ı dağıtmak için geri çağırma tarafından kullanılır Bu değer, null olabilir. Geri çağırma ve işleyici etkinlikleri, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz. Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın.
callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmek için tasarlanmıştır. Bu değer, null olabilir.

kayıt tetikleyicisi

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

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

Parametreler
trigger Uri: API, tetikleyiciyle ilişkili meta verileri getirmek için bu URI'ye bir istek gönderir. Tetikleyici meta verileri cihazda depolanır ve ilişkilendirme işlemi sırasında kaynaklarla eşleştirilmeye uygundur. Bu değer null olamaz.
executor Executor: Sonuçları dağıtmak için geri çağırma tarafından kullanılır. Bu değer null olabilir. Geri çağırma ve işleyici etkinlikleri, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz. Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın.
callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmek için kullanılır. Bu değer null olabilir.
Dekoratif yastıklar
IllegalArgumentException trigger şeması HTTPS değilse

kayıtWebKaynağı

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

Web bağlamından bir ilişkilendirme kaynağı kaydedin(tıklayın veya görüntüleyin). Bu API, yönlendirmeleri işlemez, istekle birlikte tüm kayıt URL'leri sağlanmalıdır. appDestination veya webDestination parametrelerinden en az birinin sağlanması gerekir. Kayıt başarılı olursa callback OutcomeReceiver#onResult öğesi null ile çağrılır. Başarısız olması durumunda callback OutcomeReceiver.onError(E) üzerinden Exception gönderilir. Hem başarı hem de başarısız geri bildirimi sağlanan Executor üzerinde yürütülür.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION gerektirir

Parametreler
request WebSourceRegistrationRequest: Kaynak kayıt isteği Bu değer null olamaz.
executor Executor: Sonuçları dağıtmak için geri çağırma tarafından kullanılır. Bu değer null olabilir.
callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmek için kullanılır. Bu değer null olabilir.

kayıtWebTetikleyicisi

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

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

Parametreler
request WebTriggerRegistrationRequest: Tetikleyici kayıt isteği Bu değer null olamaz.
executor Executor: Sonuçları dağıtmak için geri çağırma tarafından kullanılır Bu değer, null olabilir.
callback OutcomeReceiver: API sonucunu eşzamansız olarak bildirmek için tasarlanmıştır. Bu değer, null olabilir.