Package google.ads.datamanager.v1

string

Opcjonalnie. Atrybuty sesji na potrzeby atrybucji i modelowania zdarzeń.

string

Opcjonalnie. Identyfikator kliknięcia Google (gclid) powiązany z tym zdarzeniem.

string

Opcjonalnie. Identyfikator kliknięcia w przypadku kliknięć powiązanych ze zdarzeniami w aplikacji pochodzącymi z urządzeń z systemem iOS od wersji 14.

string

Opcjonalnie. Identyfikator kliknięcia w przypadku kliknięć powiązanych ze zdarzeniami w witrynie pochodzącymi z urządzeń z systemem iOS od wersji 14.

DeviceInfo

Opcjonalnie. Informacje zebrane o urządzeniu używanym (jeśli dotyczy) w momencie wejścia na stronę reklamodawcy po interakcji z reklamą.

string

Wymagane. Imię użytkownika (pisane małymi literami, bez znaków interpunkcyjnych, bez spacji na początku i na końcu, zahaszowane za pomocą SHA-256).

string

Wymagane. Nazwisko użytkownika (w całości małymi literami, bez znaków interpunkcyjnych, bez spacji na początku i na końcu, zahaszowane za pomocą SHA-256).

string

Wymagane. Dwuliterowy kod regionu w formacie ISO-3166-1 alpha-2 adresu użytkownika.

string

Wymagane. Kod pocztowy adresu użytkownika.

string

Opcjonalnie. Określa, na którą Destination ma zostać przekierowany odbiorca.

Consent

Opcjonalnie. Ustawienie zgody użytkownika.

UserData

Dane przekazywane przez użytkowników, które identyfikują użytkownika.

PairData

Identyfikatory dopasowywania danych o tożsamości użytkowników (PAIR).

Ta funkcja jest dostępna tylko dla partnerów danych.

MobileData

Dane identyfikujące urządzenia mobilne użytkownika.

UserIdData

Dane związane z unikalnymi identyfikatorami użytkownika zdefiniowanymi przez reklamodawcę.

PpidData

Dane związane z identyfikatorami podawanymi przez wydawców.

Ta funkcja jest dostępna tylko dla partnerów danych.

KeyType

Wymagane. Typ algorytmu użytego do zaszyfrowania danych.

string

Wymagane. Nazwa zasobu Amazon (ARN) roli uprawnień przyjmowanej na potrzeby dostępu do odszyfrowywania KMS. Powinien mieć format arn:{partition}:iam::{account_id}:role/{role_name}

string

Wymagane. Identyfikator URI klucza AWS KMS używanego do odszyfrowywania klucza DEK. Powinien mieć format arn:{partition}:kms:{region}:{account_id}:key/{key_id} lub aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}

string

Wymagane. Zaszyfrowany klucz szyfrujący dane zakodowany w formacie base64.

Location

Lokalizacja bazowa żądania. Lokalizacja bazowa to lista regionów połączonych operatorem LUB.

bool

Jeśli ustawisz wartość „true”, usługa spróbuje automatycznie wykryć lokalizację bazową dla statystyk.

string

Lista kodów regionów w formacie ISO 3166-1 alfa-2.

string

Opcjonalnie. Identyfikator Merchant Center powiązany z produktami.

string

Opcjonalnie. Etykieta pliku danych Merchant Center powiązana z plikiem danych produktów.

string

Opcjonalnie. Kod języka w formacie ISO 639-1 powiązany z plikiem danych Merchant Center produktów, w którym przesyłane są Twoje produkty.

double

Opcjonalnie. Suma wszystkich rabatów powiązanych z transakcją.

Item

Opcjonalnie. Lista produktów powiązanych ze zdarzeniem.

ConsentStatus

Opcjonalnie. Określa, czy użytkownik wyraża zgodę na korzystanie z danych użytkowników reklam.

ConsentStatus

Opcjonalnie. Określa, czy użytkownik wyraża zgodę na personalizację reklam.

int32

Tylko dane wyjściowe. Współczynnik dopasowania w przypadku list użytkowników kierowania na listę klientów.

DataSourceType

Opcjonalnie. Niezmienna. Źródło przesyłanych danych

string

Wymagane. Element nadrzędny, do którego należy ta kolekcja linków partnerskich. Format: accountTypes/{account_type}/accounts/{account}

PartnerLink

Wymagane. Link partnera do utworzenia.

string

Wymagane. Konto, do którego należy licencjonowana lista użytkowników. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

UserListDirectLicense

Wymagane. Lista użytkowników bezpośrednio licencjonowana do tworzenia.

string

Wymagane. Konto, do którego należy licencjonowana lista użytkowników. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

UserListGlobalLicense

Wymagane. Licencja globalna na listę użytkowników do utworzenia.

string

Wymagane. Konto nadrzędne, na którym zostanie utworzona ta lista użytkowników. Format: accountTypes/{account_type}/accounts/{account}

UserList

Wymagane. Lista użytkowników do utworzenia.

bool

Opcjonalnie. Jeśli wartość to „prawda”, żądanie jest weryfikowane, ale nie wykonywane.

string

Opcjonalnie. Nazwa zmiennej niestandardowej do ustawienia. Jeśli zmienna nie zostanie znaleziona w przypadku danego miejsca docelowego, zostanie zignorowana.

string

Opcjonalnie. Wartość do zapisania w zmiennej niestandardowej.

string

