- Zasób: SKAdNetworkConversionValueSchema
- PostbackWindow (Okres wywołania zwrotnego)
- ConversionValues
- CoarseValue
- EventMapping (Mapowanie zdarzeń)
- Metody
Zasób: SKAdNetworkConversionValueSchema
Schemat wartości konwersji SKAdNetwork w strumieniu iOS.
Zapis JSON |
---|
{ "name": string, "postbackWindowOne": { object ( |
Pola | |
---|---|
name |
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 |
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 |
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 |
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 |
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 ( |
Pola | |
---|---|
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 |
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 ( |
Pola | |
---|---|
displayName |
Wyświetlana nazwa wartości konwersji SKAdNetwork. Maksymalna dozwolona długość wyświetlanej nazwy to 50 jednostek kodu UTF-16. |
coarseValue |
Wymagane. Przybliżona wartość konwersji. Ta wartość nie musi być niepowtarzalna. |
eventMappings[] |
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 |
Jeśli wartość to prawda, pakiet SDK powinien zablokować tę wartość konwersji na potrzeby bieżącego okresu wywołania zwrotnego. |
fineValue |
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 |
Wymagane. Nazwa zdarzenia GA4. Wartość musi być zawsze ustawiona. Maksymalna dozwolona długość wyświetlanej nazwy to 40 jednostek kodu UTF-16. |
minEventCount |
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 |
Maksymalna liczba wystąpień zdarzenia. Jeśli zasada nie jest skonfigurowana, maksymalna liczba zdarzeń nie będzie sprawdzana. |
minEventValue |
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 |
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 |
|
---|---|
|
Tworzy SKAdNetworkConversionValueSchema. |
|
Usuwa docelową wartość SKAdNetworkConversionValueSchema. |
|
Wyszukuje pojedynczy SKAdNetworkConversionValueSchema. |
|
Wyświetla listę SKAdNetworkConversionValueSchema w strumieniu. |
|
Aktualizuje SKAdNetworkConversionValueSchema. |