REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Zasób: SKAdNetworkConversionValueSchema

Schemat wartości konwersji SKAdNetwork w przypadku strumienia danych z iOS.

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

string

Identyfikator. Nazwa zasobu schematu. Będzie to element podrzędny TYLKO strumienia iOS i w strumieniu iOS może być co najwyżej 1 taki element podrzędny. 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 dla przedziałów czasu wywołania zwrotnego 2 i 3 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ą dziedziczyć ustawienia tego okna, jeśli nie są skonfigurowane lub są wyłączone.
postbackWindowTwo

object (PostbackWindow)

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

To pole należy skonfigurować tylko wtedy, gdy istnieje potrzeba zdefiniowania różnych wartości konwersji dla tego okna wywołania zwrotnego.

Jeśli w przypadku tego przedziału czasu wywołania zwrotnego parametr enable_postback_window_settings ma wartość „false”, używane będą wartości z parametru postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

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

To pole należy ustawić tylko wtedy, gdy użytkownik zdecyduje się zdefiniować różne wartości konwersji dla tego okna wywołania zwrotnego. Możesz skonfigurować okno 3 bez ustawiania okna 2. Jeśli ustawienia przedziałów czasu 1 i 2 są skonfigurowane, a wartość parametru enable_postback_window_settings dla tego przedziału czasu wywołania zwrotnego jest ustawiona na false, schemat odziedziczy ustawienia z parametru postbackWindowTwo.
applyConversionValues

boolean

Jeśli ta opcja jest włączona, pakiet SDK GA będzie ustawiać wartości konwersji na podstawie tej definicji schematu, a schemat będzie eksportowany na wszystkie konta Google Ads połączone z tą usługą. Jeśli ta opcja jest wyłączona, pakiet SDK GA 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)

Kolejność powtarzanego pola będzie używana do ustalania priorytetów ustawień wartości konwersji. Wpisy o niższym indeksie mają wyższy priorytet. Zostanie wybrane pierwsze ustawienie wartości konwersji, które ma wartość „prawda”. Jeśli parametr enable_postback_window_settings ma wartość „true”, musi zawierać co najmniej 1 wpis. Może zawierać maksymalnie 128 pozycji.
postbackWindowSettingsEnabled

boolean

Jeśli enable_postback_window_settings ma wartość true, pole conversionValues musi być wypełnione i będzie używane do określania, kiedy i jak ustawić wartość konwersji na urządzeniu klienta oraz eksportować schemat na połączone konta Google Ads. Jeśli wartość to „false”, ustawienia nie są używane, ale są zachowywane na wypadek, gdyby w przyszłości miały być użyte. W przypadku parametru postbackWindowOne ta wartość musi być zawsze prawdziwa.

ConversionValues

Ustawienia wartości konwersji dla okna wywołania zwrotnego w schemacie 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ść wyświetlanej nazwy to 50 jednostek kodu UTF-16.
coarseValue

enum (CoarseValue)

Wymagane. Przybliżona wartość konwersji.

Ta wartość nie musi być unikalna.
eventMappings[]

object (EventMapping)

Warunki zdarzenia, które muszą zostać spełnione, aby osiągnąć tę wartość konwersji. Warunki na tej liście są połączone operatorem logicznym ORAZ. Jeśli okno wywołania zwrotnego jest włączone, musi zawierać co najmniej 1 wpis i maksymalnie 3 wpisy.
lockEnabled

boolean

Jeśli wartość to „true”, pakiet SDK powinien zablokować tę wartość konwersji w bieżącym przedziale czasu wywołania zwrotnego.
fineValue

integer

Dokładna wartość konwersji. Dotyczy to tylko pierwszego okresu po kliknięciu. Prawidłowe wartości to [0, 63] (włącznie). Musi być ustawiony w przypadku przedziału czasu wywołania zwrotnego 1, a nie może być ustawiony w przypadku przedziałów czasu wywołania zwrotnego 2 i 3. Ta wartość nie musi być unikalna.

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

CoarseValue

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

Wartości w polu enum
COARSE_VALUE_UNSPECIFIED Nie określono przybliżonej wartości.
COARSE_VALUE_LOW Przybliżona wartość dolna.
COARSE_VALUE_MEDIUM Wartość przybliżona medium.
COARSE_VALUE_HIGH Wartość przybliżona wysoka.

EventMapping

warunki ustawień zdarzenia, aby dopasować zdarzenie.

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

string

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

string (int64 format)

Musisz ustawić co najmniej 1 z tych 4 wartości minimalnych lub maksymalnych. Ustawione wartości zostaną połączone za pomocą operatora AND, aby kwalifikować zdarzenie. Minimalna liczba wystąpień zdarzenia. Jeśli nie jest ustawiona, minimalna liczba zdarzeń nie będzie sprawdzana.
maxEventCount

string (int64 format)

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

number

Minimalne przychody wygenerowane w wyniku zdarzenia. Waluta przychodów zostanie określona na poziomie usługi. Jeśli nie jest ustawiona, minimalna wartość zdarzenia nie będzie sprawdzana.
maxEventValue

number

Maksymalne przychody wygenerowane dzięki zdarzeniu. Waluta przychodów zostanie określona na poziomie usługi. Jeśli nie zostanie ustawiona, maksymalna wartość zdarzenia nie będzie sprawdzana.

Metody

create

 Tworzy obiekt SKAdNetworkConversionValueSchema.

delete

 Usuwa docelowy schemat wartości konwersji SKAdNetwork.

get

 Wyszukuje pojedynczy schemat wartości konwersji SKAdNetwork.

list

 Wyświetla listę SKAdNetworkConversionValueSchema w strumieniu.

patch

 Aktualizuje obiekt SKAdNetworkConversionValueSchema.