Opcjonalnie. Ciąg odniesienia używany do określania, do którego z Event.destination_references należy wysłać zmienną niestandardową. Jeśli pole jest puste, używana jest wartość Event.destination_references.

string

Wymagane. Nazwa zasobu linku partnera do usunięcia. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

string

Wymagane. Nazwa listy użytkowników do usunięcia. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

bool

Opcjonalnie. Jeśli wartość to „prawda”, żądanie jest weryfikowane, ale nie wykonywane.

string

Opcjonalnie. Identyfikator tego zasobu Destination, unikalny w ramach żądania. Służy do odwoływania się do tego zasobu Destination w elementach IngestEventsRequest i IngestAudienceMembersRequest.

ProductAccount

Opcjonalnie. Konto użyte do wykonania tego wywołania interfejsu API. Aby dodawać lub usuwać dane z operating_account, to login_account musi mieć uprawnienia do zapisu w operating_account. Na przykład konto menedżera operating_account lub konto z ustalonym połączeniem z operating_account.

ProductAccount

Opcjonalnie. Konto, do którego login_account użytkownika wywołującego ma dostęp za pomocą utworzonego połączenia kont. Na przykład login_account partnera danych może mieć dostęp do linked_account klienta. Partner może używać tego pola do wysyłania danych z linked_account do innego operating_account.

ProductAccount

Wymagane. Konto, na które mają być wysyłane dane lub z którego mają być usuwane.

string

Wymagane. Obiekt na koncie usługi, do którego mają być przesyłane dane. Może to być np. identyfikator listy odbiorców Google Ads, identyfikator listy odbiorców Display & Video 360 lub identyfikator działania powodującego konwersję w Google Ads.

string

Opcjonalnie. Ciąg znaków klienta użytkownika urządzenia w danym kontekście.

string

Opcjonalnie. Adres IP urządzenia w danym kontekście.

Uwaga: Google Ads nie obsługuje dopasowywania adresów IP w przypadku użytkowników z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii (UK) i Szwajcarii (CH). Dodaj funkcję logiczną, która warunkowo wyklucza udostępnianie adresów IP użytkowników z tych regionów, i zadbaj o to, aby udostępniać użytkownikom jasne i wyczerpujące informacje na temat danych, które zbierasz w swoich witrynach, aplikacjach i innych usługach, a jeśli jest to wymagane przez prawo lub obowiązujące zasady Google, uzyskać ich zgodę. Więcej informacji znajdziesz na stronie Importowanie konwersji offline.

GcpWrappedKeyInfo

Informacje o kluczu obudowanym w Google Cloud Platform.

AwsWrappedKeyInfo

Informacje o kluczu obudowanym przez Amazon Web Services.

int64

Liczba rekordów, których nie udało się przesłać z określonego powodu.

ProcessingErrorReason

Przyczyna błędu w przypadku nieudanych rekordów.

ErrorCount

Lista błędów i liczba błędów według przyczyny. Może nie być wypełniony we wszystkich przypadkach.

string

Opcjonalnie. Ciąg znaków referencyjny używany do określania miejsca docelowego. Jeśli to pole jest puste, zdarzenie zostanie wysłane do wszystkich destinations w żądaniu.

string

Opcjonalnie. Unikalny identyfikator tego zdarzenia. Wymagane w przypadku konwersji korzystających z wielu źródeł danych.

Timestamp

Wymagane. Czas wystąpienia zdarzenia.

Timestamp

Opcjonalnie. Ostatnia aktualizacja wydarzenia.

UserData

Opcjonalnie. Fragmenty danych przekazywanych przez użytkowników, które reprezentują użytkownika powiązanego ze zdarzeniem.

Consent

Opcjonalnie. Informacje o tym, czy powiązany użytkownik wyraził zgodę na różne rodzaje przetwarzania danych.

AdIdentifiers

Opcjonalnie. Identyfikatory i inne informacje używane do dopasowywania zdarzenia konwersji do innej aktywności online (np. kliknięć reklam).

string

Opcjonalnie. Kod waluty powiązany ze wszystkimi wartościami pieniężnymi w tym zdarzeniu.

EventSource

Opcjonalnie. Sygnał wskazujący, gdzie wystąpiło zdarzenie (w internecie, aplikacji, sklepie stacjonarnym itp.).

DeviceInfo

Opcjonalnie. Informacje zebrane o urządzeniu używanym (jeśli dotyczy) w momencie wystąpienia zdarzenia.

CartData

Opcjonalnie. Informacje o transakcji i produktach powiązanych ze zdarzeniem.

CustomVariable

Opcjonalnie. Dodatkowe informacje o parach klucz/wartość do wysłania do kontenerów konwersji (działanie powodujące konwersję lub aktywność FL).

ExperimentalField

Opcjonalnie. Lista par klucz/wartość dla pól eksperymentalnych, które mogą zostać włączone do interfejsu API.

UserProperties

Opcjonalnie. Informacje o użytkowniku ocenione przez reklamodawcę w momencie wystąpienia zdarzenia.

string

Opcjonalnie. Nazwa zdarzenia. Wymagany w przypadku zdarzeń GA4.

string

Opcjonalnie. Unikalny identyfikator instancji użytkownika klienta internetowego w tym strumieniu danych internetowych GA4.

string

Opcjonalnie. Unikalny identyfikator użytkownika zdefiniowany przez reklamodawcę.

