REST Resource: applications.deviceTierConfigs

Zasób: DeviceTierConfig

Konfiguracja określająca kryteria kierowania reklam na urządzenia w przypadku treści aplikacji.

Zapis JSON
{
  "deviceTierConfigId": string,
  "deviceGroups": [
    {
      object (DeviceGroup)
    }
  ],
  "deviceTierSet": {
    object (DeviceTierSet)
  },
  "userCountrySets": [
    {
      object (UserCountrySet)
    }
  ]
}
Pola
deviceTierConfigId

string (int64 format)

Tylko dane wyjściowe. Identyfikator konfiguracji poziomu urządzenia.

deviceGroups[]

object (DeviceGroup)

Definicja grup urządzeń dla aplikacji.

deviceTierSet

object (DeviceTierSet)

Definicja zestawu poziomów urządzeń dla aplikacji.

userCountrySets[]

object (UserCountrySet)

Definicja zestawów krajów użytkowników w aplikacji.

DeviceGroup

grupa urządzeń.

Grupa jest definiowana przez zestaw selektorów urządzeń. Urządzenie należy do grupy, jeśli pasuje do dowolnego selektora (logiczna operacja LUB).

Zapis JSON
{
  "name": string,
  "deviceSelectors": [
    {
      object (DeviceSelector)
    }
  ]
}
Pola
name

string

Nazwa grupy.

deviceSelectors[]

object (DeviceSelector)

Selektory urządzeń w tej grupie. Urządzenie pasujące do dowolnego z selektorów jest uwzględniane w tej grupie.

DeviceSelector

Selektor grupy urządzeń. Selektor składa się z zestawu warunków na urządzeniu, które muszą być spełnione (logiczna operacja AND), aby określić, czy urządzenie kwalifikuje się do grupy.

Jeśli na przykład selektor określa warunki dotyczące pamięci RAM, uwzględnia modele urządzeń i wyklucza modele urządzeń, urządzenie jest uznawane za pasujące, jeśli: spełnia warunki dotyczące pamięci RAM ORAZ pasuje do jednego z uwzględnionych modeli urządzeń ORAZ nie pasuje do wykluczonych modeli urządzeń.

Zapis JSON
{
  "deviceRam": {
    object (DeviceRam)
  },
  "includedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "excludedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "requiredSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "forbiddenSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "systemOnChips": [
    {
      object (SystemOnChip)
    }
  ]
}
Pola
deviceRam

object (DeviceRam)

warunki pamięci RAM urządzenia;

includedDeviceIds[]

object (DeviceId)

Modele urządzeń uwzględnione przez ten selektor.

excludedDeviceIds[]

object (DeviceId)

modele urządzeń wykluczone przez ten selektor, nawet jeśli spełniają wszystkie inne warunki;

requiredSystemFeatures[]

object (SystemFeature)

Aby można było uwzględnić urządzenie w selektorze, musi ono mieć wszystkie te funkcje.

forbiddenSystemFeatures[]

object (SystemFeature)

Wybór ten wyklucza urządzenia, które mają którąkolwiek z tych funkcji systemu, nawet jeśli spełniają wszystkie inne warunki.

systemOnChips[]

object (SystemOnChip)

Opcjonalnie: Systemy na chipie uwzględnione przez ten selektor. Działa tylko na urządzeniach z Androidem S+.

DeviceRam

Warunki dotyczące możliwości pamięci RAM urządzenia.

Zapis JSON
{
  "minBytes": string,
  "maxBytes": string
}
Pola
minBytes

string (int64 format)

Minimalna ilość pamięci RAM w bajtach (w tym pamięć przydzielona).

maxBytes

string (int64 format)

Maksymalna pamięć RAM w bajtach (z wyłączeniem zasobów).

DeviceId

Identyfikator urządzenia.

Zapis JSON
{
  "buildBrand": string,
  "buildDevice": string
}
Pola
buildBrand

string

Wartość parametru Build.BRAND.

buildDevice

string

Wartość Build.DEVICE.

SystemFeature

Prezentacja funkcji systemowej.

Zapis JSON
{
  "name": string
}
Pola
name

string

Nazwa funkcji.

SystemOnChip

Ilustracja przedstawiająca układ SoC urządzenia z Androidem. Można ich używać do kierowania reklam na urządzenia S+.

Zapis JSON
{
  "manufacturer": string,
  "model": string
}
Pola
manufacturer

string

Wymagane. Projektant SoC, np. „Google” Wartość właściwości kompilacji „ro.soc.manufacturer” https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER Wymagane.

model

string

Wymagane. Model SoC, np. „Tensor” Wartość właściwości kompilacji „ro.soc.model” https://developer.android.com/reference/android/os/Build#SOC_MODEL Wymagane.

DeviceTierSet

Zestaw poziomów urządzeń.

Zestaw poziomów określa, która wersja treści aplikacji jest wyświetlana na określonym urządzeniu w przypadku treści kierowanych na urządzenia.

Należy przypisać poziom priorytetu do każdego poziomu, który określa kolejność, w jakiej są one oceniane przez Google Play. Więcej informacji znajdziesz w dokumentacji dotyczącej DeviceTier.level.

Zapis JSON
{
  "deviceTiers": [
    {
      object (DeviceTier)
    }
  ]
}
Pola
deviceTiers[]

object (DeviceTier)

Poziomy urządzeń należące do zestawu.

DeviceTier

poziom pojedynczego urządzenia.

Urządzenia pasujące do dowolnej z grup urządzeń w ustawieniach deviceGroupNames są uznawane za pasujące do poziomu.

Zapis JSON
{
  "deviceGroupNames": [
    string
  ],
  "level": integer
}
Pola
deviceGroupNames[]

string

Grupy urządzeń uwzględnione w tym poziomie. W ramach tej konfiguracji grupy te muszą być zdefiniowane w grupie deviceGroups.

level

integer

Poziom priorytetu poziomu.

Poziomy są oceniane w kolejności odwrotnej do ich poziomu: najwyższy poziom ma najwyższy priorytet. Dla danego urządzenia wybierany jest najwyższy poziom, który jest z nim zgodny.

W przypadku zestawu poziomów należy użyć ciągłego zakresu poziomów. Poziomy w danym zestawie muszą być niepowtarzalne. Jeśli np. masz 4 poziomy (w tym globalny poziom zastępczy), w tej konfiguracji musisz zdefiniować poziomy 1, 2 i 3.

Uwaga: poziom 0 jest domyślnie zdefiniowany jako globalny poziom zastępczy i jest wybierany w przypadku urządzeń, które nie pasują do żadnego z poziomów zdefiniowanych tutaj w sposób jawny. W tej konfiguracji nie musisz definiować poziomu 0.

UserCountrySet

Zestaw krajów użytkowników.

Zestaw krajów określa, która wersja treści aplikacji jest wyświetlana w konkretnej lokalizacji.

Zapis JSON
{
  "name": string,
  "countryCodes": [
    string
  ]
}
Pola
name

string

Nazwa zestawu krajów.

countryCodes[]

string

Lista kodów krajów. Kod kraju jest reprezentowany w formacie ISO 3166 alfa-2. Przykład: „IT” dla Włoch, „GE” dla Gruzji.

Metody

create

Tworzy nową konfigurację poziomu urządzenia dla aplikacji.

get

Zwraca konfigurację poziomu aplikacji dla konkretnego urządzenia.

list

Zwraca utworzone konfiguracje poziomów aplikacji, posortowane według czasu utworzenia malejąco.