REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Zasób: SKAdNetworkConversionValueSchema

Schemat wartości konwersji SKAdNetwork dla strumienia 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 podrzędny TYLKO względem strumienia iOS, a w ramach strumienia iOS może być maksymalnie 1 takie konto podrzędne. 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 drugiego i trzeciego przedziału czasu wywołania zwrotnego tym, że zawierają wartość „Fine” ziarna wartość konwersji (wartość liczbowa).

Należy ustawić wartości konwersji dla tego okresu wywołania zwrotnego. Pozostałe okna są opcjonalne i mogą dziedziczyć ustawienia tego okna, jeśli nie są ustawione lub wyłączone.
postbackWindowTwo

object (PostbackWindow)

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

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

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

object (PostbackWindow)

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

To pole należy ustawiać tylko wtedy, gdy użytkownik wybrał dla tego okresu wywołania zwrotnego różne wartości konwersji. Można skonfigurować okno 3 bez ustawiania okna 2. W przypadku okresu 1 i W tym oknie wywołania zwrotnego skonfigurowano 2 ustawienia, a dla tego okna wywołania zwrotnego ma wartość false (fałsz). Schemat odziedziczy ustawienia z metody 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 będzie eksportowany na wszystkie konta Google Ads połączone z tą usługą. Jeśli ta opcja jest wyłączona, pakiet SDK Google Analytics 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 używana do określania priorytetów ustawień wartości konwersji. Wpisy o niższej liczbie zindeksowanych pozycji mają wyższy priorytet. Zostanie wybrane pierwsze ustawienie wartości konwersji, które zostanie uznane za 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, musisz wypełnić wartości conversionValues. Będą one używane do określania, kiedy i jak ustawić wartość konwersji na urządzeniu klienckim, oraz eksportowania schematu na połączone konta Google Ads. Jeśli ma wartość false (fałsz), ustawienia nie są używane, ale są zachowywane na wypadek, gdyby mogły zostać użyte w przyszłości. Ta zasada musi zawsze mieć wartość prawda w przypadku wywołania postbackWindowOne.

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. Wartość konwersji o przybliżonej ziarnistości.

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

object (EventMapping)

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

boolean

Jeśli to prawda, pakiet SDK powinien w bieżącym okresie wywołania zwrotnego ustawić tę wartość konwersji.
fineValue

integer

Szczegółowa wartość konwersji. Dotyczy to tylko pierwszego okresu wywołania zwrotnego. Jego prawidłowe wartości to [0,63], włącznie. Należy ustawić ją dla przedziału czasu wywołania zwrotnego 1, a nie dla przedziału 2 wywołania zwrotnego & 3. Ta wartość nie musi być unikalna.

Jeśli konfiguracja pierwszego przedziału czasu wywołania zwrotnego jest ponownie używana dla drugiego lub trzeciego okresu 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 ConversionValues.event_mappings. Więcej informacji znajdziesz na stronie SKAdNetwork.CoarseConversionValue.

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

EventMapping

Warunki ustawiania zdarzenia na potrzeby dopasowania do zdarzenia.

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

string

Wymagane. Nazwa zdarzenia GA4. Ta wartość 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 jedną z tych 4 wartości min./maks. Ustawione wartości będą połączone operatorem ORAZ, aby zakwalifikować zdarzenie. Minimalna liczba wystąpień zdarzenia. Jeśli zasada nie jest skonfigurowana, 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 jest sprawdzana.
minEventValue

number

Minimalne przychody wygenerowane w wyniku tego zdarzenia. Waluta przychodów zostanie zdefiniowana na poziomie usługi. Jeśli jej nie skonfigurujesz, 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 zasada nie jest skonfigurowana, maksymalna wartość zdarzenia nie będzie sprawdzana.

Metody

create

 Tworzy SKAdNetworkConversionValueSchema.

delete

 Usuwa docelową wartość SKAdNetworkConversionValueSchema.

get

 Wyszukuje jeden SKAdNetworkConversionValueSchema.

list

 Wyświetla listę SKAdNetworkConversionValueSchema w strumieniu.

patch

 Aktualizuje SKAdNetworkConversionValueSchema.