EventParameter

Opcjonalnie. Zbiór dowolnych parametrów zdarzenia, które mają być uwzględnione w zdarzeniu, a nie zostały jeszcze określone za pomocą innych pól strukturalnych.

double

Opcjonalnie. Wartość konwersji powiązana ze zdarzeniem w przypadku konwersji opartych na wartości.

string

Wymagane. Nazwa parametru do użycia.

string

Wymagane. Ciąg znaków reprezentujący wartość parametru do ustawienia.

string

Opcjonalnie. Nazwa pola do użycia.

string

Opcjonalnie. Wartość pola do ustawienia.

KeyType

Wymagane. Typ algorytmu użytego do zaszyfrowania danych.

string

Wymagane. Dostawca puli Workload Identity wymagany do używania klucza KEK.

string

Wymagane. Identyfikator zasobu Cloud Key Management Service w Google Cloud Platform. Powinien mieć format projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} lub gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}

string

Wymagane. Zaszyfrowany klucz szyfrujący dane zakodowany w formacie base64.

string

Wymagane. Nazwa zasobu licencji bezpośredniej listy użytkowników.

string

Wymagane. Nazwa zasobu globalnej licencji na listę użytkowników.

string

Wymagane. Nazwa zasobu listy użytkowników do pobrania. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

Destination

Wymagane. Lista miejsc docelowych, do których mają być wysyłani odbiorcy.

AudienceMember

Wymagane. Lista użytkowników, do których mają być wysyłane dane do określonych miejsc docelowych. W jednym żądaniu można wysłać maksymalnie 10 tys. AudienceMember zasobów.

Consent

Opcjonalnie. Zgoda na poziomie żądania, która ma być stosowana do wszystkich użytkowników w żądaniu. Zgoda na poziomie użytkownika zastępuje zgodę na poziomie żądania i może być określona w każdym AudienceMember.

bool

Opcjonalnie. Do celów testowych. Jeśli true, żądanie jest weryfikowane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.

Encoding

Opcjonalnie. Wymagane w przypadku przesyłania plików UserData. Typ kodowania identyfikatorów użytkowników. W przypadku zaszyfrowanych identyfikatorów użytkowników jest to typ kodowania zaszyfrowanego ciągu znaków. W przypadku zaszyfrowanych identyfikatorów użytkowników z wartością hash jest to typ kodowania zewnętrznego zaszyfrowanego ciągu znaków, ale niekoniecznie wewnętrznego ciągu znaków z wartością hash. Oznacza to, że wewnętrzny ciąg znaków z wartością hash może być zakodowany w inny sposób niż zewnętrzny zaszyfrowany ciąg znaków. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.

EncryptionInfo

Opcjonalnie. Informacje o szyfrowaniu przesyłanych plików w UserData. Jeśli nie jest ustawiona, zakłada się, że przesłane informacje umożliwiające identyfikację są zahaszowane, ale nie zaszyfrowane. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.

TermsOfService

Opcjonalnie. Warunki korzystania z usługi, które użytkownik zaakceptował lub odrzucił.

string

Automatycznie wygenerowany identyfikator żądania.

Destination

Wymagane. Lista miejsc docelowych, do których mają być wysyłane zdarzenia.

Event

Wymagane. Lista zdarzeń do wysłania do określonych miejsc docelowych. W jednym żądaniu można wysłać maksymalnie 2000 zasobów Event.

Consent

Opcjonalnie. Zgoda na poziomie żądania, która ma być stosowana do wszystkich użytkowników w żądaniu. Zgoda na poziomie użytkownika zastępuje zgodę na poziomie żądania i może być określona w każdym Event.

bool

Opcjonalnie. Do celów testowych. Jeśli true, żądanie jest weryfikowane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.

Encoding

Opcjonalnie. Wymagane w przypadku przesyłania plików UserData. Typ kodowania identyfikatorów użytkowników. W przypadku zaszyfrowanych identyfikatorów użytkowników jest to typ kodowania zaszyfrowanego ciągu znaków. W przypadku zaszyfrowanych identyfikatorów użytkowników z wartością hash jest to typ kodowania zewnętrznego zaszyfrowanego ciągu znaków, ale niekoniecznie wewnętrznego ciągu znaków z wartością hash. Oznacza to, że wewnętrzny ciąg znaków z wartością hash może być zakodowany w inny sposób niż zewnętrzny zaszyfrowany ciąg znaków. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.

EncryptionInfo

Opcjonalnie. Informacje o szyfrowaniu przesyłanych plików w UserData. Jeśli nie jest ustawiona, zakłada się, że przesłane informacje umożliwiające identyfikację są zahaszowane, ale nie zaszyfrowane. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.

string

Automatycznie wygenerowany identyfikator żądania.

UploadKeyType

Wymagane. Niezmienna. Typy kluczy przesyłania tej listy użytkowników.

ContactIdInfo

Opcjonalnie. Dodatkowe informacje, gdy CONTACT_ID jest jednym z upload_key_types.

MobileIdInfo

Opcjonalnie. Dodatkowe informacje, gdy MOBILE_ID jest jednym z upload_key_types.

UserIdInfo

Opcjonalnie. Dodatkowe informacje, gdy USER_ID jest jednym z upload_key_types.

PairIdInfo

Opcjonalnie. Dodatkowe informacje, gdy PAIR_ID jest jednym z upload_key_types.

