Kierowanie zasobów według kilku wymiarów (kierowanie zagnieżdżone)

Aby kierować reklamy na folder w pakiecie zasobów lub module pakietu według kilku wymiarów (format kompresji tekstury, typ urządzenia, zestaw krajów), możesz użyć kierowania zagnieżdżonego.

Kierowanie zagnieżdżone pozwala definiować kryteria kierowania łączące maksymalnie 2 wymiary kierowania.

Format

Aby ustawić kierowanie na folder według kilku wymiarów, określ listę wymiarów w serii przyrostków hashtagu dla nazwy folderu.

Jeśli chcesz np. kierować reklamy na folder zasobów według formatu kompresji tekstur ASTC i poziomu urządzenia 2, kierowanie powinno wyglądać tak:

...
.../level1/src/main/assets/character-textures#tcf_astc#tier_2/
...

Jeśli do tworzenia aplikacji używasz narzędzia Gradle, sufiksy kierowania są usuwane z nazwy katalogu w ostatecznych plikach APK lub pakietach zasobów dostarczanych na urządzenia użytkowników.

Jeśli bezpośrednio korzystasz z narzędzia do pakietu, w usłudze BundleConfig.json określ, czy chcesz usunąć sufiks dla każdego wymiaru z osobna. Oto przykład kierowania na kategorię urządzeń:

{
  ...
  "optimizations": {
    "splitsConfig": {
      "splitDimension": [
      ...
      {
        "value": "DEVICE_TIER",
        "negate": false,
        "suffixStripping": {
          "enabled": true,
      }],
    }
  }
}

Kierowanie zagnieżdżone jest obsługiwane w narzędziu do pakietu w wersji 1.14.1 lub nowszej oraz w wtyczce Gradle na Androida w wersji 8.2.0-alpha01 lub nowszej, która wymaga narzędzia Gradle w wersji 8.1 lub nowszej.

Więcej informacji o dostosowywaniu konfiguracji poszczególnych wymiarów znajdziesz w dokumentacji poszczególnych wymiarów kierowania.

Ograniczenia

  • Możesz użyć maksymalnie 2 zagnieżdżonych wymiarów. Inaczej mówiąc, nie możesz ustawić folderu, na który kierujesz jednocześnie typ urządzenia, format kompresji tekstur i kraj. Musisz wybrać 2 opcje.

  • Dwa zagnieżdżone wymiary musisz podać na tym samym poziomie ścieżki folderu. Na przykład zabronione jest kierowanie na foldery, ponieważ #tcf_astc i #tier_2 pojawiają się w różnych segmentach ścieżki:

.../level1/src/main/assets/character-textures#tcf_astc/level1#tier_2/
  • Zagnieżdżone wymiary muszą być takie same w całym pakiecie. Na przykład nie możesz mieć pakietu zasobów, w którym zagnieżdżasz poziomy urządzeń i kraje, a drugi, w którym zagnieżdżasz ustawienia kraju i format kompresji tekstur.

  • Wartości używane w przypadku 2 wymiarów muszą być takie same w całym pakiecie. Musisz też określić pełną kombinację wartości. Jeśli np. chcesz zagnieżdżać format kompresji tekstur i ustawiony kraj, a masz 4 zasady TCF (ASTC, ETC2, PVRTC, domyślny element zastępczy) i 3 zestawy krajów (latam, morze, domyślna wartość zastępcza), musisz określić folder dla wszystkich 12 kombinacji:

level1/textures#countries_latam#tcf_astc/…
level1/textures#countries_latam#tcf_etc2/…
level1/textures#countries_latam#tcf_pvrtc/…
level1/textures#countries_latam/…
level1/textures#countries_sea#tcf_astc/…
level1/textures#countries_sea#tcf_etc2/…
level1/textures#countries_sea#tcf_pvrtc/…
level1/textures#countries_sea/…
level1/textures#tcf_astc/…
level1/textures#tcf_etc2/…
level1/textures#tcf_pvrtc/…
level1/textures/…
  • W przypadku różnych folderów z treściami w tym samym pakiecie zasobów lub module pakietu możesz używać zarówno kierowania zagnieżdżonego, jak i kierowania jednowymiarowego. Jeśli danego wymiaru używasz zarówno w kierowaniu jednowymiarowym, jak i w kierowaniu zagnieżdżonym, używany zestaw wartości musi być zawsze taki sam. W kierowaniu jednowymiarowym na poziomie urządzenia nie można np. ustawić kierowania według 4 poziomów, a po zagnieżdżeniu w zbiorach krajów lub zasadach TCF używać tylko 3 poziomów.