REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Zasób: SKAdNetworkConversionValueSchema

Schemat wartości konwersji SKAdNetwork w strumieniu 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 to element podrzędny TYLKO w przypadku strumienia danych z iOS, a w strumieniu z iOS może znajdować się maksymalnie 1 taki element podrzędny. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

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

Musisz ustawić wartości konwersji dla tego okna wywołania zwrotnego. Pozostałe okna są opcjonalne i mogą dziedziczyć ustawienia tego okna, jeśli są nieskonfigurowane lub wyłączone.
postbackWindowTwo

object (PostbackWindow)

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

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

Jeśli opcja allow_postback_window_settings ma w tym przedziale czasu wywołania zwrotnego wartość false (fałsz), używane będą wartości z postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

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

To pole należy ustawiać tylko wtedy, gdy użytkownik określił inne wartości konwersji dla tego przedziału czasu wywołania zwrotnego. Zezwolono na skonfigurowanie okna 3 bez ustawiania okna 2. Jeśli ustawienia przedziałów 1 i 2 są skonfigurowane, a ustawienie allow_postback_window_settings dla tego okresu wywołania zwrotnego ma wartość false, schemat odziedziczy ustawienia z postbackWindowTwo.
applyConversionValues

boolean

Jeśli ta opcja jest włączona, pakiet SDK Google Analytics będzie ustawiać wartości konwersji na podstawie tej definicji schematu, a schemat zostanie wyeksportowany na wszystkie konta Google Ads połączone z tą usługą. Jeśli wyłączysz tę opcję, 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ść pól powtarzanych będzie miała priorytet względem ustawień wartości konwersji. Pozycje zindeksowane mają wyższy priorytet. Wybrane zostanie pierwsze ustawienie wartości konwersji, które otrzyma wartość prawda. Jeśli parametr allow_postback_window_settings ma wartość true, musi zawierać co najmniej 1 wpis. Może zawierać maksymalnie 128 wpisów.
postbackWindowSettingsEnabled

boolean

Jeśli parametr allow_postback_window_settings ma wartość true (prawda), conversionValues muszą być wypełnione i będą używane do określania, kiedy i jak ustawiać wartość konwersji na urządzeniu klienckim oraz eksportować schemat na połączone konta Google Ads. Jeśli ma wartość false (fałsz), ustawienia nie są używane, ale są zachowywane na wypadek ich użycia w przyszłości. Ta zasada musi zawsze mieć wartość dla wywołania zwrotnegobackWindowOne.

ConversionValues

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

enum (CoarseValue)

Wymagane. Przybliżona wartość konwersji.

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

object (EventMapping)

Warunki zdarzenia, które muszą zostać spełnione, aby została osiągnięta ta wartość konwersji. Warunki na tej liście są połączone operatorem ORAZ. Jeśli przedział czasu wywołania zwrotnego jest włączony, musi zawierać od 1 do 3 wpisów.
lockEnabled

boolean

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

integer

Szczegółowe informacje o wartości konwersji. Dotyczy to tylko pierwszego okresu wywołania zwrotnego. Jego prawidłowe wartości to [0,63] (obie włącznie). Musi być ustawiona dla przedziału czasu wywołania zwrotnego 1 i nie może być ustawiona dla przedziału czasu 2 i 3. Ta wartość nie musi być niepowtarzalna.

Jeśli konfiguracja pierwszego przedziału czasu wywołania zwrotnego jest używana ponownie w drugim lub trzecim przedziale czasu wywołania zwrotnego, to pole nie ma żadnego efektu.

CoarseValue

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

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

EventMapping

Warunki ustawienia zdarzenia pasujące do zdarzenia.

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

string

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

string (int64 format)

Należy ustawić co najmniej jedną z czterech następujących wartości min./maks. Aby zakwalifikować zdarzenie, ustawione wartości będą połączone operatorem ORAZ. Minimalna liczba wystąpień zdarzenia. Jeśli zasada jest nieskonfigurowana, minimalna liczba zdarzeń nie jest sprawdzana.
maxEventCount

string (int64 format)

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

number

Minimalne przychody wygenerowane w związku ze zdarzeniem. Waluta przychodów zostanie określona na poziomie usługi. Jeśli nie jest skonfigurowana, minimalna wartość zdarzenia nie jest sprawdzana.
maxEventValue

number

Maksymalne przychody wygenerowane w ramach wydarzenia. Waluta przychodów zostanie określona na poziomie usługi. Jeśli zasada jest nieskonfigurowana, maksymalna wartość zdarzenia nie jest sprawdzana.

Metody

create

 Tworzy SKAdNetworkConversionValueSchema.

delete

 Usuwa docelową wartość SKAdNetworkConversionValueSchema.

get

 Wyszukuje pojedynczy SKAdNetworkConversionValueSchema.

list

 Wyświetla listę SKAdNetworkConversionValueSchema w strumieniu.

patch

 Aktualizuje SKAdNetworkConversionValueSchema.