Ta funkcja jest dostępna tylko dla partnerów danych.

PseudonymousIdInfo

Opcjonalnie. Dodatkowe informacje o PSEUDONYMOUS_ID to jeden z upload_key_types.

PartnerAudienceInfo

Opcjonalnie. Dodatkowe informacje o odbiorcach partnerów.

Ta funkcja jest dostępna tylko dla partnerów danych.

string

Opcjonalnie. Identyfikator produktu na koncie Merchant Center.

int64

Opcjonalnie. Liczba tego produktu powiązanego ze zdarzeniem.

double

Opcjonalnie. Cena jednostkowa bez podatku, dostawy i wszelkich rabatów na poziomie transakcji.

string

Opcjonalnie. Unikalny identyfikator, który umożliwia odwoływanie się do elementu.

ItemParameter

Opcjonalnie. Zbiór parametrów zdarzenia związanych z produktem, które mają być uwzględnione w zdarzeniu, a nie zostały jeszcze określone za pomocą innych pól strukturalnych.

string

Wymagane. Nazwa parametru do użycia.

string

Wymagane. Ciąg znaków reprezentujący wartość parametru do ustawienia.

string

Wymagane. Konto, którego licencji dotyczy zapytanie. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

string

Opcjonalnie. Filtry do zastosowania w przypadku żądania listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123).

Obsługiwane operacje:

• AND
• =
• !=
• >
• >=
• <
• <=

Nieobsługiwane pola:

• name (zamiast tego użyj metody GET)
• historical_pricings i wszystkie jego pola podrzędne.
• pricing.start_time
• pricing.end_time

int32

Opcjonalnie. Maksymalna liczba licencji do zwrócenia na stronie. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 50 licencji. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną przekształcone w 1000.

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListUserListDirectLicense. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListUserListDirectLicense muszą być zgodne z wywołaniem, które dostarczyło token strony.

UserListDirectLicense

Licencje dla danej listy użytkowników w żądaniu.

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

string

Wymagane. Licencja globalna, której dotyczy zapytanie o informacje o kliencie. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Aby wyświetlić wszystkie informacje o klientach z globalną licencją na koncie, zastąp identyfikator globalnej licencji użytkownika znakiem „-” (np. accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

string

Opcjonalnie. Filtry do zastosowania w przypadku żądania listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123).

Obsługiwane operacje:

• AND
• =
• !=
• >
• >=
• <
• <=

Nieobsługiwane pola:

• name (zamiast tego użyj metody GET)
• historical_pricings i wszystkie jego pola podrzędne.
• pricing.start_time
• pricing.end_time

int32

Opcjonalnie. Maksymalna liczba licencji do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 50 licencji. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną przekształcone w 1000.

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListUserListDirectLicense. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListUserListDirectLicense muszą być zgodne z wywołaniem, które dostarczyło token strony.

UserListGlobalLicenseCustomerInfo

Informacje o kliencie dotyczące danej licencji w żądaniu.

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

string

Wymagane. Konto, którego licencji dotyczy zapytanie. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

string

Opcjonalnie. Filtry do zastosowania w przypadku żądania listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123).

Obsługiwane operacje:

• AND
• =
• !=
• >
• >=
• <
• <=

Nieobsługiwane pola:

• name (zamiast tego użyj metody GET)
• historical_pricings i wszystkie jego pola podrzędne.
• pricing.start_time
• pricing.end_time

int32

Opcjonalnie. Maksymalna liczba licencji do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 50 licencji. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną przekształcone w 1000.

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListUserListGlobalLicense. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListUserListDirectLicense muszą być zgodne z wywołaniem, które dostarczyło token strony.

UserListGlobalLicense

Licencje dla danej listy użytkowników w żądaniu.

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

string

Wymagane. Konto nadrzędne, do którego należy ta kolekcja list użytkowników. Format: accountTypes/{account_type}/accounts/{account}

int32

Opcjonalnie. Maksymalna liczba list użytkowników do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie zostanie podana, zwracanych będzie co najwyżej 50 list użytkowników. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną przekształcone w 1000.

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListUserLists. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListUserLists muszą być zgodne z wywołaniem, które dostarczyło token strony.

string

Opcjonalnie. Ciąg znaków filtra. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. display_name = "list 1").

Obsługiwane operacje:

• AND
• =
• !=
• >
• >=
• <
• <=
• : (ma)

Obsługiwane pola:

• id
• display_name
• description
• membership_status
• integration_code
• access_reason
• ingested_user_list_info.upload_key_types

UserList

Listy użytkowników z określonego konta.

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

string

Wymagane. Lista identyfikatorów urządzeń mobilnych (identyfikatorów wyświetlania reklam lub IDFA). W jednym elemencie AudienceMember można podać maksymalnie 10 elementów mobileIds.

DataSourceType

Opcjonalnie. Niezmienna. Źródło przesyłanych danych.

KeySpace

Wymagane. Niezmienna. Przestrzeń kluczy identyfikatorów mobilnych.

string

Wymagane. Niezmienna. Ciąg znaków, który w niepowtarzalny sposób identyfikuje aplikację mobilną, z której zebrano dane.

string

Wymagane. Dane umożliwiające identyfikację dostarczone przez usługę data clean room, zaszyfrowane algorytmem SHA256 i szyfrem przemiennym EC przy użyciu klucza wydawcy na potrzeby listy użytkowników PAIR. W jednym elemencie AudienceMember można podać maksymalnie 10 elementów pairIds.

