REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Zasób: SKAdNetworkConversionValueSchema

Schemat wartości konwersji SKAdNetwork w strumieniu danych na iOS.

Zapis JSON 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu schematu. Będzie on elementem podrzędnym TYLKO strumienia iOS i może mieć maksymalnie 1 element podrzędny w strumieniu iOS. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

Wymagane. Ustawienia wartości konwersji dla pierwszego okna wywołania zwrotnego. Różnią się one od wartości w przypadku 2. i 3. okresu czasu wywołania zwrotnego tym, że zawierają dokładną wartość konwersji (wartość liczbową).

Wartości konwersji dla tego okna wywołania zwrotnego muszą być ustawione. Pozostałe okna są opcjonalne i mogą odziedziczyć ustawienia tego okna, jeśli nie są skonfigurowane lub wyłączone.
postbackWindowTwo

object (PostbackWindow)

Ustawienia wartości konwersji dla drugiego okna wywołania zwrotnego.

To pole należy skonfigurować tylko wtedy, gdy chcesz zdefiniować różne wartości konwersji dla tego okna wywołania zwrotnego.

Jeśli dla tego okna wywołania zwrotnego parametr enable_postback_window_settings ma wartość false, zostaną użyte wartości z postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

Ustawienia wartości konwersji dla 3 okna wywołania zwrotnego.

To pole powinno być ustawione tylko wtedy, gdy użytkownik zdecyduje się zdefiniować różne wartości konwersji dla tego okna wywołania zwrotnego. Można skonfigurować okno 3 bez ustawiania okna 2. Jeśli ustawione są ustawienia okna 1 i 2, a dla tego okna ustawiona jest wartość „fałsz” w przypadku ustawienia enable_postback_window_settings, schemat odziedziczy ustawienia z postbackWindowTwo.
applyConversionValues

boolean

Jeśli ta opcja jest włączona, pakiet GA SDK będzie ustawiać wartości konwersji za pomocą tej definicji schematu, a schemat zostanie wyeksportowany na wszystkie konta Google Ads połączone z tą usługą. Jeśli ta opcja jest wyłączona, pakiet GA SDK nie będzie automatycznie ustawiać wartości konwersji, a schemat nie będzie eksportowany do Google Ads.

PostbackWindow

Ustawienia okna wywołania zwrotnego konwersji SKAdNetwork.

Zapis JSON 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Pola
conversionValues[]

object (ConversionValues)

Do ustalania priorytetów ustawień wartości konwersji służy kolejność pól powtarzających się. Wpisy o niższym indeksie mają wyższy priorytet. Wybrane zostanie pierwsze ustawienie wartości konwersji, które zostanie ocenione jako „prawda”. Jeśli parametr enable_postback_window_settings ma wartość true, musi zawierać co najmniej 1 wartość. Może on zawierać maksymalnie 128 pozycji.
postbackWindowSettingsEnabled

boolean

Jeśli parametr enable_postback_window_settings ma wartość true, musisz wypełnić tablicę conversionValues. Będzie ona używana do określania, kiedy i jak ustawić wartość konwersji na urządzeniu klienta oraz do eksportowania schematu na połączone konta Google Ads. Jeśli wartość to fałsz, ustawienia nie są używane, ale są przechowywane na wypadek, gdyby miały być użyte w przyszłości. W przypadku postbackWindowOne musi być zawsze ustawiona na „True”.

ConversionValues

Ustawienia wartości konwersji w oknie wywołania zwrotnego dla schematu wartości konwersji SKAdNetwork

Zapis JSON 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Pola
displayName

string

Wyświetlana nazwa wartości konwersji SKAdNetwork. Maksymalna dozwolona długość nazwy wyświetlanej to 50 jednostek kodu UTF-16.
coarseValue

enum (CoarseValue)

Wymagane. Przybliżona wartość konwersji.

Nie ma gwarancji, że ta wartość będzie niepowtarzalna.
eventMappings[]

object (EventMapping)

Warunki zdarzenia, które muszą zostać spełnione, aby ta wartość konwersji została osiągnięta. Warunki na tej liście są połączone operatorem logicznym ORAZ. Jeśli włączone jest okno zwrotne, musi zawierać co najmniej 1 i maksymalnie 3 elementy.
lockEnabled

boolean

Jeśli wartość to prawda, pakiet SDK powinien zablokować tę wartość konwersji na czas bieżącego okna wywołania zwrotnego.
fineValue

integer

Dokładna wartość konwersji. Dotyczy to tylko pierwszego okna wywołania zwrotnego. Prawidłowe wartości to [0,63], obustronnie domknięte. Musisz go ustawić w przypadku przedziału czasu wywołania zwrotnego 1, ale nie w przypadku przedziałów czasu wywołania zwrotnego 2 i 3. Nie ma gwarancji, że ta wartość będzie niepowtarzalna.

Jeśli konfiguracja pierwszego przedziału czasu wywołania zwrotnego jest używana ponownie w przypadku drugiego lub trzeciego przedziału czasu wywołania zwrotnego, to pole nie ma zastosowania.

CoarseValue

Przybliżona wartość konwersji ustawiona w wywołaniu metody updatePostbackConversionValue w SDK, gdy są spełnione warunki w pliku ConversionValues.event_mappings. Więcej informacji znajdziesz w sekcji SKAdNetwork.CoarseConversionValue.

Wartości w polu enum
COARSE_VALUE_UNSPECIFIED Nie określono wartości ogólnej.
COARSE_VALUE_LOW Przybliżona wartość niska.
COARSE_VALUE_MEDIUM Przybliżona wartość medium.
COARSE_VALUE_HIGH Przybliżona wartość wysoka.

EventMapping

Warunki ustawienia zdarzenia dopasowujące się do zdarzenia.

Zapis JSON 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Pola
eventName

string

Wymagane. Nazwa zdarzenia Google Analytics. Musi być zawsze ustawione. Maksymalna dozwolona długość nazwy wyświetlanej to 40 jednostek kodu UTF-16.
minEventCount

string (int64 format)

Należy ustawić co najmniej 1 z tych 4 wartości minimalnych/maksymalnych. Aby zakwalifikować zdarzenie, wartości zostaną złączone za pomocą operatora AND. Minimalna liczba wystąpień zdarzenia. Jeśli nie zostanie ustawiony, minimalna liczba zdarzeń nie będzie sprawdzana.
maxEventCount

string (int64 format)

Maksymalna liczba wystąpień zdarzenia. Jeśli nie jest ustawiony, maksymalna liczba zdarzeń nie będzie sprawdzana.
minEventValue

number

Minimalne przychody wygenerowane dzięki zdarzeniu. Waluta przychodów zostanie zdefiniowana na poziomie usługi. Jeśli nie zostanie ustawiona, minimalna wartość zdarzenia nie będzie sprawdzana.
maxEventValue

number

Maksymalne przychody wygenerowane dzięki temu zdarzeniu. Waluta przychodów zostanie zdefiniowana na poziomie usługi. Jeśli nie jest ustawiona, maksymalna wartość zdarzenia nie zostanie sprawdzona.

Metody

create

 Tworzy schemat wartości konwersji SKAdNetwork.

delete

 Usuwa docelowy schemat wartości konwersji SKAdNetwork.

get

 Wyszukiwanie pojedynczego schematu wartości konwersji SKAdNetwork.

list

 Wypisuje w strumieniach schemat SKAdNetworkConversionValueSchema.

patch

 Aktualizuje schemat SKAdNetworkConversionValueSchema.