Indeks
IngestionService(interfejs)MarketingDataInsightsService(interfejs)PartnerLinkService(interfejs)UserListDirectLicenseService(interfejs)UserListGlobalLicenseService(interfejs)UserListService(interfejs)AdEvent(komunikat)AdEvent.EventSubtype(wyliczenie)AdEvent.EventType(wyliczenie)AdFormat(wyliczenie)AdIdentifiers(komunikat)AdPlacement(wyliczenie)AdType(wyliczenie)AddressInfo(komunikat)AgeRange(wyliczenie)AttributionHint(wyliczenie)AudienceMember(komunikat)AwsWrappedKeyInfo(komunikat)AwsWrappedKeyInfo.KeyType(wyliczenie)Baseline(komunikat)Baseline.Location(komunikat)CartData(komunikat)CompositeData(komunikat)Consent(komunikat)ConsentStatus(wyliczenie)ContactIdInfo(komunikat)CoordinatorKeyInfo(komunikat)CreatePartnerLinkRequest(komunikat)CreateUserListDirectLicenseRequest(komunikat)CreateUserListGlobalLicenseRequest(komunikat)CreateUserListRequest(komunikat)CustomVariable(komunikat)CustomerType(wyliczenie)CustomerValueBucket(wyliczenie)DataSourceType(wyliczenie)DeletePartnerLinkRequest(komunikat)DeleteUserListRequest(komunikat)Destination(komunikat)DeviceInfo(komunikat)Encoding(wyliczenie)EncryptedUserId(komunikat)EncryptedUserId.EncryptionEntityType(wyliczenie)EncryptedUserId.EncryptionSource(wyliczenie)EncryptionInfo(komunikat)ErrorCount(komunikat)ErrorInfo(komunikat)ErrorReason(wyliczenie)Event(komunikat)EventLocation(komunikat)EventParameter(komunikat)EventSource(wyliczenie)ExperimentalField(komunikat)FeatureSet(wyliczenie)GcpWrappedKeyInfo(komunikat)GcpWrappedKeyInfo.KeyType(wyliczenie)Gender(wyliczenie)GetUserListDirectLicenseRequest(komunikat)GetUserListGlobalLicenseRequest(komunikat)GetUserListRequest(komunikat)IngestAdEventsRequest(komunikat)IngestAdEventsResponse(komunikat)IngestAudienceMembersRequest(komunikat)IngestAudienceMembersResponse(komunikat)IngestEventsRequest(komunikat)IngestEventsResponse(komunikat)IngestedUserListInfo(komunikat)IngestedUserListInfo.UploadKeyType(wyliczenie)IpData(komunikat)Item(komunikat)ItemCustomVariable(komunikat)ItemParameter(komunikat)ListUserListDirectLicensesRequest(komunikat)ListUserListDirectLicensesResponse(komunikat)ListUserListGlobalLicenseCustomerInfosRequest(komunikat)ListUserListGlobalLicenseCustomerInfosResponse(komunikat)ListUserListGlobalLicensesRequest(komunikat)ListUserListGlobalLicensesResponse(komunikat)ListUserListsRequest(komunikat)ListUserListsResponse(komunikat)MatchRateRange(wyliczenie)MediaQuartile(wyliczenie)MobileData(komunikat)MobileIdInfo(komunikat)MobileIdInfo.KeySpace(wyliczenie)PairData(komunikat)PairIdInfo(komunikat)PartnerAudienceInfo(komunikat)PartnerAudienceInfo.PartnerAudienceSource(wyliczenie)PartnerCustomerAccount(komunikat)PartnerLink(komunikat)PartnerLinkMetadata(komunikat)Platform(wyliczenie)PlatformType(wyliczenie)PpidData(komunikat)ProcessingErrorReason(wyliczenie)ProcessingWarningReason(wyliczenie)Product(enum) (wycofane)ProductAccount(komunikat)ProductAccount.AccountType(wyliczenie)PseudonymousIdInfo(komunikat)PseudonymousIdInfo.SyncStatus(wyliczenie)RemoveAudienceMembersRequest(komunikat)RemoveAudienceMembersResponse(komunikat)RequestStatusPerDestination(komunikat)RequestStatusPerDestination.DataType(wyliczenie)RequestStatusPerDestination.DataTypeCount(komunikat)RequestStatusPerDestination.IngestAudienceMembersStatus(komunikat)RequestStatusPerDestination.IngestCompositeDataStatus(komunikat)RequestStatusPerDestination.IngestEventsStatus(komunikat)RequestStatusPerDestination.IngestMobileDataStatus(komunikat)RequestStatusPerDestination.IngestPairDataStatus(komunikat)RequestStatusPerDestination.IngestPpidDataStatus(komunikat)RequestStatusPerDestination.IngestUserDataStatus(komunikat)RequestStatusPerDestination.IngestUserIdDataStatus(komunikat)RequestStatusPerDestination.RemoveAudienceMembersStatus(komunikat)RequestStatusPerDestination.RemoveCompositeDataStatus(komunikat)RequestStatusPerDestination.RemoveMobileDataStatus(komunikat)RequestStatusPerDestination.RemovePairDataStatus(komunikat)RequestStatusPerDestination.RemovePpidDataStatus(komunikat)RequestStatusPerDestination.RemoveUserDataStatus(komunikat)RequestStatusPerDestination.RemoveUserIdDataStatus(komunikat)RequestStatusPerDestination.RequestStatus(wyliczenie)RetrieveInsightsRequest(komunikat)RetrieveInsightsResponse(komunikat)RetrieveInsightsResponse.MarketingDataInsight(komunikat)RetrieveInsightsResponse.MarketingDataInsight.AudienceInsightsDimension(wyliczenie)RetrieveInsightsResponse.MarketingDataInsight.MarketingDataInsightsAttribute(komunikat)RetrieveRequestStatusRequest(komunikat)RetrieveRequestStatusResponse(komunikat)SearchPartnerLinksRequest(komunikat)SearchPartnerLinksResponse(komunikat)SizeInfo(komunikat)TargetNetworkInfo(komunikat)TargetingType(wyliczenie)TermsOfService(komunikat)TermsOfServiceStatus(wyliczenie)UpdateUserListDirectLicenseRequest(komunikat)UpdateUserListGlobalLicenseRequest(komunikat)UpdateUserListRequest(komunikat)UserData(komunikat)UserIdData(komunikat)UserIdInfo(komunikat)UserIdentifier(komunikat)UserList(komunikat)UserList.AccessReason(wyliczenie)UserList.AccessStatus(wyliczenie)UserList.ClosingReason(wyliczenie)UserList.MembershipStatus(wyliczenie)UserListDirectLicense(komunikat)UserListGlobalLicense(komunikat)UserListGlobalLicenseCustomerInfo(komunikat)UserListGlobalLicenseType(wyliczenie)UserListLicenseClientAccountType(wyliczenie)UserListLicenseMetrics(komunikat)UserListLicensePricing(komunikat)UserListLicensePricing.UserListPricingBuyerApprovalState(wyliczenie)UserListLicensePricing.UserListPricingCostType(wyliczenie)UserListLicenseStatus(wyliczenie)UserProperties(komunikat)UserProperty(komunikat)ViewType(wyliczenie)ViewabilityInfo(komunikat)WarningCount(komunikat)WarningInfo(komunikat)
IngestionService
Usługa do wysyłania danych o odbiorcach do obsługiwanych miejsc docelowych.
| IngestAdEvents |
|---|
|
Przesyła do Google Analytics listę zasobów Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.
|
| IngestAudienceMembers |
|---|
|
Przesyła listę zasobów
|
| IngestEvents |
|---|
|
Przesyła listę zasobów
|
| RemoveAudienceMembers |
|---|
|
Usuwa listę zasobów
|
| RetrieveRequestStatus |
|---|
|
Pobiera stan żądania na podstawie jego identyfikatora.
|
MarketingDataInsightsService
Usługa zwracająca statystyki dotyczące danych marketingowych.
Ta funkcja jest dostępna tylko dla partnerów danych.
| RetrieveInsights |
|---|
|
Pobiera dane analityczne dotyczące marketingu dla danej listy użytkowników. Ta funkcja jest dostępna tylko dla partnerów danych. Nagłówki autoryzacji: Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:
|
PartnerLinkService
Usługa do zarządzania linkami partnerów.
| CreatePartnerLink |
|---|
|
Tworzy link partnera dla danego konta. Nagłówki autoryzacji: Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:
|
| DeletePartnerLink |
|---|
|
Usuwa link partnera do danego konta. Nagłówki autoryzacji: Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:
|
| SearchPartnerLinks |
|---|
|
Wyszukuje wszystkie połączenia partnerów z danym kontem i do niego. Nagłówki autoryzacji: Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:
|
UserListDirectLicenseService
Usługa do zarządzania licencjami bezpośrednimi na listy użytkowników. Usuwanie nie jest obsługiwaną operacją w przypadku UserListDirectLicenses. Aby dezaktywować licencję, dzwoniący powinni zaktualizować jej stan na WYŁĄCZONA.
Ta funkcja jest dostępna tylko dla partnerów danych.
| CreateUserListDirectLicense |
|---|
|
Tworzy licencję bezpośrednią na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów danych.
|
| GetUserListDirectLicense |
|---|
|
Pobiera licencję bezpośrednią na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów danych.
|
| ListUserListDirectLicenses |
|---|
|
Wyświetla wszystkie licencje bezpośrednie na listy użytkowników należące do konta nadrzędnego. Ta funkcja jest dostępna tylko dla partnerów danych.
|
| UpdateUserListDirectLicense |
|---|
|
Aktualizuje licencję bezpośrednią na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów danych.
|
UserListGlobalLicenseService
Usługa do zarządzania globalnymi licencjami na listy użytkowników. Usuwanie nie jest obsługiwaną operacją w przypadku UserListGlobalLicenses. Aby dezaktywować licencję, dzwoniący powinni zaktualizować jej stan na WYŁĄCZONA.
Ta funkcja jest dostępna tylko dla partnerów danych.
| CreateUserListGlobalLicense |
|---|
|
Tworzy globalną licencję na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów danych.
|
| GetUserListGlobalLicense |
|---|
|
Pobiera globalną licencję na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów danych.
|
| ListUserListGlobalLicenseCustomerInfos |
|---|
|
Zawiera wszystkie informacje o klientach na potrzeby globalnej licencji na listę klientów. Ta funkcja jest dostępna tylko dla partnerów danych.
|
| ListUserListGlobalLicenses |
|---|
|
Wyświetla wszystkie globalne licencje na listy użytkowników należące do konta nadrzędnego. Ta funkcja jest dostępna tylko dla partnerów danych.
|
| UpdateUserListGlobalLicense |
|---|
|
Aktualizuje globalną licencję na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów danych.
|
UserListService
Usługa do zarządzania zasobami UserList.
| CreateUserList |
|---|
|
Tworzy listę użytkowników. Nagłówki autoryzacji: Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:
|
| DeleteUserList |
|---|
|
Usuwa listę użytkowników. Nagłówki autoryzacji: Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:
|
| GetUserList |
|---|
|
Pobiera listę użytkowników. Nagłówki autoryzacji: Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:
|
| ListUserLists |
|---|
|
Wyświetla listę UserLists. Nagłówki autoryzacji: Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:
|
| UpdateUserList |
|---|
|
Aktualizuje listę użytkowników. Nagłówki autoryzacji: Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:
|
AdEvent
Zdarzenie reklamowe.
| Pola | |
|---|---|
advertiser_id |
Wymagane. Identyfikator reklamodawcy w przypadku zdarzenia reklamowego. Musi on być zgodny z identyfikatorem wysłanym w procesie łączenia. |
event_type |
Wymagane. Typ zdarzenia. |
timestamp |
Wymagane. Czas wystąpienia zdarzenia. |
event_id |
Opcjonalnie. Identyfikator utworzony i zarządzany przez wywołującego, który jednoznacznie identyfikuje to zdarzenie. Wymagany, jeśli chcesz usuwać duplikaty zdarzeń związanych z reklamami, które są uwzględnione w wielu żądaniach. W przeciwnym razie to pole jest opcjonalne. |
user_data |
Opcjonalnie. Wiele rodzajów danych przekazywanych przez użytkowników, które reprezentują użytkownika powiązanego ze zdarzeniem. Możesz podać wiele instancji tego samego typu danych (np. adres e-mail). Im więcej danych podasz, tym większe prawdopodobieństwo, że znajdziemy dopasowanie. |
device_info |
Opcjonalnie. Informacje zebrane o urządzeniu używanym w momencie wystąpienia zdarzenia reklamowego. |
mobile_device_id |
Opcjonalnie. Identyfikator urządzenia, na którym wyświetlono reklamę. |
campaign_id |
Wymagane. Identyfikator powiązanej kampanii. |
campaign_name |
Wymagane. Nazwa powiązanej kampanii. |
ad_group_id |
Opcjonalnie. Identyfikator powiązanej grupy reklam. |
ad_id |
Opcjonalnie. Identyfikator powiązanej reklamy w grupie. |
ad_height |
Opcjonalnie. Wysokość reklamy w pikselach. |
ad_width |
Opcjonalnie. Szerokość reklamy w pikselach. |
region_code |
Wymagane. Kraj i podział podrzędny w formacie ISO 3166-2. |
source |
Wymagane. Źródło platformy reklamy, podobne do źródła Google Analytics. |
medium |
Wymagane. Medium reklamy, podobne do medium w Google Analytics. |
attribution_hint |
Opcjonalnie. Stan atrybucji przyjęty przez partnera w przypadku tego zdarzenia reklamowego. Jest to tylko sygnał informujący o tym, jak partner założył, że przebiegała atrybucja. Nie wymusza on ostatecznego wyniku w raportach końcowych. |
viewability_info |
Wymagane. Szczegóły widoczności wyświetlonej reklamy. |
Pole zbiorcze Akceptowany jest ciąg znaków w formacie surowym, aby obsługiwać wartości inne niż czyste wyliczenia. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
event_subtype |
Wartość wyliczeniowa podtypu zdarzenia. |
event_subtype_string |
Wartość ciągu podtypu zdarzenia. |
Pole zbiorcze Akceptowany jest ciąg znaków w formacie surowym, aby obsługiwać wartości inne niż czyste wyliczenia. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
ad_type |
Wartość typu wyliczeniowego dla typu reklamy. |
ad_type_string |
Wartość ciągu znaków typu reklamy. |
Pole zbiorcze Akceptowany jest ciąg znaków w formacie surowym, aby obsługiwać wartości inne niż czyste wyliczenia. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
ad_format |
Wartość typu wyliczeniowego formatu reklamy. |
ad_format_string |
Wartość ciągu znaków formatu reklamy. |
Pole zbiorcze Akceptowany jest ciąg znaków w formacie surowym, aby obsługiwać wartości inne niż czyste wyliczenia. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
ad_placement |
Wartość wyliczeniowa miejsca docelowego reklamy. |
ad_placement_string |
Wartość ciągu znaków dla miejsca docelowego reklamy. |
Pole zbiorcze Akceptowany jest ciąg znaków w formacie surowym, aby obsługiwać wartości inne niż czyste wyliczenia. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
targeting_type |
Wartość typu wyliczeniowego dla typu kierowania. |
targeting_type_string |
Wartość ciągu znaków dla typu kierowania. |
Pole zbiorcze Akceptowany jest ciąg znaków w formacie surowym, aby obsługiwać wartości inne niż czyste wyliczenia. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
platform_type |
Wartość typu wyliczeniowego dla typu platformy. |
platform_type_string |
Wartość ciągu znaków dla typu platformy. |
Pole zbiorcze Akceptowany jest ciąg znaków w formacie surowym, aby obsługiwać wartości inne niż czyste wyliczenia. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
platform |
Wartość wyliczeniowa platformy. |
platform_string |
Wartość ciągu znaków dla platformy. |
measurement_allowed |
Opcjonalnie. Określa, czy wiersz może być używany do celów pomiarowych zgodnie z obowiązującymi przepisami dotyczącymi ochrony prywatności w danym regionie. |
EventSubtype
Dodatkowa klasyfikacja typu zdarzenia reklamowego.
| Wartości w polu enum | |
|---|---|
EVENT_SUBTYPE_UNSPECIFIED |
Nieokreślony podtyp zdarzenia. |
EVENT_SUBTYPE_IMPRESSION |
Zdarzenie wyświetlenia. |
EVENT_SUBTYPE_ENGAGED_VIEW |
Zdarzenie wyświetlenia angażującego. |
EVENT_SUBTYPE_ONSITE_CLICK |
Zdarzenie kliknięcia w witrynie. |
EVENT_SUBTYPE_OUTBOUND_CLICK |
Zdarzenie kliknięcia wychodzącego. |
EventType
Typ zdarzenia.
| Wartości w polu enum | |
|---|---|
EVENT_TYPE_UNSPECIFIED |
Nieokreślony typ zdarzenia. |
EVENT_TYPE_VIEW |
Wyświetl wydarzenie. |
EVENT_TYPE_CLICK |
Zdarzenie kliknięcia. |
AdFormat
Format wyświetlonej reklamy.
| Wartości w polu enum | |
|---|---|
AD_FORMAT_UNSPECIFIED |
Nieokreślony format reklamy. |
AD_FORMAT_AR |
reklama AR, |
AD_FORMAT_AUDIO |
Reklama audio. |
AD_FORMAT_BANNER |
Baner reklamowy. |
AD_FORMAT_BUMPER |
Bumper reklamowy. |
AD_FORMAT_CAROUSEL |
Reklama karuzelowa. |
AD_FORMAT_COLLECTION |
Reklama z kolekcją. |
AD_FORMAT_IMAGE |
Reklama graficzna |
AD_FORMAT_INTERACTIVE |
Reklama interaktywna. |
AD_FORMAT_INTERSTITIAL |
Reklama pełnoekranowa. |
AD_FORMAT_IN_FEED |
Reklama In-Feed. |
AD_FORMAT_IN_STREAM |
Reklama In-Stream. |
AD_FORMAT_IN_STREAM_SKIPPABLE |
Reklama In-Stream możliwa do pominięcia. |
AD_FORMAT_IN_STREAM_NON_SKIPPABLE |
Reklama In-Stream niemożliwa do pominięcia. |
AD_FORMAT_NATIVE |
Reklama natywna. |
AD_FORMAT_SHORTS |
reklamy w Shorts. |
AD_FORMAT_STORY |
Reklama z historyjką. |
AD_FORMAT_SPONSORED |
Reklama sponsorowana. |
AD_FORMAT_VIDEO |
Reklama wideo |
AdIdentifiers
Identyfikatory i inne informacje używane do dopasowywania zdarzenia konwersji do innej aktywności online (np. kliknięć reklam).
| Pola | |
|---|---|
session_attributes |
Opcjonalnie. Atrybuty sesji na potrzeby atrybucji i modelowania zdarzeń. |
gclid |
Opcjonalnie. Identyfikator kliknięcia Google (gclid) powiązany z tym zdarzeniem. |
gbraid |
Opcjonalnie. Identyfikator kliknięcia w przypadku kliknięć powiązanych ze zdarzeniami w aplikacji pochodzącymi z urządzeń z systemem iOS od wersji 14. |
wbraid |
Opcjonalnie. Identyfikator kliknięcia w przypadku kliknięć powiązanych ze zdarzeniami w witrynie pochodzącymi z urządzeń z systemem iOS od wersji 14. |
landing_page_device_info |
Opcjonalnie. Informacje zebrane o używanym urządzeniu (jeśli takie jest) w momencie wejścia do witryny reklamodawcy po interakcji z reklamą. |
mobile_device_id |
Opcjonalnie. Identyfikator wyświetlania reklam mobilnych dla reklamodawców. W przypadku iOS będzie to IDFA, w przypadku Androida – AdID, a w przypadku innych platform – identyfikatory dla reklamodawców. |
dclid |
Opcjonalnie. Identyfikator kliknięcia w reklamie displayowej powiązany z tym zdarzeniem. |
impression_id |
Opcjonalnie. Identyfikator wyświetlenia powiązany z tym zdarzeniem. |
match_id |
Opcjonalnie. Pole identyfikatora dopasowania używane do łączenia tego zdarzenia z poprzednim zdarzeniem. |
encrypted_user_ids[] |
Opcjonalnie. Dowolna liczba zaszyfrowanych identyfikatorów użytkowników. |
AdPlacement
Miejsce docelowe wyświetlonej reklamy.
| Wartości w polu enum | |
|---|---|
AD_PLACEMENT_UNSPECIFIED |
Nieokreślone miejsce docelowe reklamy. |
AD_PLACEMENT_DISCOVER |
Odkrywanie miejsca docelowego. |
AD_PLACEMENT_FEED |
Miejsce docelowe pliku danych. |
AD_PLACEMENT_FOOTER |
Umiejscowienie stopki. |
AD_PLACEMENT_HEADER |
Miejsce docelowe w nagłówku. |
AD_PLACEMENT_HOME |
Miejsce docelowe w usłudze. |
AD_PLACEMENT_IN_CONTENT |
Miejsce docelowe w treści. |
AD_PLACEMENT_PROMOTED |
Promowane miejsce docelowe. |
AD_PLACEMENT_SEARCH |
Miejsce docelowe wyszukiwania. |
AD_PLACEMENT_STORY |
Miejsce docelowe relacji. |
AdType
Typ wyświetlonej reklamy.
| Wartości w polu enum | |
|---|---|
AD_TYPE_UNSPECIFIED |
Nieokreślony typ reklamy. |
AD_TYPE_DISPLAY |
Reklama displayowa. |
AD_TYPE_TEXT |
Reklama tekstowa. |
AD_TYPE_IMAGE |
Reklama graficzna |
AD_TYPE_RICH_MEDIA |
Reklama multimedialna. |
AD_TYPE_HTML |
reklama HTML, |
AD_TYPE_AUDIO |
Reklama audio. |
AD_TYPE_VIDEO |
Reklama wideo |
AddressInfo
Informacje o adresie użytkownika.
| Pola | |
|---|---|
given_name |
Wymagane. Imię użytkownika zapisane małymi literami, bez znaków interpunkcyjnych, bez spacji na początku i na końcu, zahaszowane za pomocą SHA-256. |
family_name |
Wymagane. Nazwisko użytkownika zapisane małymi literami, bez znaków interpunkcyjnych, bez spacji na początku i na końcu, zahaszowane za pomocą algorytmu SHA-256. |
region_code |
Wymagane. Dwuliterowy kod regionu w formacie ISO-3166-1 alpha-2 adresu użytkownika. |
postal_code |
Wymagane. Kod pocztowy w adresie użytkownika. |
ZakresWieku
Przedziały wiekowe grup demograficznych
| Wartości w polu enum | |
|---|---|
AGE_RANGE_UNSPECIFIED |
Nie określono. |
AGE_RANGE_UNKNOWN |
Brak informacji. |
AGE_RANGE_18_24 |
w wieku od 18 do 24 lat, |
AGE_RANGE_25_34 |
w wieku 25–34 lat, |
AGE_RANGE_35_44 |
w wieku 35–44 lat, |
AGE_RANGE_45_54 |
w wieku 45–54 lat, |
AGE_RANGE_55_64 |
55–64 lata |
AGE_RANGE_65_UP |
65 lat i więcej. |
AttributionHint
Stan atrybucji przyjęty przez partnera w przypadku tego zdarzenia reklamowego.
| Wartości w polu enum | |
|---|---|
ATTRIBUTION_HINT_UNSPECIFIED |
Nieznany stan atrybucji. |
ATTRIBUTION_HINT_CONVERTED |
Stan przekształcenia. |
ATTRIBUTION_HINT_NOT_CONVERTED |
Stan „Nie skonwertowano”. |
AudienceMember
Odbiorca, który ma być poddany operacji.
| Pola | |
|---|---|
destination_references[] |
Opcjonalnie. Określa, na którą |
consent |
Opcjonalnie. Ustawienie zgody użytkownika. |
Pole zbiorcze data. Rodzaj danych identyfikacyjnych, na których ma zostać wykonane działanie. data może mieć tylko jedną z tych wartości: |
|
user_data |
Dane przekazywane przez użytkowników, które identyfikują użytkownika. |
pair_data |
Identyfikatory dopasowywania danych o tożsamości użytkowników (PAIR). Ta funkcja jest dostępna tylko dla partnerów danych. |
mobile_data |
dane identyfikujące urządzenia mobilne użytkownika; |
user_id_data |
Dane związane z unikalnymi identyfikatorami użytkownika zdefiniowanymi przez reklamodawcę. |
ppid_data |
Dane związane z identyfikatorami podawanymi przez wydawców. Ta funkcja jest dostępna tylko dla partnerów danych. |
composite_data |
Grupa wielu typów identyfikatorów. |
AwsWrappedKeyInfo
Klucz szyfrowania danych obudowany przez klucz AWS KMS.
| Pola | |
|---|---|
key_type |
Wymagane. Typ algorytmu użytego do zaszyfrowania danych. |
role_arn |
Wymagane. Nazwa zasobu Amazon (ARN) roli uprawnień przyjmowanej na potrzeby dostępu do odszyfrowywania w KMS. Powinien mieć format |
kek_uri |
Wymagane. Identyfikator URI klucza AWS KMS używanego do odszyfrowywania klucza DEK. Powinien mieć format |
encrypted_dek |
Wymagane. Zaszyfrowany klucz szyfrujący dane zakodowany w formacie base64. |
KeyType
Typ algorytmu użytego do zaszyfrowania danych.
| Wartości w polu enum | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Nieokreślony typ klucza. Nigdy nie należy go używać. |
XCHACHA20_POLY1305 |
Algorytm XChaCha20-Poly1305 |
Punkt odniesienia
Kryteria bazowe, z którymi porównywane są statystyki.
| Pola | |
|---|---|
Pole zbiorcze baseline. Lokalizacja odniesienia, z którą porównywane są statystyki. baseline może mieć tylko jedną z tych wartości: |
|
baseline_location |
Lokalizacja bazowa żądania. Lokalizacja bazowa to lista regionów połączonych operatorem LUB. |
location_auto_detection_enabled |
Jeśli ustawisz wartość „true”, usługa spróbuje automatycznie wykryć lokalizację bazową dla statystyk. |
Lokalizacja
Lokalizacja bazowa żądania. Lokalizacja bazowa znajduje się na liście OR kodów regionów w formacie ISO 3166-1 alfa-2 dla żądanych regionów.
| Pola | |
|---|---|
region_codes[] |
Lista kodów regionów w formacie ISO 3166-1 alfa-2. |
CartData
Dane koszyka powiązane ze zdarzeniem.
| Pola | |
|---|---|
merchant_id |
Opcjonalnie. Identyfikator w Merchant Center powiązany z produktami. |
merchant_feed_label |
Opcjonalnie. Etykieta pliku danych Merchant Center powiązana z plikiem danych produktów. |
merchant_feed_language_code |
Opcjonalnie. Kod języka w formacie ISO 639-1 powiązany z plikiem danych Merchant Center, w którym przesyłane są Twoje produkty. |
transaction_discount |
Opcjonalnie. Suma wszystkich rabatów powiązanych z transakcją. |
items[] |
Opcjonalnie. Lista produktów powiązanych ze zdarzeniem. |
coupon_codes[] |
Opcjonalnie. Lista kodów kuponów zastosowanych w koszyku. Kody kuponów na poziomie koszyka i produktu są niezależne od siebie. Jeśli zdarzenie dotyczy miejsca docelowego Google Analytics, podaj tylko jeden kod kuponu. Google Analytics ignoruje dodatkowe kody kuponów. |
CompositeData
Dane złożone zawierające identyfikatory i powiązane dane użytkownika. Trzeba określić co najmniej jedną z tych właściwości: user_data lub ip_data.
| Pola | |
|---|---|
user_data |
Opcjonalnie. Dane przekazywane przez użytkowników, które identyfikują użytkownika. |
ip_data[] |
Opcjonalnie. Dane adresów IP reprezentujące interakcje klientów użyte do utworzenia listy odbiorców. |
Zgoda
Ustawienia zgody użytkownika wymaganej przez akt o rynkach cyfrowych (DMA).
| Pola | |
|---|---|
ad_user_data |
Opcjonalnie. Określa, czy użytkownik wyraża zgodę na korzystanie z danych użytkowników reklam. |
ad_personalization |
Opcjonalnie. Określa, czy użytkownik wyraża zgodę na personalizację reklam. |
ConsentStatus
Wskazuje, czy użytkownik wyraził zgodę, odmówił jej udzielenia czy nie określił swojego stanowiska.
| Wartości w polu enum | |
|---|---|
CONSENT_STATUS_UNSPECIFIED |
Nie określono. |
CONSENT_GRANTED |
Przyznano. |
CONSENT_DENIED |
Odrzucono. |
ContactIdInfo
Dodatkowe informacje, gdy CONTACT_ID jest jednym z upload_key_types.
| Pola | |
|---|---|
match_rate_percentage |
Tylko dane wyjściowe. Współczynnik dopasowania list użytkowników kierowania na listę klientów. |
data_source_type |
Opcjonalnie. Wartość niezmienna. Źródło przesyłanych danych |
CoordinatorKeyInfo
Informacje o kluczu koordynatora.
| Pola | |
|---|---|
key_id |
Wymagane. Identyfikator wybranego klucza koordynatora. |
CreatePartnerLinkRequest
Prośba o utworzenie zasobu PartnerLink. Zwraca wartość PartnerLink.
| Pola | |
|---|---|
parent |
Wymagane. Element nadrzędny, do którego należy ta kolekcja linków partnerskich. Format: accountTypes/{account_type}/accounts/{account} |
partner_link |
Wymagane. Link partnera do utworzenia. |
CreateUserListDirectLicenseRequest
Prośba o utworzenie zasobu UserListDirectLicense.
| Pola | |
|---|---|
parent |
Wymagane. Konto, do którego należy licencjonowana lista użytkowników. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
user_list_direct_license |
Wymagane. Lista użytkowników z bezpośrednią licencją do utworzenia. |
CreateUserListGlobalLicenseRequest
Prośba o utworzenie zasobu UserListGlobalLicense.
| Pola | |
|---|---|
parent |
Wymagane. Konto, do którego należy licencjonowana lista użytkowników. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
user_list_global_license |
Wymagane. Globalna licencja na listę użytkowników do utworzenia. |
CreateUserListRequest
Wiadomość z prośbą o utworzenie listy użytkowników.
| Pola | |
|---|---|
parent |
Wymagane. Konto nadrzędne, na którym zostanie utworzona ta lista użytkowników. Format: accountTypes/{account_type}/accounts/{account} |
user_list |
Wymagane. Lista użytkowników do utworzenia. |
validate_only |
Opcjonalnie. Jeśli wartość to prawda, żądanie jest weryfikowane, ale nie wykonywane. |
Zmienna niestandardowa
Zmienna niestandardowa na potrzeby konwersji z reklam.
| Pola | |
|---|---|
variable |
Opcjonalnie. Nazwa zmiennej niestandardowej do ustawienia. Jeśli zmienna nie zostanie znaleziona w przypadku danego miejsca docelowego, zostanie zignorowana. |
value |
Opcjonalnie. Wartość do zapisania w zmiennej niestandardowej. |
destination_references[] |
Opcjonalnie. Ciąg odniesienia używany do określania, do którego z |
CustomerType
Typ klienta powiązanego ze zdarzeniem.
| Wartości w polu enum | |
|---|---|
CUSTOMER_TYPE_UNSPECIFIED |
Nieokreślony typ klienta. Nigdy nie należy go używać. |
NEW |
klient jest nowy dla reklamodawcy. |
RETURNING |
Klient wraca do reklamodawcy. |
REENGAGED |
Klient ponownie zaangażował się w interakcję z reklamodawcą. |
CustomerValueBucket
Wartość klienta określona przez reklamodawcę.
| Wartości w polu enum | |
|---|---|
CUSTOMER_VALUE_BUCKET_UNSPECIFIED |
Unspecified CustomerValueBucket. Nigdy nie należy go używać. |
LOW |
Klient ma niską wartość. |
MEDIUM |
Klient ma średnią wartość. |
HIGH |
Klient jest wartościowy. |
DataSourceType
Wskazuje źródło danych przesyłanych do Google Ads.
| Wartości w polu enum | |
|---|---|
DATA_SOURCE_TYPE_UNSPECIFIED |
Nie określono. |
DATA_SOURCE_TYPE_FIRST_PARTY |
Przesłane dane to dane własne. |
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU |
Przesłane dane pochodzą z zewnętrznego biura informacji kredytowej. |
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE |
Przesłane dane pochodzą z pliku wyborców innej firmy. |
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA |
Przesłane dane to dane partnera zewnętrznego. |
DeletePartnerLinkRequest
Prośba o usunięcie zasobu PartnerLink. Zwraca wartość google.protobuf.Empty.
| Pola | |
|---|---|
name |
Wymagane. Nazwa zasobu linku partnera do usunięcia. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
DeleteUserListRequest
Komunikat żądania dla funkcji DeleteUserList.
| Pola | |
|---|---|
name |
Wymagane. Nazwa listy użytkowników do usunięcia. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
validate_only |
Opcjonalnie. Jeśli wartość to prawda, żądanie jest weryfikowane, ale nie wykonywane. |
Miejsce docelowe
usługi Google, do której wysyłasz dane; Na przykład konto Google Ads.
| Pola | |
|---|---|
reference |
Opcjonalnie. Identyfikator tego zasobu |
login_account |
Opcjonalnie. Konto użyte do wykonania tego wywołania interfejsu API. Aby dodawać lub usuwać dane z |
linked_account |
Opcjonalnie. Konto, do którego |
operating_account |
Wymagane. Konto, na które mają być wysyłane dane lub z którego mają być usuwane. |
product_destination_id |
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. |
DeviceInfo
Informacje o urządzeniu używanym (jeśli dotyczy) w momencie wystąpienia zdarzenia.
| Pola | |
|---|---|
user_agent |
Opcjonalnie. Ciąg znaków klienta użytkownika urządzenia w danym kontekście. |
ip_address |
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. |
category |
Opcjonalnie. Kategoria urządzenia. Na przykład „komputer”, „tablet”, „komórka”, „telewizor smart TV”. |
language_code |
Opcjonalnie. Język używany przez urządzenie w formacie ISO 639-1. |
screen_height |
Opcjonalnie. Wysokość ekranu w pikselach. |
screen_width |
Opcjonalnie. Szerokość ekranu w pikselach. |
operating_system |
Opcjonalnie. System operacyjny lub platforma urządzenia. |
operating_system_version |
Opcjonalnie. Wersja systemu operacyjnego lub platformy. |
model |
Opcjonalnie. Model urządzenia. |
brand |
Opcjonalnie. Marka urządzenia. |
browser |
Opcjonalnie. Marka lub typ przeglądarki. |
browser_version |
Opcjonalnie. Wersja przeglądarki. |
Kodowanie
Typ kodowania zahaszowanych informacji umożliwiających identyfikację.
| Wartości w polu enum | |
|---|---|
ENCODING_UNSPECIFIED |
Nieokreślony typ kodowania. Nigdy nie należy go używać. |
HEX |
Kodowanie szesnastkowe. |
BASE64 |
kodowanie Base64. |
EncryptedUserId
Identyfikator użytkownika wydany do celów atrybucji. Jeśli używasz tego parametru, wszystkie pola są wymagane.
| Pola | |
|---|---|
encrypted_id |
Wymagane. Alfanumeryczny zaszyfrowany identyfikator. |
entity_type |
Wymagane. Typ jednostki szyfrowania. Powinno to być zgodne z konfiguracją szyfrowania na potrzeby wyświetlania reklam lub przenoszenia danych. |
entity_id |
Wymagane. Identyfikator jednostki szyfrowania. Powinno to być zgodne z konfiguracją szyfrowania na potrzeby wyświetlania reklam lub przenoszenia danych. |
source |
Wymagane. Określa, czy zaszyfrowany plik cookie został otrzymany z wyświetlania reklam (makro %m) czy z przenoszenia danych. |
EncryptionEntityType
Typ jednostki szyfrowania.
| Wartości w polu enum | |
|---|---|
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED |
Nieokreślony typ elementu szyfrowania. |
CAMPAIGN_MANAGER_ACCOUNT |
konto w usłudze Campaign Manager 360; |
CAMPAIGN_MANAGER_ADVERTISER |
reklamodawcą w usłudze Campaign Manager 360. |
DISPLAY_VIDEO_PARTNER |
partnera Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
reklamodawcą Display & Video 360; |
GOOGLE_ADS_CUSTOMER |
klient Google Ads; |
GOOGLE_AD_MANAGER_NETWORK_CODE |
Kod sieci Google Ad Managera. |
EncryptionSource
Źródło szyfrowania.
| Wartości w polu enum | |
|---|---|
ENCRYPTION_SOURCE_UNSPECIFIED |
Nieokreślone źródło szyfrowania. |
AD_SERVING |
Źródło szyfrowania wyświetlania reklam. |
DATA_TRANSFER |
Źródło szyfrowania przesyłania danych. |
EncryptionInfo
Informacje o szyfrowaniu przesyłanych danych.
| Pola | |
|---|---|
Pole zbiorcze wrapped_key. Klucz opakowany użyty do zaszyfrowania danych. wrapped_key może mieć tylko jedną z tych wartości: |
|
gcp_wrapped_key_info |
Informacje o kluczu obudowanym w Google Cloud Platform. |
aws_wrapped_key_info |
Informacje o kluczu obudowanym przez Amazon Web Services. |
coordinator_key_info |
Kluczowe informacje o wybranym kluczu koordynatora. Nie jest to obsługiwane w przypadku metod |
ErrorCount
Liczba błędów dla danej przyczyny błędu.
| Pola | |
|---|---|
record_count |
Liczba rekordów, których nie udało się przesłać z określonego powodu. |
reason |
Przyczyna błędu w przypadku nieudanych rekordów. |
ErrorInfo
Liczba błędów każdego typu.
| Pola | |
|---|---|
error_counts[] |
Lista błędów i liczba błędów według przyczyny. W niektórych przypadkach może nie być wypełniona. |
ErrorReason
Przyczyny błędów interfejsu Data Manager API. UWAGA: ta wyliczeniowa lista stałych nie jest zamrożona i w przyszłości mogą zostać do niej dodane nowe wartości.
| Wartości w polu enum | |
|---|---|
ERROR_REASON_UNSPECIFIED |
Nie używaj tej wartości domyślnej. |
INTERNAL_ERROR |
Wystąpił błąd wewnętrzny. |
DEADLINE_EXCEEDED |
Odpowiedź na żądanie zajęła zbyt dużo czasu. |
RESOURCE_EXHAUSTED |
Zbyt wiele żądań. |
NOT_FOUND |
Nie znaleziono zasobu. |
PERMISSION_DENIED |
Użytkownik nie ma uprawnień lub zasób nie został znaleziony. |
INVALID_ARGUMENT |
Wystąpił problem z żądaniem. |
REQUIRED_FIELD_MISSING |
Wymagane pole jest puste. |
INVALID_FORMAT |
Format jest nieprawidłowy. |
INVALID_HEX_ENCODING |
Wartość zakodowana w formacie szesnastkowym jest nieprawidłowa. |
INVALID_BASE64_ENCODING |
Wartość zakodowana w formacie base64 jest nieprawidłowa. |
INVALID_SHA256_FORMAT |
Wartość zakodowana za pomocą algorytmu SHA256 jest nieprawidłowa. |
INVALID_POSTAL_CODE |
Kod pocztowy jest nieprawidłowy. |
INVALID_COUNTRY_CODE |
Wycofano: wyliczenie nie jest używane w interfejsie Data Manager API. |
INVALID_ENUM_VALUE |
Nie można użyć wartości typu wyliczeniowego. |
INVALID_USER_LIST_TYPE |
Typ listy użytkowników nie ma zastosowania do tego żądania. |
INVALID_AUDIENCE_MEMBER |
Ten odbiorca jest nieprawidłowy. |
TOO_MANY_AUDIENCE_MEMBERS |
Maksymalna dozwolona liczba członków listy odbiorców na żądanie to 10 000. |
TOO_MANY_USER_IDENTIFIERS |
Maksymalna dozwolona liczba identyfikatorów użytkownika na członka listy odbiorców to 10. |
TOO_MANY_DESTINATIONS |
Maksymalna liczba miejsc docelowych dozwolonych w przypadku pojedynczego żądania to 10. |
INVALID_DESTINATION |
To miejsce docelowe jest nieprawidłowe. |
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED |
Partner danych nie ma dostępu do listy użytkowników należącej do konta operacyjnego. |
INVALID_MOBILE_ID_FORMAT |
Format identyfikatora urządzenia mobilnego jest nieprawidłowy. |
INVALID_USER_LIST_ID |
Lista użytkowników jest nieprawidłowa. |
MULTIPLE_DATA_TYPES_NOT_ALLOWED |
W jednym żądaniu nie można przesyłać danych wielu typów. |
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER |
Konfiguracje miejsc docelowych zawierające konto logowania DataPartner muszą mieć to samo konto logowania we wszystkich konfiguracjach miejsc docelowych. |
TERMS_AND_CONDITIONS_NOT_SIGNED |
Wymagane warunki nie zostały zaakceptowane. |
INVALID_NUMBER_FORMAT |
Nieprawidłowy format liczby. |
INVALID_CONVERSION_ACTION_ID |
Identyfikator działania powodującego konwersję jest nieprawidłowy. |
INVALID_CONVERSION_ACTION_TYPE |
Typ działania powodującego konwersję jest nieprawidłowy. |
INVALID_CURRENCY_CODE |
Kod waluty nie jest obsługiwany. |
INVALID_EVENT |
To wydarzenie jest nieprawidłowe. |
TOO_MANY_EVENTS |
Maksymalna dozwolona liczba zdarzeń na żądanie to 10 000. |
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS |
Na koncie docelowym nie są włączone konwersje rozszerzone dotyczące potencjalnych klientów. |
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS |
Na koncie docelowym nie można korzystać z konwersji rozszerzonych ze względu na zasady Google dotyczące danych klientów. Skontaktuj się z przedstawicielem Google. |
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
Konto docelowe nie zaakceptowało warunków dotyczących konwersji rozszerzonych. |
DUPLICATE_DESTINATION_REFERENCE |
Co najmniej 2 miejsca docelowe w żądaniu mają to samo odwołanie. |
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER |
Nieobsługiwane konto operacyjne do autoryzacji dostawcy danych. |
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER |
Nieobsługiwane połączone konto na potrzeby autoryzacji dostawcy danych. |
NO_IDENTIFIERS_PROVIDED |
Dane zdarzeń nie zawierają identyfikatorów użytkowników ani identyfikatorów reklam. W przypadku przesyłania zdarzeń Floodlight ten błąd oznacza, że żądania nie zawierają identyfikatorów reklam. |
INVALID_PROPERTY_TYPE |
Ten typ usługi nie jest obsługiwany. |
INVALID_STREAM_TYPE |
Ten typ strumienia nie jest obsługiwany. |
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT |
Połączone konto jest obsługiwane tylko wtedy, gdy konto logowania jest kontem DATA_PARTNER. |
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH |
Konto logowania musi być takie samo jak konto operacyjne w danym przypadku użycia. |
EVENT_TIME_INVALID |
Zdarzenie nie wystąpiło w dopuszczalnym przedziale czasu. |
RESERVED_NAME_USED |
Parametr używa zarezerwowanej nazwy. |
INVALID_EVENT_NAME |
Nazwa zdarzenia nie jest obsługiwana. |
NOT_ALLOWLISTED |
Konto nie znajduje się na liście dozwolonych w przypadku tej funkcji. |
INVALID_REQUEST_ID |
Identyfikator żądania użyty do pobrania stanu żądania jest nieprawidłowy. Stan można pobrać tylko w przypadku żądań, które zostały zrealizowane i nie mają wartości validate_only=true. |
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT |
Zdarzenie miało co najmniej 2 usługi docelowe Google Analytics. |
FIELD_VALUE_TOO_LONG |
Wartość pola jest za długa. |
FIELD_VALUE_TOO_SHORT |
Wartość pola jest zbyt krótka. |
TOO_MANY_ELEMENTS |
Żądanie zawiera zbyt wiele elementów na liście. |
TOO_FEW_ELEMENTS |
Żądanie zawiera zbyt mało elementów na liście. |
ALREADY_EXISTS |
Zasób już istnieje. |
IMMUTABLE_FIELD_FOR_UPDATE |
Podjęto próbę ustawienia niezmiennego pola w prośbie o aktualizację. |
INVALID_RESOURCE_NAME |
Nazwa zasobu jest nieprawidłowa. |
INVALID_FILTER |
Filtr zapytania jest nieprawidłowy. |
INVALID_UPDATE_MASK |
Maska aktualizacji jest nieprawidłowa. |
INVALID_PAGE_TOKEN |
Token strony jest nieprawidłowy. |
CANNOT_UPDATE_DISABLED_LICENSE |
Nie można zaktualizować licencji, która została wyłączona. |
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST |
Listy użytkowników o charakterze poufnym nie mogą być licencjonowane na rzecz tego klienta. |
INSUFFICIENT_COST |
Koszt jest zbyt niski w przypadku tej licencji. |
CANNOT_DISABLE_LICENSE |
Nie można wyłączyć licencji sprzedawcy, ponieważ jest ona używana. |
INVALID_CLIENT_ACCOUNT_ID |
Nieprawidłowy identyfikator konta klienta. |
PRICING_ONLY_ZERO_COST_ALLOWED |
Na tym koncie klienta nie można ustawić kosztu innego niż zero. |
PRICE_TOO_HIGH |
Koszt jest zbyt wysoki w przypadku tej licencji. |
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE |
Klient nie ma uprawnień do utworzenia licencji. |
INVALID_PRICING_END_DATE |
Data zakończenia ceny jest nieprawidłowa w przypadku tej licencji. |
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT |
Logicznej listy użytkowników z udostępnianym lub licencjonowanym segmentem nie można licencjonować. |
MISMATCHED_ACCOUNT_TYPE |
Typ konta klienta w żądaniu nie pasuje do rzeczywistego typu konta klienta. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE |
Typ licencji nie obsługuje kosztu udostępniania multimediów. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER |
Typ klienta nie obsługuje kosztu udziału w mediach. |
INVALID_MEDIA_SHARE_COST |
Nieprawidłowy koszt udziału w mediach. |
INVALID_COST_TYPE |
Nieprawidłowy typ kosztu. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST |
Typ UserList nie obsługuje kosztu udostępniania multimediów. |
MAX_COST_NOT_ALLOWED |
Maksymalny koszt jest dozwolony tylko w przypadku wartości cost_type MEDIA_SHARE. |
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED |
Listy odbiorców handlowych można licencjonować tylko bezpośrednio. |
INVALID_DESCRIPTION |
Opis jest nieprawidłowy. |
INVALID_DISPLAY_NAME |
Wyświetlana nazwa jest nieprawidłowa. |
DISPLAY_NAME_ALREADY_USED |
Wyświetlana nazwa jest już używana na liście użytkowników na tym koncie. |
OWNERSHIP_REQUIRED_FOR_UPDATE |
Aby zmodyfikować listę użytkowników, musisz być właścicielem. |
USER_LIST_MUTATION_NOT_SUPPORTED |
Typ listy użytkowników jest tylko do odczytu i nie obsługuje mutacji. |
SENSITIVE_USER_LIST_IMMUTABLE |
Listy odbiorców, które zawierają dane wymagające ochrony prywatności lub zostały odrzucone ze względów prawnych, nie mogą być modyfikowane przez użytkowników zewnętrznych. |
BILLABLE_RECORD_COUNT_IMMUTABLE |
Po ustawieniu pola rekordu podlegającego rozliczeniu na liście użytkowników remarketingu nie można go zmienić. |
USER_LIST_NAME_RESERVED |
Nazwa listy użytkowników jest zarezerwowana dla list systemowych. |
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA |
Aby korzystać z list remarketingowych utworzonych na podstawie danych przesłanych przez reklamodawcę, musi on zostać dodany do listy dozwolonych. |
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE |
Źródło odbiorców partnera nie jest obsługiwane w przypadku tego typu listy użytkowników. |
COMMERCE_PARTNER_NOT_ALLOWED |
Ustawienie pola commerce_partner jest obsługiwane tylko wtedy, gdy pole partner_audience_source ma wartość COMMERCE_AUDIENCE. |
UNSUPPORTED_PARTNER_AUDIENCE_INFO |
Pole partner_audience_info nie jest obsługiwane w przypadku typu listy użytkowników. |
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED |
Listy użytkowników Dopasowywania partnerów nie można tworzyć na kontach menedżera. |
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
Dostawca danych nie znajduje się na liście dozwolonych w przypadku danych partnerów zewnętrznych. |
ADVERTISER_TOS_NOT_ACCEPTED |
Reklamodawca nie zaakceptował warunków korzystania z usługi partnera. |
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
Reklamodawca nie ma uprawnień do korzystania z danych partnerów zewnętrznych. |
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT |
Ten typ listy użytkowników nie jest obsługiwany na tym koncie. |
INVALID_COMMERCE_PARTNER |
Pole commerce_partner jest nieprawidłowe. |
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE |
Dostawca danych nie ma uprawnień do tworzenia list odbiorców z branży handlowej. |
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES |
Typy kluczy przesyłania list użytkowników nie są obsługiwane. |
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG |
Konfiguracja informacji o zaimportowanej liście użytkowników jest nieobsługiwana. |
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE |
Te typy kont nie są obsługiwane w przypadku tego typu listy użytkowników. |
UNSUPPORTED_ACCOUNT_TYPE_FOR_PARTNER_LINK |
Te typy kont nie są obsługiwane w przypadku połączenia z partnerem. |
MEMBERSHIP_DURATION_TOO_LONG |
Okres członkostwa na liście użytkowników jest za długi. |
INVALID_MERCHANT_ID |
Pole merchant_id jest nieprawidłowe. |
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED |
Klient ma kampanie, które nie są zwolnione z obowiązku składania deklaracji dotyczącej reklam politycznych w UE. |
ACCOUNT_INELIGIBLE_FOR_STORE_SALES |
Konto nie kwalifikuje się do korzystania z pomiaru sprzedaży w sklepie. |
INVALID_MERCHANT_FEED_LANGUAGE_CODE |
Kod języka pliku danych sprzedawcy jest nieprawidłowy. |
INVALID_REGION_CODE |
Kod regionu jest nieprawidłowy. |
INVALID_SUBDIVISION_CODE |
Kod podziału administracyjnego jest nieprawidłowy. |
INVALID_SUBCONTINENT_CODE |
Kod subkontynentu jest nieprawidłowy. |
INVALID_CONTINENT_CODE |
Kod kontynentu jest nieprawidłowy. |
INVALID_DEVICE_CATEGORY |
Kategoria urządzenia jest nieprawidłowa. |
BOTH_CLIENT_ID_AND_APP_INSTANCE_ID_NOT_ALLOWED |
Ustawione są zarówno app_instance_id, jak i client_id. |
GOOGLE_ANALYTICS_SUBPROPERTY_OR_ROLLUP_PROPERTY_NOT_ALLOWED |
Usługa w Google Analytics jest usługą podrzędną lub usługą o pełnym zakresie. |
THIRD_PARTY_USER_DATA_NOT_ALLOWED |
Dane użytkowników pochodzące od osób trzecich mogą być ustawiane tylko przez partnerów ds. danych. |
INVALID_COUPON_CODE |
Kod kuponu jest nieprawidłowy. |
EVENT_SOURCE_AND_DESTINATION_MISMATCH |
Typ źródła zdarzenia nie pasuje do typu miejsca docelowego. |
DESTINATION_ACCOUNT_TYPE_MISMATCH |
Typ konta docelowego nie pasuje do podanego identyfikatora konta. |
CUSTOM_VARIABLE_VALUE_CONTAINS_PII |
Wartość zmiennej niestandardowej zawiera informacje umożliwiające identyfikację. |
CUSTOM_VARIABLE_NOT_ENABLED |
Zmienna niestandardowa nie jest włączona. |
INVALID_CUSTOM_VARIABLE_VALUE |
Wartość zmiennej niestandardowej jest nieprawidłowa. |
CUSTOM_VARIABLE_NOT_FOUND |
Miejsce docelowe nie ma zmiennej niestandardowej o nazwie zgodnej z określonym wzorcem variable. |
BASELINE_LOCATION_AUTO_DETECTION_FAILED |
Pole location_auto_detection_enabled w żądaniu miało wartość true, ale automatyczne wykrywanie lokalizacji podstawowej nie powiodło się. |
INSIGHTS_MISSING_FOR_DIMENSION |
Brak statystyk dotyczących tego wymiaru. |
Zdarzenie
Zdarzenie reprezentujące interakcję użytkownika z witryną lub aplikacją reklamodawcy.
| Pola | |
|---|---|
destination_references[] |
Opcjonalnie. Ciąg znaków odniesienia używany do określania miejsca docelowego. Jeśli to pole jest puste, zdarzenie zostanie wysłane do wszystkich |
transaction_id |
Opcjonalnie. Unikalny identyfikator tego zdarzenia. Wymagane w przypadku zdarzeń wysyłanych jako dodatkowe źródło danych na potrzeby konwersji rejestrowanych przez tag. |
event_timestamp |
Wymagane. Czas wystąpienia zdarzenia. |
last_updated_timestamp |
Opcjonalnie. Ostatnia aktualizacja wydarzenia. |
user_data |
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. |
ad_identifiers |
Opcjonalnie. Identyfikatory i inne informacje używane do dopasowywania zdarzenia konwersji do innej aktywności online (np. kliknięć reklam). |
currency |
Opcjonalnie. Kod waluty powiązany ze wszystkimi wartościami pieniężnymi w tym zdarzeniu. |
event_source |
Opcjonalnie. Sygnał wskazujący, gdzie wystąpiło zdarzenie (w internecie, w aplikacji, w sklepie stacjonarnym itp.). |
event_device_info |
Opcjonalnie. Informacje zebrane o używanym urządzeniu (jeśli takie było) w momencie wystąpienia zdarzenia. |
cart_data |
Opcjonalnie. Informacje o transakcji i produktach powiązanych ze zdarzeniem. |
custom_variables[] |
Opcjonalnie. Dodatkowe informacje o parach klucz/wartość do wysłania do kontenerów konwersji (działanie powodujące konwersję lub aktywność FL). |
experimental_fields[] |
Opcjonalnie. Lista par klucz/wartość dla pól eksperymentalnych, które mogą ostatecznie zostać włączone do interfejsu API. |
user_properties |
Opcjonalnie. Informacje o użytkowniku ocenione przez reklamodawcę w momencie wystąpienia zdarzenia. |
event_name |
Opcjonalnie. Nazwa zdarzenia. Wymagany w przypadku zdarzeń GA4. |
client_id |
Opcjonalnie. Unikalny identyfikator instancji użytkownika klienta internetowego w tym strumieniu danych z sieci GA4. |
user_id |
Opcjonalnie. Unikalny identyfikator użytkownika zdefiniowany przez reklamodawcę. |
additional_event_parameters[] |
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. |
third_party_user_data |
Opcjonalnie. Ten sam typ danych, który jest podawany w parametrze user_data, ale wyraźnie oznaczony jako dane należące do firmy zewnętrznej, a nie do reklamodawcy oferującego własne usługi. |
event_location |
Opcjonalnie. Informacje zebrane o lokalizacji użytkownika w momencie wystąpienia tego zdarzenia. |
app_instance_id |
Opcjonalnie. Unikalny identyfikator instancji użytkownika klienta aplikacji w tym strumieniu danych aplikacji w GA4. |
conversion_value |
Opcjonalnie. Wartość konwersji powiązana ze zdarzeniem w przypadku konwersji opartych na wartości. |
conversion_count |
Opcjonalnie. Ilość konwersji powiązanych ze zdarzeniem w przypadku konwersji opartych na zliczaniu. |
EventLocation
Lokalizacja, w której wystąpiło zdarzenie.
| Pola | |
|---|---|
store_id |
Opcjonalnie. Wymagane w przypadku sprzedaży w sklepie. Identyfikator reprezentujący sklep stacjonarny, w którym wystąpiło zdarzenie. |
city |
Opcjonalnie. Nazwa miasta, w którym wystąpiło zdarzenie. |
subdivision_code |
Opcjonalnie. Kod podziału administracyjnego zgodny ze standardem ISO 3166-2, w którym wystąpiło zdarzenie. |
region_code |
Opcjonalnie. 2-literowy kod regionu CLDR w adresie użytkownika. |
subcontinent_code |
Opcjonalnie. Kod subkontynentu w formacie UN M49, na którym wystąpiło zdarzenie. |
continent_code |
Opcjonalnie. Kod kontynentu w formacie UN M49, na którym wystąpiło zdarzenie. |
EventParameter
Parametr zdarzenia w przypadku zdarzeń GA4.
| Pola | |
|---|---|
parameter_name |
Wymagane. Nazwa parametru do użycia. |
value |
Wymagane. Ciąg znaków reprezentujący wartość parametru do ustawienia. |
EventSource
Źródło zdarzenia.
| Wartości w polu enum | |
|---|---|
EVENT_SOURCE_UNSPECIFIED |
Nieokreślone źródło zdarzeń. Nigdy nie należy go używać. |
WEB |
Wydarzenie zostało wygenerowane w przeglądarce. |
APP |
Wydarzenie zostało wygenerowane przez aplikację. |
IN_STORE |
Wydarzenie zostało wygenerowane na podstawie transakcji w sklepie stacjonarnym. |
PHONE |
Wydarzenie zostało wygenerowane na podstawie rozmowy telefonicznej. |
MESSAGE |
Wydarzenie zostało wygenerowane na podstawie wiadomości. |
OTHER |
Wydarzenie zostało wygenerowane z innych źródeł. |
ExperimentalField
Eksperymentalne pole reprezentujące nieoficjalne pola.
| Pola | |
|---|---|
field |
Opcjonalnie. Nazwa pola do użycia. |
value |
Opcjonalnie. Wartość pola do ustawienia. |
FeatureSet
Zestaw obsługiwanych funkcji linku partnerskiego.
| Wartości w polu enum | |
|---|---|
FEATURE_SET_UNSPECIFIED |
Nieokreślony zestaw funkcji. Jeśli nie określisz tego ustawienia, system domyślnie użyje wartości FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT. |
FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT |
Wskazuje link używany do zarządzania odbiorcami i zdarzeniami. |
FEATURE_SET_AD_EVENT_MANAGEMENT |
Wskazuje link używany do zarządzania zdarzeniami reklamowymi. |
GcpWrappedKeyInfo
Informacje o kluczu opakowanym Google Cloud Platform.
| Pola | |
|---|---|
key_type |
Wymagane. Typ algorytmu użytego do zaszyfrowania danych. |
wip_provider |
Wymagane. Dostawca puli Workload Identity wymagany do używania klucza KEK. |
kek_uri |
Wymagane. Identyfikator zasobu Cloud Key Management Service w Google Cloud Platform. Powinien mieć format |
encrypted_dek |
Wymagane. Zaszyfrowany klucz szyfrujący dane zakodowany w formacie base64. |
KeyType
Typ algorytmu użytego do zaszyfrowania danych.
| Wartości w polu enum | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Nieokreślony typ klucza. Nigdy nie należy go używać. |
XCHACHA20_POLY1305 |
Algorytm XChaCha20-Poly1305 |
Płeć
Rodzaj płci demograficznej (np. kobieta).
| Wartości w polu enum | |
|---|---|
GENDER_UNSPECIFIED |
Nie określono. |
GENDER_UNKNOWN |
Brak informacji. |
GENDER_MALE |
Mężczyzna. |
GENDER_FEMALE |
Damskie. |
GetUserListDirectLicenseRequest
Prośba o pobranie zasobu UserListDirectLicense.
| Pola | |
|---|---|
name |
Wymagane. Nazwa zasobu licencji bezpośredniej listy użytkowników. |
GetUserListGlobalLicenseRequest
Prośba o pobranie zasobu UserListGlobalLicense.
| Pola | |
|---|---|
name |
Wymagane. Nazwa zasobu globalnej licencji na listę użytkowników. |
GetUserListRequest
Wiadomość z prośbą o wywołanie GetUserList.
| Pola | |
|---|---|
name |
Wymagane. Nazwa zasobu listy użytkowników do pobrania. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
IngestAdEventsRequest
Prośba o przesłanie zdarzeń związanych z reklamami.
| Pola | |
|---|---|
ad_events[] |
Wymagane. Wymagane (co najmniej 1). Lista zdarzeń związanych z reklamami. |
encryption_info |
Opcjonalnie. Informacje o kluczach szyfrowania używanych do szyfrowania danych. |
validate_only |
Opcjonalnie. Jeśli wartość to prawda, żądanie jest weryfikowane, ale nie wykonywane. |
IngestAdEventsResponse
Ten typ nie ma pól.
Odpowiedź z operacji przetwarzania zdarzenia reklamowego.
IngestAudienceMembersRequest
Prośba o przesłanie członków grupy odbiorców do podanych miejsc docelowych. Zwraca wartość IngestAudienceMembersResponse.
| Pola | |
|---|---|
destinations[] |
Wymagane. Lista miejsc docelowych, do których mają być wysyłani odbiorcy. |
audience_members[] |
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. |
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 |
validate_only |
Opcjonalnie. Do celów testowych. Jeśli |
encoding |
Opcjonalnie. Wymagane w przypadku przesyłania plików |
encryption_info |
Opcjonalnie. Informacje o szyfrowaniu przesyłanych plików w |
terms_of_service |
Opcjonalnie. Warunki korzystania z usługi, które użytkownik zaakceptował lub odrzucił. |
IngestAudienceMembersResponse
Odpowiedź z IngestAudienceMembersRequest.
| Pola | |
|---|---|
request_id |
Automatycznie wygenerowany identyfikator żądania. |
IngestEventsRequest
Prośba o przesłanie członków grupy odbiorców do podanych miejsc docelowych. Zwraca wartość IngestEventsResponse.
| Pola | |
|---|---|
destinations[] |
Wymagane. Lista miejsc docelowych, do których mają być wysyłane zdarzenia. |
events[] |
Wymagane. Lista zdarzeń do wysłania do określonych miejsc docelowych. W jednym żądaniu można wysłać maksymalnie 2000 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 |
validate_only |
Opcjonalnie. Do celów testowych. Jeśli |
encoding |
Opcjonalnie. Wymagane w przypadku przesyłania plików |
encryption_info |
Opcjonalnie. Informacje o szyfrowaniu przesyłanych plików w |
IngestEventsResponse
Odpowiedź z IngestEventsRequest.
| Pola | |
|---|---|
request_id |
Automatycznie wygenerowany identyfikator żądania. |
IngestedUserListInfo
Reprezentuje listę użytkowników wypełnioną danymi przekazanymi przez użytkowników.
| Pola | |
|---|---|
upload_key_types[] |
Wymagane. Wartość niezmienna. Typy kluczy przesyłania tej listy użytkowników. |
contact_id_info |
Opcjonalnie. Dodatkowe informacje, gdy |
mobile_id_info |
Opcjonalnie. Dodatkowe informacje, gdy |
user_id_info |
Opcjonalnie. Dodatkowe informacje, gdy |
pair_id_info |
Opcjonalnie. Dodatkowe informacje, gdy Ta funkcja jest dostępna tylko dla partnerów danych. |
pseudonymous_id_info |
Opcjonalnie. Dodatkowe informacje o |
partner_audience_info |
Opcjonalnie. Dodatkowe informacje o odbiorcach partnerów. Ta funkcja jest dostępna tylko dla partnerów danych. |
UploadKeyType
Enum zawierający możliwe typy kluczy przesyłania listy użytkowników.
| Wartości w polu enum | |
|---|---|
UPLOAD_KEY_TYPE_UNSPECIFIED |
Nie określono. |
CONTACT_ID |
informacje o klientach, takie jak adres e-mail, numer telefonu lub adres pocztowy; |
MOBILE_ID |
Identyfikatory wyświetlania reklam mobilnych. |
USER_ID |
Identyfikatory użytkowników dostarczone przez osoby trzecie. |
PAIR_ID |
Identyfikatory dopasowywania danych o tożsamości użytkowników. |
PSEUDONYMOUS_ID |
Identyfikatory platformy zarządzania danymi: - Identyfikator użytkownika Google - Identyfikator dostarczony przez partnera - Identyfikator dostarczony przez wydawcę - IDFA w iOS - Identyfikator wyświetlania reklam w Androidzie - Identyfikator Roku - Identyfikator Amazon Fire TV - Identyfikator Xbox lub Microsoft |
IpData
Informacje o adresie IP użytkownika. Aby zwiększyć współczynniki dopasowania w przypadku kierowania na listę klientów, zalecamy uwzględnienie parametrów observe_start_time i observe_end_time.
| Pola | |
|---|---|
ip_address |
Wymagane. Adres IP zarejestrowany w momencie interakcji z klientem. Akceptuje standardowe formaty ciągów znaków zarówno w przypadku protokołu IPv4, jak i IPv6. |
observe_start_time |
Opcjonalnie. Czas pierwszej zarejestrowanej interakcji z tego adresu IP w ramach sesji. |
observe_end_time |
Opcjonalnie. Czas ostatniej zarejestrowanej interakcji z tego adresu IP w sesji. |
Element
Reprezentuje produkt w koszyku powiązany ze zdarzeniem.
| Pola | |
|---|---|
merchant_product_id |
Opcjonalnie. Identyfikator produktu na koncie Merchant Center. |
quantity |
Opcjonalnie. Liczba tego produktu powiązanego ze zdarzeniem. |
unit_price |
Opcjonalnie. Cena jednostkowa bez podatku, dostawy i wszelkich rabatów na poziomie transakcji. |
item_id |
Opcjonalnie. Unikalny identyfikator, który umożliwia odwoływanie się do elementu. |
additional_item_parameters[] |
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. |
merchant_id |
Opcjonalnie. Identyfikator w Merchant Center powiązany z produktem. W przypadku zdarzeń związanych ze sprzedażą w sklepie stacjonarnym ta wartość zastąpi wartość ustawioną na poziomie koszyka. W przypadku innych zdarzeń to pole jest ignorowane. |
merchant_feed_label |
Opcjonalnie. Etykieta pliku danych Merchant Center. Jeśli nadal używasz krajów, możesz zamiast nich użyć 2-literowego kodu kraju w formacie ISO-3166-1 alfa-2. W przypadku zdarzeń związanych ze sprzedażą w sklepie stacjonarnym ta wartość zastąpi wartość ustawioną na poziomie koszyka. W przypadku innych zdarzeń to pole jest ignorowane. |
merchant_feed_language_code |
Opcjonalnie. Kod języka w formacie ISO 639-1 powiązany z plikiem danych Merchant Center, w którym przesyłane są Twoje produkty. |
custom_variables[] |
Opcjonalnie. Dodatkowe informacje o parach klucz/wartość, które mają być wysyłane do kontenerów konwersji (działania powodującego konwersję lub aktywności Floodlight) podczas śledzenia konwersji poszczególnych produktów. |
conversion_value |
Opcjonalnie. Wartość konwersji powiązana z tym elementem w zdarzeniu w przypadku, gdy wartość konwersji jest inna dla każdego elementu. |
ItemCustomVariable
Zmienna niestandardowa na poziomie produktu na potrzeby konwersji z reklam.
| Pola | |
|---|---|
variable |
Opcjonalnie. Nazwa zmiennej niestandardowej do ustawienia. Jeśli zmienna nie zostanie znaleziona w przypadku danego miejsca docelowego, zostanie zignorowana. |
value |
Opcjonalnie. Wartość do zapisania w zmiennej niestandardowej. |
destination_references[] |
Opcjonalnie. Ciąg odniesienia używany do określania, do którego z |
ItemParameter
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.
| Pola | |
|---|---|
parameter_name |
Wymagane. Nazwa parametru do użycia. |
value |
Wymagane. Ciąg znaków reprezentujący wartość parametru do ustawienia. |
ListUserListDirectLicensesRequest
Żądanie wyświetlenia listy wszystkich zasobów UserListDirectLicense na danym koncie.
| Pola | |
|---|---|
parent |
Wymagane. Konto, którego dotyczy zapytanie o licencje. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
filter |
Opcjonalnie. Ciąg filtra do zastosowania w żądaniu listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. Obsługiwane operacje:
Obsługiwane funkcje: – Nieobsługiwane pola:
|
page_size |
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ą zmienione na 1000. |
page_token |
Opcjonalnie. Token strony otrzymany z poprzedniego wywołania Podczas paginacji wszystkie inne parametry przekazane do funkcji |
ListUserListDirectLicensesResponse
Odpowiedź z ListUserListDirectLicensesRequest.
| Pola | |
|---|---|
user_list_direct_licenses[] |
Licencje dla danej listy użytkowników w żądaniu. |
next_page_token |
Token, który można wysłać jako |
ListUserListGlobalLicenseCustomerInfosRequest
Żądanie wyświetlenia wszystkich zasobów UserListGlobalLicenseCustomerInfo dla danej listy użytkowników z licencją globalną.
| Pola | |
|---|---|
parent |
Wymagane. Licencja globalna, której dotyczy zapytanie o informacje o kliencie. Powinien mieć format |
filter |
Opcjonalnie. Ciąg filtra do zastosowania w żądaniu listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. Obsługiwane operacje:
Obsługiwane funkcje: – Nieobsługiwane pola:
|
page_size |
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ą zmienione na 1000. |
page_token |
Opcjonalnie. Token strony otrzymany z poprzedniego wywołania Podczas paginacji wszystkie inne parametry przekazane do funkcji |
ListUserListGlobalLicenseCustomerInfosResponse
Odpowiedź na [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].
| Pola | |
|---|---|
user_list_global_license_customer_infos[] |
Informacje o kliencie dotyczące danej licencji w żądaniu. |
next_page_token |
Token, który można wysłać jako |
ListUserListGlobalLicensesRequest
Żądanie wyświetlenia listy wszystkich zasobów UserListGlobalLicense na danym koncie.
| Pola | |
|---|---|
parent |
Wymagane. Konto, którego dotyczy zapytanie o licencje. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
filter |
Opcjonalnie. Ciąg filtra do zastosowania w żądaniu listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. Obsługiwane operacje:
Obsługiwane funkcje: – Nieobsługiwane pola:
|
page_size |
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ą zmienione na 1000. |
page_token |
Opcjonalnie. Token strony otrzymany z poprzedniego wywołania Podczas paginacji wszystkie inne parametry przekazane do funkcji |
ListUserListGlobalLicensesResponse
Odpowiedź z ListUserListGlobalLicensesRequest.
| Pola | |
|---|---|
user_list_global_licenses[] |
Licencje dla danej listy użytkowników w żądaniu. |
next_page_token |
Token, który można wysłać jako |
ListUserListsRequest
Wiadomość żądania dla ListUserLists.
| Pola | |
|---|---|
parent |
Wymagane. Konto nadrzędne, do którego należy ta kolekcja list użytkowników. Format: accountTypes/{account_type}/accounts/{account} |
page_size |
Opcjonalnie. Maksymalna liczba list użytkowników do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie zostanie określona, zwracanych będzie maksymalnie 50 list użytkowników. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000. |
page_token |
Opcjonalnie. Token strony otrzymany z poprzedniego wywołania Podczas paginacji wszystkie inne parametry przekazane do funkcji |
filter |
Opcjonalnie. Ciąg znaków filtra. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. Obsługiwane operacje:
Obsługiwane funkcje: – Obsługiwane pola:
|
ListUserListsResponse
Wiadomość odpowiedzi dla ListUserLists.
| Pola | |
|---|---|
user_lists[] |
Listy użytkowników z określonego konta. |
next_page_token |
Token, który można wysłać jako |
MatchRateRange
Zakres współczynnika dopasowania przesłanych danych lub listy użytkowników.
| Wartości w polu enum | |
|---|---|
MATCH_RATE_RANGE_UNKNOWN |
Zakres współczynnika dopasowania jest nieznany. |
MATCH_RATE_RANGE_NOT_ELIGIBLE |
Zakres współczynnika dopasowania jest nieprawidłowy. |
MATCH_RATE_RANGE_LESS_THAN_20 |
Zakres współczynnika dopasowania jest mniejszy niż 20% (w przedziale [0, 20)). |
MATCH_RATE_RANGE_20_TO_30 |
Zakres współczynnika dopasowania wynosi od 20% do 30% (w przedziale [20, 31)). |
MATCH_RATE_RANGE_31_TO_40 |
Zakres współczynnika dopasowania wynosi od 31% do 40% (w przedziale [31, 41)). |
MATCH_RATE_RANGE_41_TO_50 |
Współczynnik dopasowania mieści się w zakresie od 41% do 50% (w przedziale [41, 51)). |
MATCH_RATE_RANGE_51_TO_60 |
Zakres współczynnika dopasowania wynosi od 51% do 60% (w przedziale [51, 61)). |
MATCH_RATE_RANGE_61_TO_70 |
Współczynnik dopasowania mieści się w zakresie od 61% do 70% (w przedziale [61, 71)). |
MATCH_RATE_RANGE_71_TO_80 |
Zakres współczynnika dopasowania wynosi od 71% do 80% (w przedziale [71, 81)). |
MATCH_RATE_RANGE_81_TO_90 |
Zakres współczynnika dopasowania wynosi od 81% do 90% (w przedziale [81, 91)). |
MATCH_RATE_RANGE_91_TO_100 |
Zakres współczynnika dopasowania wynosi od 91% do 100% (w przedziale |
MediaQuartile
Ilość odtworzonych multimediów w postaci dyskretnych kwartyli.
| Wartości w polu enum | |
|---|---|
MEDIA_QUARTILE_UNSPECIFIED |
Nieokreślony kwartyl multimediów. |
MEDIA_QUARTILE_START |
Rozpocznij. |
MEDIA_QUARTILE_FIRST_QUARTILE |
Pierwszy kwartyl |
MEDIA_QUARTILE_MIDPOINT |
Do połowy. |
MEDIA_QUARTILE_THIRD_QUARTILE |
Trzeci kwartyl |
MEDIA_QUARTILE_COMPLETE |
Zakończono. |
MobileData
Identyfikatory mobilne odbiorców. Wymagany jest co najmniej 1 identyfikator mobilny.
| Pola | |
|---|---|
mobile_ids[] |
Wymagane. Lista identyfikatorów urządzeń mobilnych (identyfikatorów wyświetlania reklam lub IDFA). W jednym elemencie |
MobileIdInfo
Dodatkowe informacje, gdy MOBILE_ID jest jednym z upload_key_types.
| Pola | |
|---|---|
data_source_type |
Opcjonalnie. Wartość niezmienna. Źródło danych przesyłania. |
key_space |
Wymagane. Wartość niezmienna. Przestrzeń kluczy identyfikatorów mobilnych. |
app_id |
Wymagane. Wartość niezmienna. Ciąg znaków, który w niepowtarzalny sposób identyfikuje aplikację mobilną, z której zebrano dane. |
KeySpace
Przestrzeń kluczy dla identyfikatora mobilnego.
| Wartości w polu enum | |
|---|---|
KEY_SPACE_UNSPECIFIED |
Nie określono. |
IOS |
Przestrzeń kluczy iOS. |
ANDROID |
Przestrzeń kluczy Androida. |
PairData
Identyfikatory PAIR dla odbiorców. Wymagany jest co najmniej 1 identyfikator PAIR.
Ta funkcja jest dostępna tylko dla partnerów danych.
| Pola | |
|---|---|
pair_ids[] |
Wymagane. Dane umożliwiające identyfikację dostarczone przez środowisko 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 |
PairIdInfo
Dodatkowe informacje, gdy PAIR_ID jest jednym z upload_key_types.
Ta funkcja jest dostępna tylko dla partnerów danych.
| Pola | |
|---|---|
publisher_id |
Wymagane. Wartość 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 clean room. |
publisher_name |
Wymagane. Opisowa nazwa wydawcy, która będzie wyświetlana w interfejsie, aby zapewnić lepsze kierowanie. |
match_rate_percentage |
Wymagane. To pole oznacza odsetek dopasowania użytkowników na tej liście do danych własnych odpowiedniego wydawcy. Musi mieścić się w zakresie od 0 do 100 włącznie. |
advertiser_identifier_count |
Opcjonalnie. 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. |
clean_room_identifier |
Wymagane. Wartość niezmienna. Określa unikalną relację między reklamodawcą a wydawcą w przypadku jednego lub wielu dostawców usługi data clean room. |
PartnerAudienceInfo
Dodatkowe informacje o odbiorcach partnerów.
Ta funkcja jest dostępna tylko dla partnerów danych.
| Pola | |
|---|---|
partner_audience_source |
Wymagane. Wartość niezmienna. Źródło danych o odbiorcach partnera. |
commerce_partner |
Opcjonalnie. Nazwa partnera handlowego. Dozwolone tylko wtedy, gdy |
PartnerAudienceSource
Źródło danych o odbiorcach partnera.
| Wartości w polu enum | |
|---|---|
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED |
Nie określono. |
COMMERCE_AUDIENCE |
Źródłem danych o odbiorcach partnera są handlowe listy odbiorców. |
LINEAR_TV_AUDIENCE |
Źródłem danych o odbiorcach partnera są odbiorcy telewizji linearnej. |
AGENCY_PROVIDER_AUDIENCE |
Źródłem danych o odbiorcach partnera są listy odbiorców agencji lub dostawców. |
PartnerCustomerAccount
Reprezentuje konto klienta w systemie partnera.
| Pola | |
|---|---|
account_id |
Wymagane. Identyfikator konta klienta w przestrzeni identyfikatorów partnera. |
account_name |
Opcjonalnie. Nazwa konta. |
account_type |
Opcjonalnie. Typ konta. Może służyć np. do rozróżniania kont reklamodawców i kont na poziomie firmy. |
PartnerLink
Połączenie partnerskie między kontem będącym właścicielem a kontem partnera.
| Pola | |
|---|---|
name |
Identyfikator. Nazwa linku partnerskiego. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
partner_link_id |
Tylko dane wyjściowe. Identyfikator linku partnera. |
owning_account |
Wymagane. Konto, które przyznaje dostęp do konta partnera. |
partner_account |
Wymagane. Konto partnera, któremu konto będące właścicielem przyznało dostęp. |
feature_set |
Opcjonalnie. Wartość niezmienna. Zestaw funkcji obsługiwanych w przypadku linku partnerskiego. Jeśli nie określisz tego ustawienia, system domyślnie użyje wartości |
partner_customer_account |
Opcjonalnie. Konto klienta w systemie partnera. Jest to wymagane w przypadku linków partnerskich z zestawem funkcji |
partner_link_metadata |
Opcjonalnie. Metadane powiązane z linkiem partnerskim. Jest to opcjonalne i akceptowane tylko w przypadku linków partnerskich z symbolem |
PartnerLinkMetadata
Reprezentuje metadane powiązane z linkiem partnerskim.
| Pola | |
|---|---|
implicit_accounts[] |
Opcjonalnie. Lista kont domyślnych. |
Platforma
Dodatkowe informacje o platformie, na której wyświetlono reklamę.
| Wartości w polu enum | |
|---|---|
PLATFORM_UNSPECIFIED |
Nieokreślona platforma. |
PLATFORM_IOS |
platformy iOS. |
PLATFORM_ANDROID |
platforma Android, |
PLATFORM_WEB |
Platforma internetowa. |
TypPlatformy
Typ platformy, na której wyświetlono reklamę.
| Wartości w polu enum | |
|---|---|
PLATFORM_TYPE_UNSPECIFIED |
Nieokreślony typ platformy. |
PLATFORM_TYPE_MOBILE |
Platforma mobilna. |
PLATFORM_TYPE_DESKTOP |
Platforma komputerowa. |
PLATFORM_TYPE_CTV |
platformy CTV. |
PLATFORM_TYPE_PHONE |
Platforma telefonu. |
PLATFORM_TYPE_TABLET |
Platforma tabletu. |
PpidData
Dane identyfikatorów podawanych przez wydawcę zawierające identyfikatory PPID. Wymagany jest co najmniej 1 identyfikator PPID.
Ta funkcja jest dostępna tylko dla partnerów danych.
| Pola | |
|---|---|
ppids[] |
Wymagane. Lista identyfikatorów podawanych przez wydawców dla użytkownika. |
ProcessingErrorReason
Przyczyna błędu przetwarzania. W przyszłości możemy dodać nowe powody.
| Wartości w polu enum | |
|---|---|
PROCESSING_ERROR_REASON_UNSPECIFIED |
Przyczyna błędu przetwarzania jest nieznana. |
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE |
Zmienna niestandardowa jest nieprawidłowa. |
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
Stan zmiennej niestandardowej nie jest włączony. |
PROCESSING_ERROR_REASON_EVENT_TOO_OLD |
Konwersja jest starsza niż maksymalny obsługiwany wiek. |
PROCESSING_ERROR_REASON_DENIED_CONSENT |
Użytkownik lub domyślne ustawienia reklamodawcy odrzucają dane użytkownika reklamy. |
PROCESSING_ERROR_REASON_NO_CONSENT |
Reklamodawca nie wyraził zgody na korzystanie z usług podstawowych platformy reklamowej. |
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT |
Nie udało się określić ogólnej zgody (na podstawie zgody na poziomie wiersza, zgody na poziomie żądania i ustawień konta) w przypadku tego użytkownika. |
PROCESSING_ERROR_REASON_DUPLICATE_GCLID |
W systemie istnieje już konwersja z tym samym identyfikatorem kliknięcia Google i czasem konwersji. |
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID |
Konwersja z tą samą kombinacją identyfikatora zamówienia i działania powodującego konwersję została już przesłana. |
PROCESSING_ERROR_REASON_INVALID_GBRAID |
Nie udało się zdekodować parametru gbraid. |
PROCESSING_ERROR_REASON_INVALID_GCLID |
Nie udało się zdekodować identyfikatora kliknięcia Google. |
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID |
Identyfikator sprzedawcy zawiera znaki inne niż cyfry. |
PROCESSING_ERROR_REASON_INVALID_WBRAID |
Nie udało się zdekodować parametru wbraid. |
PROCESSING_ERROR_REASON_INTERNAL_ERROR |
Błąd wewnętrzny. |
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
Warunki korzystania z konwersji rozszerzonych nie zostały podpisane na koncie docelowym. |
PROCESSING_ERROR_REASON_INVALID_EVENT |
Wydarzenie jest nieprawidłowe. |
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS |
Liczba dopasowanych transakcji jest mniejsza niż minimalny próg. |
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS |
Transakcje są poniżej progu minimalnego. |
PROCESSING_ERROR_REASON_INVALID_FORMAT |
Wydarzenie ma błąd formatu. |
PROCESSING_ERROR_REASON_DECRYPTION_ERROR |
Wydarzenie zawiera błąd odszyfrowywania. |
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR |
Nie udało się odszyfrować klucza DEK. |
PROCESSING_ERROR_REASON_INVALID_WIP |
Identyfikator WIP ma nieprawidłowy format lub nie istnieje. |
PROCESSING_ERROR_REASON_INVALID_KEK |
Klucz KEK nie może odszyfrować danych, ponieważ jest nieprawidłowy lub nie istnieje. |
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED |
Nie można było użyć tożsamości WIP, ponieważ została odrzucona przez warunek atestu. |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
System nie miał uprawnień potrzebnych do uzyskania dostępu do klucza KEK. |
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED |
Nie udało się uwierzytelnić w AWS. |
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Nie udało się odszyfrować danych UserIdentifier za pomocą klucza DEK. |
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER |
Użytkownik próbował przesyłać zdarzenia z identyfikatorem reklamy, który nie pochodzi z reklam na koncie operacyjnym. |
PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID |
W przypadku parametrów BRAID nie można używać działań powodujących konwersję, które zliczają 1 konwersję na kliknięcie. |
PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND |
Nie można znaleźć identyfikatora dopasowania. |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID |
Nie można znaleźć identyfikatora użytkownika dla identyfikatora dopasowania. |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID |
Nie udało się znaleźć identyfikatora użytkownika dla identyfikatora kliknięcia Google. |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID |
Nie można znaleźć identyfikatora użytkownika dla identyfikatora DCLID. |
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS |
Występują nieprawidłowe identyfikatory reklam. |
PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT |
Format identyfikatora urządzenia mobilnego jest nieprawidłowy. |
PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND |
Nie udało się znaleźć pierwotnych konwersji. |
PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR |
Nie można zdekodować identyfikatora zdarzenia (dclid lub identyfikatora wyświetlenia). |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID |
Nie można znaleźć identyfikatora użytkownika dla podanego identyfikatora wyświetlenia. |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND |
Nie można znaleźć identyfikatora użytkownika. |
PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK |
Sygnatura czasowa zdarzenia była wcześniejsza niż powiązane kliknięcie. |
PROCESSING_ERROR_REASON_TOO_RECENT_CLICK |
Kliknięcie nastąpiło zbyt niedawno. |
PROCESSING_ERROR_REASON_INVALID_CLICK |
Nie można przypisać zdarzenia do kliknięcia (identyfikatora kliknięcia Google). Być może źródłem kliknięcia nie była np. kampania Google Ads. |
PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK |
Kliknięcie ze zdarzenia nie jest powiązane z |
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND |
Nie można znaleźć odpowiedniego kliknięcia pasującego do podanych atrybutów. |
PROCESSING_ERROR_REASON_EXTERNAL_ATTRIBUTION_DATA_MISSING |
Brak zewnętrznych danych atrybucji. Wysyłanie zdarzeń do miejsca docelowego w przypadku działania powodującego konwersję z zewnętrzną atrybucją nie jest obsługiwane. |
ProcessingWarningReason
Powód ostrzeżenia dotyczącego przetwarzania.
| Wartości w polu enum | |
|---|---|
PROCESSING_WARNING_REASON_UNSPECIFIED |
Przyczyna ostrzeżenia o przetwarzaniu jest nieznana. |
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED |
System nie miał uprawnień potrzebnych do uzyskania dostępu do klucza KEK. |
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR |
Nie udało się odszyfrować klucza DEK. |
PROCESSING_WARNING_REASON_DECRYPTION_ERROR |
Wydarzenie zawiera błąd odszyfrowywania. |
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED |
Nie można było użyć tożsamości WIP, ponieważ została odrzucona przez warunek atestu. |
PROCESSING_WARNING_REASON_INVALID_WIP |
Identyfikator WIP ma nieprawidłowy format lub nie istnieje. |
PROCESSING_WARNING_REASON_INVALID_KEK |
Klucz KEK nie może odszyfrować danych, ponieważ jest nieprawidłowy lub nie istnieje. |
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Nie udało się odszyfrować danych UserIdentifier za pomocą klucza DEK. |
PROCESSING_WARNING_REASON_INTERNAL_ERROR |
Błąd wewnętrzny. |
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED |
Nie udało się uwierzytelnić w AWS. |
Produkt
Rola wycofana. Zamiast niej używaj zasady AccountType
| Wartości w polu enum | |
|---|---|
PRODUCT_UNSPECIFIED |
Nieokreślony produkt. Nigdy nie należy go używać. |
GOOGLE_ADS |
Google Ads, |
DISPLAY_VIDEO_PARTNER |
partnera Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
reklamodawcą Display & Video 360; |
DATA_PARTNER |
Dostawca danych. |
ProductAccount
Reprezentuje konkretne konto.
| Pola | |
|---|---|
product |
Rola wycofana. Zamiast niej używaj zasady |
account_id |
Wymagane. Identyfikator konta. Na przykład identyfikator konta Google Ads. |
account_type |
Wymagane. Typ konta. Na przykład: |
AccountType
Reprezentuje typy kont Google. Służy do lokalizowania kont i miejsc docelowych.
| Wartości w polu enum | |
|---|---|
ACCOUNT_TYPE_UNSPECIFIED |
Nieokreślony produkt. Nigdy nie należy go używać. |
GOOGLE_ADS |
Google Ads, |
DISPLAY_VIDEO_PARTNER |
partnera Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
reklamodawcą Display & Video 360; |
DATA_PARTNER |
Dostawca danych. |
GOOGLE_ANALYTICS_PROPERTY |
Google Analytics. |
GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Połączenie z listą odbiorców Google Ad Managera. |
FLOODLIGHT_CONFIG |
Konfiguracja Floodlight. |
PseudonymousIdInfo
Dodatkowe informacje, gdy PSEUDONYMOUS_ID jest jednym z upload_key_types.
| Pola | |
|---|---|
sync_status |
Tylko dane wyjściowe. Stan synchronizacji listy użytkowników. |
billable_record_count |
Opcjonalnie. Wartość niezmienna. Liczba rekordów podlegających rozliczeniu (np. przesłanych lub dopasowanych). |
SyncStatus
Stan synchronizacji listy użytkowników.
| Wartości w polu enum | |
|---|---|
SYNC_STATUS_UNSPECIFIED |
Nie określono. |
CREATED |
Lista użytkowników została utworzona jako element zastępczy. Lista zawartości lub metadane są nadal synchronizowane. Lista użytkowników nie jest gotowa do użycia. |
READY_FOR_USE |
Lista użytkowników jest gotowa do użycia. Treści i pliki cookie zostały prawidłowo zsynchronizowane. |
FAILED |
Podczas synchronizacji zawartości lub metadanych listy użytkowników wystąpił błąd. Nie można użyć listy użytkowników. |
RemoveAudienceMembersRequest
Prośba o usunięcie użytkowników z grupy odbiorców w podanych miejscach docelowych. Zwraca wartość RemoveAudienceMembersResponse.
| Pola | |
|---|---|
destinations[] |
Wymagane. Lista miejsc docelowych, z których chcesz usunąć użytkowników. |
audience_members[] |
Wymagane. Lista użytkowników do usunięcia. |
validate_only |
Opcjonalnie. Do celów testowych. Jeśli |
encoding |
Opcjonalnie. Wymagane w przypadku przesyłania plików |
encryption_info |
Opcjonalnie. Informacje o szyfrowaniu przesyłanych plików w |
RemoveAudienceMembersResponse
Odpowiedź z RemoveAudienceMembersRequest.
| Pola | |
|---|---|
request_id |
Automatycznie wygenerowany identyfikator żądania. |
RequestStatusPerDestination
Stan żądania dla każdego miejsca docelowego.
| Pola | |
|---|---|
destination |
Miejsce docelowe w żądaniu do interfejsu DM API. |
request_status |
Stan żądania miejsca docelowego. |
error_info |
Informacje o błędzie zawierające przyczynę błędu i liczbę błędów związanych z przesyłaniem. Wartość jest podawana tylko wtedy, gdy element |
warning_info |
Informacje ostrzegawcze zawierające powód ostrzeżenia i liczbę ostrzeżeń związanych z przesłanym plikiem. To pole jest puste, gdy żądanie ma wartość |
Pole zbiorcze status. Stan miejsca docelowego. status może mieć tylko jedną z tych wartości: |
|
audience_members_ingestion_status |
Stan żądania dotyczącego przesyłania danych o odbiorcach. |
events_ingestion_status |
Stan żądania dotyczącego zdarzeń przesyłanych do systemu. |
audience_members_removal_status |
Stan prośby o usunięcie członków grupy odbiorców. |
DataType
Typ danych.
| Wartości w polu enum | |
|---|---|
DATA_TYPE_UNSPECIFIED |
Typ danych nie jest określony. |
EMAIL |
Dane to adres e-mail. |
PHONE_NUMBER |
Dane to numer telefonu. |
ADDRESS |
Dane to adres pocztowy. |
IP_ADDRESS |
Dane to adres IP. |
DataTypeCount
Liczba dla określonego typu danych.
| Pola | |
|---|---|
type |
Typ danych. |
count |
Liczba tego typu danych. |
IngestAudienceMembersStatus
Stan żądania dotyczącego przesyłania danych o odbiorcach.
| Pola | |
|---|---|
Pole zbiorcze status. Stan przesyłania danych o członkach listy odbiorców do usługi docelowej. status może mieć tylko jedną z tych wartości: |
|
user_data_ingestion_status |
Stan pozyskiwania danych użytkownika do miejsca docelowego. |
mobile_data_ingestion_status |
Stan pozyskiwania danych mobilnych do miejsca docelowego. |
pair_data_ingestion_status |
Stan pozyskiwania danych par do miejsca docelowego. |
user_id_data_ingestion_status |
Stan pozyskiwania danych identyfikatora użytkownika do miejsca docelowego. |
ppid_data_ingestion_status |
Stan pozyskiwania danych ppid w miejscu docelowym. |
composite_data_ingestion_status |
Stan pozyskiwania danych złożonych w miejscu docelowym. |
IngestCompositeDataStatus
Stan pozyskiwania danych złożonych do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem.
| Pola | |
|---|---|
record_count |
Łą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 przetworzeni. |
data_type_counts[] |
Łączna liczba typów danych wysłanych w żądaniu przesłania do miejsca docelowego, podzielona według typu danych. Obejmuje wszystkie typy danych w żądaniu, niezależnie od tego, czy zostały przetworzone. |
upload_match_rate_range |
Zakres współczynnika dopasowania przesyłanych danych. |
IngestEventsStatus
Stan przesyłania zdarzeń do miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba zdarzeń wysłanych w żądaniu przesyłania. Obejmuje wszystkie zdarzenia w żądaniu, niezależnie od tego, czy zostały przetworzone. |
IngestMobileDataStatus
Stan pozyskiwania danych mobilnych do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem danych.
| Pola | |
|---|---|
record_count |
Łą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 przetworzeni. |
mobile_id_count |
Łą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. |
IngestPairDataStatus
Stan pozyskiwania danych par do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem.
| Pola | |
|---|---|
record_count |
Łą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 przetworzeni. |
pair_id_count |
Łą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. |
IngestPpidDataStatus
Stan pozyskiwania danych PPID do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem.
| Pola | |
|---|---|
record_count |
Łą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 przetworzeni. |
ppid_count |
Łą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. |
IngestUserDataStatus
Stan pozyskiwania danych użytkownika do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem danych.
| Pola | |
|---|---|
record_count |
Łą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 przetworzeni. |
user_identifier_count |
Łą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. |
upload_match_rate_range |
Zakres współczynnika dopasowania przesyłanych danych. |
IngestUserIdDataStatus
Stan pozyskiwania danych identyfikatora użytkownika do miejsca docelowego zawierającego statystyki związane z pozyskiwaniem.
| Pola | |
|---|---|
record_count |
Łą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 przetworzeni. |
user_id_count |
Łą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 przetworzone. |
RemoveAudienceMembersStatus
Stan prośby o usunięcie członków grupy odbiorców.
| Pola | |
|---|---|
Pole zbiorcze status. Stan usunięcia członków listy odbiorców z miejsca docelowego. status może mieć tylko jedną z tych wartości: |
|
user_data_removal_status |
Stan usunięcia danych użytkownika z miejsca docelowego. |
mobile_data_removal_status |
Stan usunięcia danych mobilnych z miejsca docelowego. |
pair_data_removal_status |
Stan usunięcia danych z miejsca docelowego. |
user_id_data_removal_status |
Stan usuwania danych identyfikatora użytkownika z miejsca docelowego. |
ppid_data_removal_status |
Stan usuwania danych PPID z miejsca docelowego. |
composite_data_removal_status |
Stan usunięcia danych złożonych z miejsca docelowego. |
RemoveCompositeDataStatus
Stan usunięcia danych złożonych z miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
data_type_counts[] |
Łączna liczba typów danych wysłanych w żądaniu usunięcia, podzielona według typu danych. Obejmuje wszystkie typy danych w żądaniu, niezależnie od tego, czy zostały one usunięte. |
RemoveMobileDataStatus
Stan usunięcia danych mobilnych z miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
mobile_id_count |
Łączna liczba identyfikatorów urządzeń mobilnych wysłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory mobilne w żądaniu, niezależnie od tego, czy zostały usunięte. |
RemovePairDataStatus
Stan usunięcia danych z miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
pair_id_count |
Łą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. |
RemovePpidDataStatus
Stan usuwania danych PPID z miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
ppid_count |
Łą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. |
RemoveUserDataStatus
Stan usunięcia danych użytkownika z miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
user_identifier_count |
Łą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. |
RemoveUserIdDataStatus
Stan usuwania danych identyfikatora użytkownika z miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
user_id_count |
Łą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. |
RequestStatus
Stan prośby.
| Wartości w polu enum | |
|---|---|
REQUEST_STATUS_UNKNOWN |
Stan prośby jest nieznany. |
SUCCESS |
Przetwarzanie wszystkich rekordów zakończyło się bez błędów. W polu |
PROCESSING |
Żądanie jest przetwarzane. |
FAILED |
Przetwarzanie wszystkich rekordów nie powiodło się. Szczegóły błędów znajdziesz w polu |
PARTIAL_SUCCESS |
Przetwarzanie niektórych rekordów zostało ukończone bez błędów, ale w przypadku innych wystąpiły błędy. Szczegóły błędów znajdziesz w polu |
RetrieveInsightsRequest
Wiadomość z prośbą o wywołanie interfejsu DM API MarketingDataInsightsService.RetrieveInsights
| Pola | |
|---|---|
parent |
Wymagane. Konto nadrzędne, do którego należy lista użytkowników. Format: |
baseline |
Wymagane. Wartość bazowa dla żądanych statystyk. |
user_list_id |
Wymagane. Identyfikator listy użytkowników, dla której są wymagane statystyki. |
RetrieveInsightsResponse
Komunikat odpowiedzi interfejsu DM API MarketingDataInsightsService.RetrieveInsights
| Pola | |
|---|---|
marketing_data_insights[] |
Zawiera statystyki dotyczące danych marketingowych. |
MarketingDataInsight
Statystyki dotyczące danych marketingowych.
Ta funkcja jest dostępna tylko dla partnerów danych.
| Pola | |
|---|---|
dimension |
Wymiar, do którego należą statystyki. |
attributes[] |
Statystyki dotyczące wartości danego wymiaru. |
AudienceInsightsDimension
Wymiary, których można używać do generowania statystyk.
| Wartości w polu enum | |
|---|---|
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED |
Nie określono. |
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN |
W tej wersji wartość jest nieznana. |
AFFINITY_USER_INTEREST |
Zainteresowanie użytkownika o podobnych zainteresowaniach. |
IN_MARKET_USER_INTEREST |
Zainteresowanie użytkownika na rynku. |
AGE_RANGE |
przedział wiekowy, |
GENDER |
Płeć. |
MarketingDataInsightsAttribute
Statystyki dotyczące kolekcji powiązanych atrybutów tego samego wymiaru.
| Pola | |
|---|---|
user_interest_id |
Identyfikator zainteresowania użytkownika. |
lift |
Miara wzrostu, jaki grupa odbiorców wykazuje w przypadku wartości atrybutu w porównaniu z wartością bazową. Zakres [0–1]. |
age_range |
Przedział wiekowy odbiorców, dla których podany jest wzrost. |
gender |
Płeć odbiorców, dla których podano wzrost. |
RetrieveRequestStatusRequest
Żądanie pobrania stanu żądania wysłanego do interfejsu DM API dla danego identyfikatora żądania. Zwraca wartość RetrieveRequestStatusResponse.
| Pola | |
|---|---|
request_id |
Wymagane. Wymagane. Identyfikator żądania do interfejsu Data Manager API. |
RetrieveRequestStatusResponse
Odpowiedź z RetrieveRequestStatusRequest.
| Pola | |
|---|---|
request_status_per_destination[] |
Lista stanów żądań dla każdego miejsca docelowego. Kolejność stanów odpowiada kolejności miejsc docelowych w pierwotnym żądaniu. |
SearchPartnerLinksRequest
Prośba o wyszukanie zasobów PartnerLink. Zwraca wartość SearchPartnerLinksResponse.
| Pola | |
|---|---|
parent |
Wymagane. Konto, na którym chcesz wyszukać linki partnerów. Jeśli nie podasz wartości Format: |
page_size |
Maksymalna liczba linków partnerskich do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych będzie maksymalnie 10 linków partnerskich. Maksymalna wartość to 100. Wartości powyżej 100 zostaną przekształcone w 100. |
page_token |
Token strony otrzymany z poprzedniego wywołania Podczas paginacji wszystkie inne parametry przekazane do funkcji |
filter |
Opcjonalnie. Ciąg znaków filtra. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. Obsługiwane operacje:
Obsługiwane pola:
Przykład: |
SearchPartnerLinksResponse
Odpowiedź z SearchPartnerLinksRequest.
| Pola | |
|---|---|
partner_links[] |
Linki partnerów do danego konta. |
next_page_token |
Token, który można wysłać jako |
SizeInfo
Szacunkowa liczba użytkowników na tej liście w różnych sieciach docelowych.
| Pola | |
|---|---|
display_network_members_count |
Tylko dane wyjściowe. Szacunkowa liczba użytkowników na tej liście w sieci reklamowej Google. |
search_network_members_count |
Tylko dane wyjściowe. Szacunkowa liczba członków na tej liście użytkowników w domenie google.com. Są to elementy dostępne do kierowania w kampaniach w sieci wyszukiwania. |
youtube_members_count |
Tylko dane wyjściowe. Szacunkowa liczba członków na tej liście użytkowników w YouTube. |
gmail_members_count |
Tylko dane wyjściowe. Szacunkowa liczba użytkowników na tej liście w Gmailu. |
TargetNetworkInfo
Informacje o spełnianiu wymagań w przypadku różnych sieci docelowych.
| Pola | |
|---|---|
eligible_for_display |
Tylko dane wyjściowe. Wskazuje, że ta lista użytkowników kwalifikuje się do użycia w sieci reklamowej Google. |
eligible_for_search |
Opcjonalnie. Wskazuje, czy ta lista użytkowników kwalifikuje się do korzystania z sieci wyszukiwania Google. |
TargetingType
Typ kierowania użyty do wyświetlenia reklamy.
| Wartości w polu enum | |
|---|---|
TARGETING_TYPE_UNSPECIFIED |
Nieokreślony typ kierowania. |
TARGETING_TYPE_AUDIENCE |
Kierowanie na odbiorców. |
TARGETING_TYPE_CONTEXTUAL |
kierowanie kontekstowe; |
TARGETING_TYPE_DEMOGRAPHIC |
kierowanie demograficzne; |
TARGETING_TYPE_DEVICE |
kierowanie na urządzenia; |
TARGETING_TYPE_GEO |
Kierowanie geograficzne. |
TARGETING_TYPE_INTEREST |
Kierowanie na zainteresowania. |
TARGETING_TYPE_PURCHASE_INTENT |
kierowanie na podstawie zamiaru zakupu, |
TARGETING_TYPE_REMARKETING |
kierowanie remarketingowe, |
TermsOfService
Warunki korzystania z usługi, które użytkownik zaakceptował lub odrzucił.
| Pola | |
|---|---|
customer_match_terms_of_service_status |
Opcjonalnie. Warunki korzystania z funkcji kierowania na listę klientów: https://support.google.com/adspolicy/answer/6299717. Musisz zaakceptować te warunki, gdy przesyłasz dane |
TermsOfServiceStatus
Określa, czy rozmówca zaakceptował warunki usługi.
| Wartości w polu enum | |
|---|---|
TERMS_OF_SERVICE_STATUS_UNSPECIFIED |
Nie określono. |
ACCEPTED |
Stan wskazujący, że dzwoniący zaakceptował warunki usługi. |
REJECTED |
Stan wskazujący, że dzwoniący odrzucił warunki usługi. |
UpdateUserListDirectLicenseRequest
Prośba o zaktualizowanie zasobu UserListDirectLicense.
| Pola | |
|---|---|
user_list_direct_license |
Wymagane. Pole |
update_mask |
Opcjonalnie. Lista pól do zaktualizowania. Znak specjalny |
UpdateUserListGlobalLicenseRequest
Prośba o zaktualizowanie zasobu UserListGlobalLicense.
| Pola | |
|---|---|
user_list_global_license |
Wymagane. Pole |
update_mask |
Opcjonalnie. Lista pól do zaktualizowania. Znak specjalny |
UpdateUserListRequest
Wiadomość z prośbą o wywołanie funkcji UpdateUserList.
| Pola | |
|---|---|
user_list |
Wymagane. Lista użytkowników do zaktualizowania. Pole |
update_mask |
Opcjonalnie. Lista pól do zaktualizowania. |
validate_only |
Opcjonalnie. Jeśli wartość to prawda, żądanie jest weryfikowane, ale nie wykonywane. |
UserData
Dane, które identyfikują użytkownika. Wymagany jest co najmniej 1 identyfikator.
| Pola | |
|---|---|
user_identifiers[] |
Wymagane. Identyfikatory użytkownika. Możesz podać wiele instancji tego samego typu danych (np. wiele adresów e-mail). Aby zwiększyć prawdopodobieństwo dopasowania, podaj jak najwięcej identyfikatorów. W jednym elemencie |
UserIdData
Dane identyfikatora użytkownika zawierające identyfikator użytkownika.
| Pola | |
|---|---|
user_id |
Wymagane. Unikalny identyfikator użytkownika zdefiniowany przez reklamodawcę. |
UserIdInfo
Dodatkowe informacje, gdy USER_ID jest jednym z upload_key_types.
| Pola | |
|---|---|
data_source_type |
Opcjonalnie. Wartość niezmienna. Źródło danych przesyłania. |
UserIdentifier
Pojedynczy identyfikator użytkownika.
| Pola | |
|---|---|
Pole zbiorcze identifier. Musisz podać dokładnie jedną wartość. identifier może mieć tylko jedną z tych wartości: |
|
email_address |
Zahaszowany adres e-mail za pomocą funkcji SHA-256 po normalizacji. |
phone_number |
Zahaszowany numer telefonu za pomocą funkcji SHA-256 po normalizacji (standard E164). |
address |
Znane elementy adresu użytkownika. Zawiera grupę identyfikatorów, które są dopasowywane jednocześnie. |
UserList
Materiał związany z listą użytkowników.
| Pola | |
|---|---|
name |
Identyfikator. Nazwa zasobu listy użytkowników. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
id |
Tylko dane wyjściowe. Unikalny identyfikator listy użytkowników. |
read_only |
Tylko dane wyjściowe. Opcja, która określa, czy użytkownik może edytować listę. |
membership_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. |
access_reason |
Tylko dane wyjściowe. Powód, dla którego to konto ma dostęp do listy. |
size_info |
Tylko dane wyjściowe. Szacunkowa liczba użytkowników na tej liście w różnych sieciach docelowych. |
target_network_info |
Opcjonalnie. Informacje o spełnianiu wymagań w przypadku różnych sieci docelowych. |
display_name |
Wymagane. Wyświetlana nazwa listy użytkowników. |
description |
Opcjonalnie. Opis listy użytkowników. |
membership_status |
Opcjonalnie. Stan członkostwa na tej liście użytkowników. |
integration_code |
Opcjonalnie. Identyfikator z systemu zewnętrznego. Jest on używany przez sprzedawców list użytkowników do korelowania identyfikatorów w ich systemach. |
closing_reason |
Tylko dane wyjściowe. Powód zamknięcia stanu członkostwa na liście użytkowników. |
account_access_status |
Opcjonalnie. Wskazuje, czy udostępnianie jest nadal włączone. Gdy lista użytkowników jest udostępniana kontu, to pole ma wartość |
Pole zbiorcze user_list_info. Dodatkowe informacje o liście użytkowników. user_list_info może mieć tylko jedną z tych wartości: |
|
ingested_user_list_info |
Opcjonalnie. Reprezentuje listę użytkowników wypełnianą na podstawie danych przesłanych przez użytkowników. |
AccessReason
Wyliczenie opisujące możliwe przyczyny dostępu.
| Wartości w polu enum | |
|---|---|
ACCESS_REASON_UNSPECIFIED |
Nie określono. |
OWNED |
Zasób jest własnością użytkownika. |
SHARED |
Zasób jest udostępniany użytkownikowi. |
LICENSED |
Zasób jest licencjonowany dla użytkownika. |
SUBSCRIBED |
Użytkownik zasubskrybował zasób. |
AFFILIATED |
Zasób jest dostępny dla użytkownika. |
AccessStatus
Wskazuje, czy ten klient nadal ma dostęp do listy.
| Wartości w polu enum | |
|---|---|
ACCESS_STATUS_UNSPECIFIED |
Nie określono. |
ENABLED |
Dostęp jest włączony. |
DISABLED |
Dostęp jest wyłączony. |
ClosingReason
Wskazuje powód zamknięcia listy użytkowników. Ten typ wyliczeniowy jest używany tylko wtedy, gdy lista jest automatycznie zamykana przez system.
| Wartości w polu enum | |
|---|---|
CLOSING_REASON_UNSPECIFIED |
Nie określono. |
UNUSED |
Lista użytkowników została zamknięta, ponieważ nie była ostatnio używana na potrzeby kierowania. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/2472738. |
MembershipStatus
Stan listy użytkowników.
| Wartości w polu enum | |
|---|---|
MEMBERSHIP_STATUS_UNSPECIFIED |
Nie określono. |
OPEN |
Otwarty – lista użytkowników gromadzi członków i można na nią kierować reklamy. |
CLOSED |
Stan zamknięty – nie są dodawani nowi użytkownicy. |
UserListDirectLicense
Licencja bezpośrednia na listę użytkowników.
Ta funkcja jest dostępna tylko dla partnerów danych.
| Pola | |
|---|---|
name |
Identyfikator. Nazwa zasobu licencji bezpośredniej listy użytkowników. |
user_list_display_name |
Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja. To pole jest tylko do odczytu. |
client_account_display_name |
Tylko dane wyjściowe. Nazwa klienta, któremu licencjonowana jest lista użytkowników. To pole jest tylko do odczytu. |
pricing |
Opcjonalnie. Ceny UserListDirectLicense. |
historical_pricings[] |
Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników. To pole jest tylko do odczytu. |
metrics |
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. |
user_list_id |
Wartość niezmienna. Identyfikator listy użytkowników, na którą przyznawana jest licencja. |
client_account_type |
Wartość niezmienna. Typ konta klienta, na które licencjonowana jest lista użytkowników. |
client_account_id |
Wartość niezmienna. Identyfikator klienta, któremu licencjonowana jest lista użytkowników. |
status |
Opcjonalnie. Stan UserListDirectLicense – ENABLED lub DISABLED. |
UserListGlobalLicense
Licencja globalna na listę użytkowników.
Ta funkcja jest dostępna tylko dla partnerów danych.
| Pola | |
|---|---|
name |
Identyfikator. Nazwa zasobu globalnej licencji na listę użytkowników. |
user_list_display_name |
Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja. To pole jest tylko do odczytu. |
pricing |
Opcjonalnie. Ceny UserListGlobalLicense. |
historical_pricings[] |
Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników. To pole jest tylko do odczytu. |
metrics |
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. |
user_list_id |
Wartość niezmienna. Identyfikator listy użytkowników, na którą przyznawana jest licencja. |
license_type |
Wartość niezmienna. Typ produktu klienta, na który licencjonowana jest lista użytkowników. |
status |
Opcjonalnie. Stan UserListGlobalLicense – ENABLED lub DISABLED. |
UserListGlobalLicenseCustomerInfo
Informacje o kliencie globalnej licencji na listę użytkowników. Zostanie on automatycznie utworzony przez system, gdy klient kupi licencję globalną.
| Pola | |
|---|---|
name |
Identyfikator. Nazwa zasobu klienta z globalną licencją na listę użytkowników. |
user_list_id |
Tylko dane wyjściowe. Identyfikator listy użytkowników, na którą przyznawana jest licencja. |
user_list_display_name |
Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja. |
license_type |
Tylko dane wyjściowe. Typ produktu klienta, na który licencjonowana jest lista użytkowników. |
status |
Tylko dane wyjściowe. Stan UserListDirectLicense – ENABLED lub DISABLED. |
pricing |
Tylko dane wyjściowe. Ceny UserListDirectLicense. |
client_account_type |
Tylko dane wyjściowe. Typ produktu klienta, na który licencjonowana jest lista użytkowników. |
client_account_id |
Tylko dane wyjściowe. Identyfikator klienta, któremu licencjonowana jest lista użytkowników. |
client_account_display_name |
Tylko dane wyjściowe. Nazwa klienta, któremu licencjonowana jest lista użytkowników. |
historical_pricings[] |
Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników. |
metrics |
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. |
UserListGlobalLicenseType
Typy licencji globalnych na listy użytkowników.
| Wartości w polu enum | |
|---|---|
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED |
UNSPECIFIED. |
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER |
Licencja sprzedawcy. |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE |
Licencja DataMart Sell Side. |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE |
Licencja DataMart Buy Side. |
UserListLicenseClientAccountType
Możliwa usługa na koncie klienta w przypadku licencji na listę użytkowników.
| Wartości w polu enum | |
|---|---|
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN |
Brak informacji. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS |
klient Google Ads; |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER |
partnera Display & Video 360. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER |
reklamodawcą Display & Video 360; |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Połączenie z listą odbiorców Google Ad Managera. |
UserListLicenseMetrics
Dane związane z licencją na listę użytkowników.
| Pola | |
|---|---|
click_count |
Tylko dane wyjściowe. Liczba kliknięć w przypadku licencji na listę użytkowników. |
impression_count |
Tylko dane wyjściowe. Liczba wyświetleń licencji na listę użytkowników. |
revenue_usd_micros |
Tylko dane wyjściowe. Przychody z licencji na listę użytkowników w milionowych częściach jednostki. |
start_date |
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 |
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ść |
UserListLicensePricing
Ceny licencji na listę użytkowników.
| Pola | |
|---|---|
pricing_id |
Tylko dane wyjściowe. Identyfikator tego cennika. |
start_time |
Tylko dane wyjściowe. Czas rozpoczęcia obowiązywania ceny. |
end_time |
Opcjonalnie. Czas zakończenia obowiązywania ceny. |
pricing_active |
Tylko dane wyjściowe. Określa, czy te ceny są aktywne. |
buyer_approval_state |
Tylko dane wyjściowe. Stan zatwierdzenia tych cen przez kupującego. To pole jest tylko do odczytu. |
cost_micros |
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 |
Opcjonalnie. Waluta, w której określono koszt i maksymalny koszt. Musi to być trzyliterowy kod waluty zdefiniowany w standardzie ISO 4217. |
cost_type |
Wartość niezmienna. Typ kosztów tej ceny. Można ustawić tylko w operacji |
max_cost_micros |
Opcjonalnie. Maksymalny CPM, jaki może zostać naliczony w przypadku odbiorcó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 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ść |
UserListPricingBuyerApprovalState
Stan zatwierdzenia przez kupującego cen listy użytkowników.
| Wartości w polu enum | |
|---|---|
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED |
UNSPECIFIED. |
PENDING |
Klient listy użytkowników nie zaakceptował jeszcze warunków cenowych określonych przez właściciela listy użytkowników. |
APPROVED |
Klient listy użytkowników zaakceptował warunki cenowe ustalone przez właściciela listy użytkowników. |
REJECTED |
Klient listy użytkowników odrzucił warunki cenowe ustalone przez właściciela listy użytkowników. |
UserListPricingCostType
Typ kosztu ceny listy użytkowników.
| Wartości w polu enum | |
|---|---|
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED |
Nie określono. |
CPC |
koszt kliknięcia, |
CPM |
Koszt tysiąca wyświetleń. |
MEDIA_SHARE |
Udostępnianie multimediów. |
UserListLicenseStatus
Stan licencji listy użytkowników.
| Wartości w polu enum | |
|---|---|
USER_LIST_LICENSE_STATUS_UNSPECIFIED |
Brak informacji. |
USER_LIST_LICENSE_STATUS_ENABLED |
Stan aktywny – lista użytkowników jest nadal licencjonowana. |
USER_LIST_LICENSE_STATUS_DISABLED |
Stan nieaktywny – lista użytkowników nie jest już licencjonowana. |
UserProperties
Informacje o użytkowniku ocenione przez reklamodawcę w momencie wystąpienia zdarzenia. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/14007601.
| Pola | |
|---|---|
customer_type |
Opcjonalnie. Typ klienta powiązanego ze zdarzeniem. |
customer_value_bucket |
Opcjonalnie. Wartość klienta określona przez reklamodawcę. |
additional_user_properties[] |
Opcjonalnie. Zbiór dodatkowych właściwości użytkownika powiązanych z tym zdarzeniem. |
UserProperty
Zbiór dodatkowych właściwości użytkownika powiązanych z tym zdarzeniem.
| Pola | |
|---|---|
property_name |
Wymagane. Nazwa właściwości użytkownika do użycia. |
value |
Wymagane. Ciąg znaków reprezentujący wartość właściwości użytkownika do użycia. |
ViewType
Typ zdarzenia.
| Wartości w polu enum | |
|---|---|
VIEW_TYPE_UNSPECIFIED |
Nieokreślony typ widoku. |
VIEW_TYPE_MRC_VIEWED |
Wyświetlono według MRC. |
VIEW_TYPE_MRC_RENDERED |
MRC rendered. |
ViewabilityInfo
Szczegóły widoczności wyświetlonej reklamy.
| Pola | |
|---|---|
view_type |
Wymagane. Typ zdarzenia. |
viewable_percent |
Opcjonalnie. Procentowa wartość liczbowa (0–100) pikseli, które były widoczne. |
viewable_duration |
Opcjonalnie. Czas, przez jaki reklama była widoczna. |
media_skippable |
Opcjonalnie. Czy treści reklamowe można było pominąć. |
media_quartile |
Opcjonalnie. Ilość odtworzonych multimediów w postaci dyskretnych kwartyli. |
media_duration |
Opcjonalnie. Czas trwania treści reklamowych. |
media_volume_percent |
Opcjonalnie. Procentowa wartość liczbowa (0–100) głośności odtwarzania multimediów. |
playback_duration |
Opcjonalnie. Czas trwania odtwarzania treści reklamy, niezależnie od tego, czy była ona widoczna. |
WarningCount
Liczba ostrzeżeń dla danego powodu ostrzeżenia.
| Pola | |
|---|---|
record_count |
Liczba rekordów, które zawierają ostrzeżenie. |
reason |
Powód ostrzeżenia. |
WarningInfo
Liczba ostrzeżeń dla każdego typu ostrzeżenia.
| Pola | |
|---|---|
warning_counts[] |
Lista ostrzeżeń i liczba ostrzeżeń według przyczyny. |