int32

Tylko dane wyjściowe. To pole oznacza odsetek dopasowania członkostwa na tej liście użytkowników do odpowiednich danych własnych wydawcy. Musi mieścić się w zakresie od 0 do 100 włącznie.

int64

Tylko dane wyjściowe. Liczba rekordów danych własnych reklamodawcy, które zostały przesłane do dostawcy usługi data clean room. Nie oznacza to rozmiaru listy użytkowników PAIR.

int64

Wymagane. Niezmienna. Określa wydawcę, z którym dopasowywana jest lista odbiorców Dopasowywania danych o tożsamości użytkowników (PAIR). To pole jest dostarczane przez dostawcę usługi clean room i jest unikalne tylko w ramach tej usługi. Nie można go używać jako identyfikatora globalnego w wielu pomieszczeniach typu cleanroom.

string

Opcjonalnie. Opisowa nazwa wydawcy, która będzie wyświetlana w interfejsie, aby zapewnić lepsze kierowanie.

string

Wymagane. Niezmienna. Identyfikuje unikalną relację między reklamodawcą a wydawcą w przypadku jednego lub wielu dostawców usług data clean room.

PartnerAudienceSource

Wymagane. Niezmienna. Źródło danych o odbiorcach partnera.

string

Opcjonalnie. Nazwa partnera handlowego. Dozwolone tylko wtedy, gdy partner_audience_source ma wartość COMMERCE_AUDIENCE.

string

Identyfikator. Nazwa linku partnerskiego. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

string

Tylko dane wyjściowe. Identyfikator linku partnera.

ProductAccount

Wymagane. Konto, które jest właścicielem konta partnera i przyznaje mu dostęp.

ProductAccount

Wymagane. Konto partnera, któremu konto będące właścicielem przyznało dostęp.

string

Wymagane. Lista identyfikatorów podawanych przez wydawców dla użytkownika.

Product

Rola wycofana. Zamiast niej używaj zasady account_type.

string

Wymagane. Identyfikator konta. Na przykład identyfikator konta Google Ads.

AccountType

Opcjonalnie. Typ konta. Na przykład: GOOGLE_ADS. Wymagana jest właściwość account_type lub wycofana właściwość product. Jeśli oba są ustawione, wartości muszą być zgodne.

SyncStatus

Tylko dane wyjściowe. Stan synchronizacji listy użytkowników.

int64

Opcjonalnie. Niezmienna. Liczba rekordów podlegających rozliczeniu (np. przesłanych lub dopasowanych).

Destination

Wymagane. Lista miejsc docelowych, z których chcesz usunąć użytkowników.

AudienceMember

Wymagane. Lista użytkowników do usunięcia.

bool

Opcjonalnie. Do celów testowych. Jeśli true, żądanie jest weryfikowane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.

Encoding

Opcjonalnie. Wymagane w przypadku przesyłania plików UserData. Typ kodowania identyfikatorów użytkowników. Dotyczy tylko zewnętrznego kodowania zaszyfrowanych identyfikatorów użytkowników. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.

EncryptionInfo

Opcjonalnie. Informacje o szyfrowaniu przesyłanych plików w UserData. Jeśli nie jest ustawiona, zakłada się, że przesłane informacje umożliwiające identyfikację są zahaszowane, ale nie zaszyfrowane. W przypadku przesyłania plików innych niż UserData to pole jest ignorowane.

string

Automatycznie wygenerowany identyfikator żądania.

Destination

Miejsce docelowe w żądaniu do interfejsu DM API.

RequestStatus

Stan prośby o miejsce docelowe.

ErrorInfo

Informacje o błędzie zawierające przyczynę błędu i liczbę błędów związanych z przesyłaniem.

WarningInfo

Informacje ostrzegawcze zawierające powód ostrzeżenia i liczbę ostrzeżeń związanych z przesłanym plikiem.

IngestAudienceMembersStatus

Stan żądania dotyczącego przesyłania danych o członkach listy odbiorców.

IngestEventsStatus

Stan żądania dotyczącego zdarzeń przesyłanych do systemu.

RemoveAudienceMembersStatus

Stan prośby o usunięcie członków grupy odbiorców.

IngestUserDataStatus

Stan przesyłania danych użytkownika do miejsca docelowego.

IngestMobileDataStatus

Stan przesyłania danych mobilnych do miejsca docelowego.

IngestPairDataStatus

Stan pozyskiwania danych o parach w miejscu docelowym.

IngestUserIdDataStatus

Stan pozyskiwania danych identyfikatora użytkownika w miejscu docelowym.

IngestPpidDataStatus

Stan pozyskiwania danych PPID w miejscu docelowym.

int64

Łączna liczba zdarzeń wysłanych w żądaniu przesyłania. Obejmuje wszystkie zdarzenia w żądaniu, niezależnie od tego, czy zostały przetworzone.

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali oni prawidłowo przetworzeni.

int64

Łączna liczba identyfikatorów urządzeń mobilnych wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory mobilne w żądaniu, niezależnie od tego, czy zostały przetworzone.

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni prawidłowo przetworzeni.

int64

Łączna liczba identyfikatorów par wysłanych w żądaniu przesłania do miejsca docelowego. Obejmuje wszystkie identyfikatory par w żądaniu, niezależnie od tego, czy zostały przetworzone.

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni prawidłowo przetworzeni.

int64

Łączna liczba identyfikatorów PPID wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory PPID w żądaniu, niezależnie od tego, czy zostały przetworzone.

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni prawidłowo przetworzeni.

int64

Łączna liczba identyfikatorów użytkowników wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory użytkowników w żądaniu, niezależnie od tego, czy zostały one przetworzone.

MatchRateRange

Zakres współczynnika dopasowania przesyłanych danych.

int64

Łączna liczba odbiorców wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni prawidłowo przetworzeni.

int64

Łączna liczba identyfikatorów użytkowników wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory użytkowników w żądaniu, niezależnie od tego, czy zostały one przetworzone.

RemoveUserDataStatus

Stan usuwania danych użytkownika z miejsca docelowego.

RemoveMobileDataStatus

Stan usunięcia danych mobilnych z miejsca docelowego.

RemovePairDataStatus

Stan usunięcia danych z miejsca docelowego.

RemoveUserIdDataStatus

Stan usuwania danych identyfikatora użytkownika z miejsca docelowego.

RemovePpidDataStatus

Stan usunięcia danych ppid z miejsca docelowego.

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci.

int64

Łączna liczba identyfikatorów mobilnych przesłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory mobilne w żądaniu, niezależnie od tego, czy zostały usunięte.

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci.

int64

Łączna liczba identyfikatorów par wysłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory par w żądaniu, niezależnie od tego, czy zostały usunięte.

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci.

int64

Łączna liczba identyfikatorów PPID przesłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory PPID w żądaniu, niezależnie od tego, czy zostały usunięte.

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci.

int64

Łączna liczba identyfikatorów użytkowników przesłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory użytkowników w żądaniu, niezależnie od tego, czy zostały one usunięte.

int64

Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich członków grupy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci.

int64

Łączna liczba identyfikatorów użytkowników przesłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory użytkowników w żądaniu, niezależnie od tego, czy zostały one usunięte.

string

Wymagane. Konto nadrzędne, do którego należy lista użytkowników. Format: accountTypes/{account_type}/accounts/{account}

Baseline

Wymagane. Wartość bazowa dla żądanych statystyk.

string

Wymagane. Identyfikator listy użytkowników, dla której wysyłana jest prośba o statystyki.

MarketingDataInsight

Zawiera statystyki dotyczące danych marketingowych.

AudienceInsightsDimension

Wymiar, do którego należy statystyka.

MarketingDataInsightsAttribute

Statystyki dotyczące wartości danego wymiaru.

int64

Identyfikator zainteresowania użytkownika.

float

Miara wzrostu, jaki odbiorcy uzyskali w przypadku wartości atrybutu w porównaniu z wartością bazową. Zakres [0–1].

AgeRange

Przedział wiekowy odbiorców, dla których podany jest wzrost.

Gender

Płeć odbiorców, dla których podano wzrost.

string

Wymagane. Wymagane. Identyfikator żądania do interfejsu Data Manager API.

RequestStatusPerDestination

Lista stanów żądań dla każdego miejsca docelowego. Kolejność stanów odpowiada kolejności miejsc docelowych w pierwotnym żądaniu.

string

Wymagane. Konto, na którym chcesz wyszukać linki partnerów. Jeśli nie podasz wartości filter, zwrócimy wszystkie linki partnerskie, w których to konto jest owning_account lub partner_account.

Format: accountTypes/{account_type}/accounts/{account}

int32

Maksymalna liczba linków partnerskich do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwracanych będzie maksymalnie 10 linków partnerskich. Maksymalna wartość to 100. Wartości powyżej 100 zostaną przekształcone w 100.

string

Token strony otrzymany z poprzedniego wywołania SearchPartnerLinks. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji SearchPartnerLinks muszą być zgodne z wywołaniem, które dostarczyło token strony.

string

Opcjonalnie. Ciąg znaków filtra. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. partner_link_id = 123456789).

Obsługiwane operacje:

• AND
• =
• !=

Obsługiwane pola:

• partner_link_id
• owning_account.account_type
• owning_account.account_id
• partner_account.account_type
• partner_account.account_id

Przykład: owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = 987654321

PartnerLink

Linki partnera do danego konta.

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

int64

Tylko dane wyjściowe. Szacunkowa liczba użytkowników na tej liście w sieci reklamowej Google.

int64

Tylko dane wyjściowe. Szacunkowa liczba członków tej listy użytkowników w domenie google.com. Są to elementy dostępne do kierowania w kampaniach w sieci wyszukiwania.

bool

Tylko dane wyjściowe. Wskazuje, że ta lista użytkowników kwalifikuje się do użycia w sieci reklamowej Google.

bool

Opcjonalnie. Wskazuje, czy ta lista użytkowników kwalifikuje się do korzystania z sieci wyszukiwania Google.

TermsOfServiceStatus

Opcjonalnie. Warunki korzystania z usługi kierowania na listę klientów: https://support.google.com/adspolicy/answer/6299717. Musisz zaakceptować te warunki, gdy przesyłasz dane UserData lub MobileData. To pole nie jest wymagane w przypadku listy użytkowników kierowania na listę klientów partnera.

UserListDirectLicense

Wymagane. Pole name licencji służy do identyfikowania licencji, która ma zostać zaktualizowana.

FieldMask

Opcjonalnie. Lista pól do zaktualizowania. Znak specjalny * nie jest obsługiwany i w przypadku jego użycia zostanie zgłoszony błąd INVALID_UPDATE_MASK.

UserListGlobalLicense

Wymagane. Pole name licencji służy do identyfikowania licencji, która ma zostać zaktualizowana.

FieldMask

Opcjonalnie. Lista pól do zaktualizowania. Znak specjalny * nie jest obsługiwany i w przypadku jego użycia zostanie zgłoszony błąd INVALID_UPDATE_MASK.

UserList

Wymagane. Lista użytkowników do zaktualizowania.

Pole name listy użytkowników służy do identyfikowania listy użytkowników, która ma zostać zaktualizowana. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

FieldMask

Opcjonalnie. Lista pól do zaktualizowania.

bool

Opcjonalnie. Jeśli wartość to „prawda”, żądanie jest weryfikowane, ale nie wykonywane.

UserIdentifier

Wymagane. Identyfikatory użytkownika. Możesz podać wiele wystąpień tego samego typu danych (np. wiele adresów e-mail). Aby zwiększyć prawdopodobieństwo dopasowania, podaj jak najwięcej identyfikatorów. W jednym pliku AudienceMember lub Event można podać maksymalnie 10 wartości userIdentifiers.

string

Wymagane. Unikalny identyfikator użytkownika zdefiniowany przez reklamodawcę.

DataSourceType

Opcjonalnie. Niezmienna. Źródło przesyłanych danych.

string

Zahaszowany adres e-mail za pomocą funkcji SHA-256 po normalizacji.

string

Zahaszowany numer telefonu za pomocą funkcji SHA-256 po normalizacji (standard E164).

AddressInfo

Znane elementy adresu użytkownika. Zawiera grupę identyfikatorów, które są dopasowywane jednocześnie.

string

Identyfikator. Nazwa zasobu listy użytkowników. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

int64

Tylko dane wyjściowe. Unikalny identyfikator listy użytkowników.

bool

Tylko dane wyjściowe. Opcja, która określa, czy użytkownik może edytować listę.

Duration

Opcjonalnie. Okres, przez jaki użytkownik pozostaje na liście użytkowników. Prawidłowe okresy trwania to dokładne wielokrotności 24 godzin (86 400 sekund). Podanie wartości, która nie jest dokładną wielokrotnością 24 godzin, spowoduje błąd INVALID_ARGUMENT.

AccessReason

Tylko dane wyjściowe. Powód, dla którego to konto ma dostęp do listy.

SizeInfo

Tylko dane wyjściowe. Szacunkowa liczba użytkowników na tej liście w różnych sieciach docelowych.

TargetNetworkInfo

Opcjonalnie. Informacje o kwalifikowaniu się do różnych sieci docelowych.

string

Wymagane. Wyświetlana nazwa listy użytkowników.

string

Opcjonalnie. Opis listy użytkowników.

MembershipStatus

Opcjonalnie. Stan członkostwa na tej liście użytkowników.

string

Opcjonalnie. Identyfikator z systemu zewnętrznego. Jest on używany przez sprzedawców list użytkowników do korelowania identyfikatorów w ich systemach.

ClosingReason

Tylko dane wyjściowe. Powód zamknięcia stanu członkostwa na liście użytkowników.

AccessStatus

Opcjonalnie. Wskazuje, czy udostępnianie jest nadal włączone. Gdy lista użytkowników jest udostępniana kontu, to pole ma wartość ENABLED. Właściciel listy użytkowników może później cofnąć udostępnianie i ustawić je jako DISABLED.

IngestedUserListInfo

Opcjonalnie. Reprezentuje listę użytkowników wypełnianą na podstawie danych przesłanych przez użytkowników.

string

Identyfikator. Nazwa zasobu licencji bezpośredniej listy użytkowników.

string

Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja.

To pole jest tylko do odczytu.

string

Tylko dane wyjściowe. Nazwa klienta, któremu licencjonowana jest lista użytkowników.

To pole jest tylko do odczytu.

UserListLicensePricing

Opcjonalnie. Ceny UserListDirectLicense.

UserListLicensePricing

Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników.

To pole jest tylko do odczytu.

UserListLicenseMetrics

Tylko dane wyjściowe. Dane związane z tą licencją

To pole jest tylko do odczytu i jest wypełniane tylko wtedy, gdy daty rozpoczęcia i zakończenia są ustawione w wywołaniu ListUserListDirectLicenses.

int64

Niezmienna. Identyfikator listy użytkowników, na którą przyznawana jest licencja.

UserListLicenseClientAccountType

Niezmienna. Typ konta klienta, na które licencjonowana jest lista użytkowników.

int64

Niezmienna. Identyfikator klienta, któremu licencjonowana jest lista użytkowników.

UserListLicenseStatus

Opcjonalnie. Stan UserListDirectLicense – ENABLED lub DISABLED.

string

Identyfikator. Nazwa zasobu globalnej licencji na listę użytkowników.

string

Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja.

To pole jest tylko do odczytu.

UserListLicensePricing

Opcjonalnie. Ceny UserListGlobalLicense.

UserListLicensePricing

Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników.

To pole jest tylko do odczytu.

UserListLicenseMetrics

Tylko dane wyjściowe. Dane związane z tą licencją

To pole jest tylko do odczytu i jest wypełniane tylko wtedy, gdy daty rozpoczęcia i zakończenia są ustawione w wywołaniu ListUserListGlobalLicenses.

int64

Niezmienna. Identyfikator listy użytkowników, na którą przyznawana jest licencja.

UserListGlobalLicenseType

Niezmienna. Typ usługi klienta, do której licencjonowana jest lista użytkowników.

UserListLicenseStatus

Opcjonalnie. Stan UserListGlobalLicense – WŁĄCZONA lub WYŁĄCZONA.

string

Identyfikator. Nazwa zasobu klienta z globalną licencją na listę użytkowników.

int64

Tylko dane wyjściowe. Identyfikator listy użytkowników, na którą przyznawana jest licencja.

string

Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja.

UserListGlobalLicenseType

Tylko dane wyjściowe. Typ usługi klienta, do której licencjonowana jest lista użytkowników.

UserListLicenseStatus

Tylko dane wyjściowe. Stan UserListDirectLicense – ENABLED lub DISABLED.

UserListLicensePricing

Tylko dane wyjściowe. Ceny UserListDirectLicense.

UserListLicenseClientAccountType

Tylko dane wyjściowe. Typ usługi klienta, do której licencjonowana jest lista użytkowników.

int64

Tylko dane wyjściowe. Identyfikator klienta, któremu licencjonowana jest lista użytkowników.

string

Tylko dane wyjściowe. Nazwa klienta, któremu licencjonowana jest lista użytkowników.

UserListLicensePricing

Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników.

UserListLicenseMetrics

Tylko dane wyjściowe. Dane związane z tą licencją

To pole jest wypełniane tylko wtedy, gdy daty rozpoczęcia i zakończenia są ustawione w wywołaniu ListUserListGlobalLicenseCustomerInfos.

int64

Tylko dane wyjściowe. Liczba kliknięć w przypadku licencji na listę użytkowników.

int64

Tylko dane wyjściowe. Liczba wyświetleń licencji na listę użytkowników.

int64

Tylko dane wyjściowe. Przychody z licencji na listę użytkowników w milionowych częściach jednostki.

int64

Tylko dane wyjściowe. Data rozpoczęcia (włącznie) danych w formacie RRRRMMDD. Na przykład 20260102 oznacza 2 stycznia 2026 r. Jeśli w filtrze używana jest właściwość end_date, wymagana jest też właściwość start_date. Jeśli w filtrze nie ma ani start_date, ani end_date, pola UserListLicenseMetrics nie zostaną wypełnione w odpowiedzi.

int64

Tylko dane wyjściowe. Data zakończenia (włącznie) danych w formacie RRRRMMDD. Na przykład 20260102 oznacza 2 stycznia 2026 r. Jeśli w filtrze używana jest właściwość start_date, wymagana jest też właściwość end_date. Jeśli w filtrze nie ma ani start_date, ani end_date, pola UserListLicenseMetrics nie zostaną wypełnione w odpowiedzi.

int64

Tylko dane wyjściowe. Identyfikator tego cennika.

Timestamp

Tylko dane wyjściowe. Czas rozpoczęcia obowiązywania ceny.

Timestamp

Opcjonalnie. Czas zakończenia obowiązywania ceny.

bool

Tylko dane wyjściowe. Określa, czy te ceny są aktywne.

UserListPricingBuyerApprovalState

Tylko dane wyjściowe. Stan zatwierdzenia tych cen przez kupującego.

To pole jest tylko do odczytu.

int64

Opcjonalnie. Koszt związany z modelem w mikrojednostkach (10^-6) w walucie określonej w polu currency_code. Na przykład 2000000 oznacza 2 PLN, jeśli currency_code to USD.

string

Opcjonalnie. Waluta, w której określono koszt i maksymalny koszt. Musi to być trzyliterowy kod waluty zdefiniowany w standardzie ISO 4217.

UserListPricingCostType

Niezmienna. Typ kosztów tej ceny.

Można ustawić tylko w operacji create. Nie można go zaktualizować w przypadku istniejącej licencji.

int64

Opcjonalnie. Maksymalny CPM, jaki może zostać naliczony w przypadku odbiorców z list partnerów handlowych, gdy używany jest typ kosztu MEDIA_SHARE. Wartość jest podana w mikrojednostkach (10^-6) i w walucie określonej w polu currency_code. Na przykład 2000000 oznacza 2 PLN, jeśli currency_code to USD.

Ma to znaczenie tylko wtedy, gdy cost_type ma wartość MEDIA_SHARE. Jeśli cost_type nie ma wartości MEDIA_SHARE, a to pole jest ustawione, zwracany jest błąd MAX_COST_NOT_ALLOWED. Jeśli zasada jest nieskonfigurowana lub ma wartość 0, nie ma limitu.

CustomerType

Opcjonalnie. Typ klienta powiązanego ze zdarzeniem.

CustomerValueBucket

Opcjonalnie. Wartość klienta określona przez reklamodawcę.

UserProperty

Opcjonalnie. Zbiór dodatkowych właściwości użytkownika powiązanych z tym zdarzeniem.

string

Wymagane. Nazwa właściwości użytkownika do użycia.

string

Wymagane. Ciąg znaków reprezentujący wartość właściwości użytkownika do użycia.

int64

Liczba rekordów, które zawierają ostrzeżenie.

ProcessingWarningReason

Powód ostrzeżenia.

WarningCount

Lista ostrzeżeń i liczba ostrzeżeń według przyczyny.