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)FieldWarning(komunikat)GcpWrappedKeyInfo(komunikat)GcpWrappedKeyInfo.KeyType(wyliczenie)Gender(wyliczenie)GetUserListDirectLicenseRequest(komunikat)GetUserListGlobalLicenseRequest(komunikat)GetUserListRequest(komunikat)GoogleUserIdData(komunikat)IngestAdEventsRequest(komunikat)IngestAdEventsResponse(komunikat)IngestAudienceMembersRequest(komunikat)IngestAudienceMembersResponse(komunikat)IngestEventsRequest(komunikat)IngestEventsResponse(komunikat)IngestUsersRequest(komunikat)IngestUsersResponse(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)PartnerProvidedIdData(komunikat)Platform(wyliczenie)PlatformType(wyliczenie)PpidData(komunikat)ProcessingErrorReason(wyliczenie)ProcessingWarningReason(wyliczenie)Product(enum) (deprecated)ProductAccount(komunikat)ProductAccount.AccountType(wyliczenie)PseudonymousIdInfo(komunikat)PseudonymousIdInfo.SyncStatus(wyliczenie)RemoveAllAudienceMembersRequest(komunikat)RemoveAllAudienceMembersResponse(komunikat)RemoveAudienceMembersRequest(komunikat)RemoveAudienceMembersResponse(komunikat)RemoveUsersRequest(komunikat)RemoveUsersResponse(komunikat)RequestStatusPerDestination(komunikat)RequestStatusPerDestination.DataType(wyliczenie)RequestStatusPerDestination.DataTypeCount(komunikat)RequestStatusPerDestination.IngestAudienceMembersStatus(komunikat)RequestStatusPerDestination.IngestCompositeDataStatus(komunikat)RequestStatusPerDestination.IngestEventsStatus(komunikat)RequestStatusPerDestination.IngestGoogleUserIdDataStatus(komunikat)RequestStatusPerDestination.IngestMobileDataStatus(komunikat)RequestStatusPerDestination.IngestPairDataStatus(komunikat)RequestStatusPerDestination.IngestPartnerProvidedIdDataStatus(komunikat)RequestStatusPerDestination.IngestPpidDataStatus(komunikat)RequestStatusPerDestination.IngestUserDataStatus(komunikat)RequestStatusPerDestination.IngestUserIdDataStatus(komunikat)RequestStatusPerDestination.RemoveAllAudienceMembersStatus(komunikat)RequestStatusPerDestination.RemoveAudienceMembersStatus(komunikat)RequestStatusPerDestination.RemoveCompositeDataStatus(komunikat)RequestStatusPerDestination.RemoveGoogleUserIdDataStatus(komunikat)RequestStatusPerDestination.RemoveMobileDataStatus(komunikat)RequestStatusPerDestination.RemovePairDataStatus(komunikat)RequestStatusPerDestination.RemovePartnerProvidedIdDataStatus(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)User(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)WarningReason(wyliczenie)
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ę
|
| IngestEvents |
|---|
|
Przesyła listę zasobów
|
| IngestUsers |
|---|
|
Przesyła listę użytkowników do podanych miejsc docelowych. W przeciwieństwie do Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.
|
| RemoveAllAudienceMembers |
|---|
|
Usuwa wszystkich członków listy odbiorców z podanych miejsc docelowych.
|
| RemoveAudienceMembers |
|---|
|
Usuwa listę zasobów
|
| RemoveUsers |
|---|
|
Usuwa listę użytkowników z podanych miejsc docelowych. Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.
|
| 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 ds. danych.
| RetrieveInsights |
|---|
|
Pobiera statystyki dotyczące danych marketingowych dla danej listy użytkowników. Ta funkcja jest dostępna tylko dla partnerów ds. 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 do podanego 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 połączenie z kontem 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:
|
| 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ługiwane w przypadku UserListDirectLicenses. Aby zamiast tego dezaktywować licencję, dzwoniący powinni zaktualizować stan licencji na DISABLED.
Ta funkcja jest dostępna tylko dla partnerów ds. danych.
| CreateUserListDirectLicense |
|---|
|
Tworzy licencję bezpośrednią na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów ds. danych.
|
| GetUserListDirectLicense |
|---|
|
Pobiera bezpośrednią licencję na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów ds. danych.
|
| ListUserListDirectLicenses |
|---|
|
Zawiera listę wszystkich licencji bezpośrednich na listy użytkowników należących do konta nadrzędnego. Ta funkcja jest dostępna tylko dla partnerów ds. danych.
|
| UpdateUserListDirectLicense |
|---|
|
Aktualizuje licencję bezpośrednią na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów ds. danych.
|
UserListGlobalLicenseService
Usługa do zarządzania globalnymi licencjami na listy użytkowników. Usuwanie nie jest obsługiwaną operacją w przypadku UserListGlobalLicenses. Aby zamiast tego dezaktywować licencję, dzwoniący powinni zaktualizować stan licencji na DISABLED.
Ta funkcja jest dostępna tylko dla partnerów ds. danych.
| CreateUserListGlobalLicense |
|---|
|
Tworzy globalną licencję na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów ds. danych.
|
| GetUserListGlobalLicense |
|---|
|
Pobiera globalną licencję na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów ds. danych.
|
| ListUserListGlobalLicenseCustomerInfos |
|---|
|
Zawiera wszystkie informacje o klientach na potrzeby globalnej licencji na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów ds. danych.
|
| ListUserListGlobalLicenses |
|---|
|
Zawiera listę wszystkich globalnych licencji na listy użytkowników należących do konta nadrzędnego. Ta funkcja jest dostępna tylko dla partnerów ds. danych.
|
| UpdateUserListGlobalLicense |
|---|
|
Aktualizuje globalną licencję na listę użytkowników. Ta funkcja jest dostępna tylko dla partnerów ds. 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 przesł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ń reklamowych, 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 znalezienia dopasowania. |
device_info |
Wymagane. Informacje zebrane o urządzeniu używanym w momencie wystąpienia zdarzenia reklamowego. |
ip_address |
Opcjonalnie: Adres IP używany do pomiaru. Musi mieć taką samą wartość jak |
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 |
Opcjonalnie: Kraj i podział podrzędny w formacie ISO 3166-2. |
source |
Wymagane. Platforma źródłowa reklamy, podobna do źródła w Google Analytics. |
medium |
Wymagane. Rodzaj reklamy, podobny do rodzaju w Google Analytics. |
attribution_hint |
Opcjonalnie: Stan atrybucji przyjęty przez partnera w przypadku tego zdarzenia reklamowego. Służy to tylko jako sygnał informujący o tym, jak partner założył, że przebiegała atrybucja, i nie wymusza ostatecznego wyniku w raportach końcowych. |
viewability_info |
Wymagane. Szczegóły widoczności wyświetlonej reklamy. |
Pole zbiorcze Aby obsługiwać wartości inne niż czyste wyliczenia, akceptowany jest surowy ciąg znaków. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
event_subtype |
Wartość typu wyliczeniowego podtypu zdarzenia. |
event_subtype_string |
Wartość ciągu podtypu zdarzenia. |
Pole zbiorcze Aby obsługiwać wartości inne niż czyste wyliczenia, akceptowany jest surowy ciąg znaków. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
ad_type |
Wartość typu wyliczeniowego dla typu reklamy. |
ad_type_string |
Wartość ciągu typu reklamy. |
Pole zbiorcze Aby obsługiwać wartości inne niż czyste wyliczenia, akceptowany jest surowy ciąg znaków. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
ad_format |
Wartość typu wyliczeniowego formatu reklamy. |
ad_format_string |
Wartość ciągu tekstowego formatu reklamy. |
Pole zbiorcze Aby obsługiwać wartości inne niż czyste wyliczenia, akceptowany jest surowy ciąg znaków. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
ad_placement |
Wartość wyliczeniowa miejsca docelowego reklamy. |
ad_placement_string |
Ciąg znaków określający miejsce docelowe reklamy. |
Pole zbiorcze Aby obsługiwać wartości inne niż czyste wyliczenia, akceptowany jest surowy ciąg znaków. 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 Aby obsługiwać wartości inne niż czyste wyliczenia, akceptowany jest surowy ciąg znaków. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
platform_type |
Wartość typu wyliczeniowego dla typu platformy. |
platform_type_string |
Wartość ciągu dla typu platformy. |
Pole zbiorcze Aby obsługiwać wartości inne niż czyste wyliczenia, akceptowany jest surowy ciąg znaków. Jeśli to możliwe, preferowany jest typ wyliczeniowy. Pole |
|
platform |
Wartość typu enum dla 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 typu wyświetlenie angażujące. |
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 |
reklamy 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 urządzeniu używanym (jeśli dotyczy) w momencie wejścia na stronę 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 reklamy 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. |
ppid |
Opcjonalnie: Unikalny identyfikator uwierzytelnionego (zalogowanego) użytkownika zdefiniowany przez wydawcę. |
visitor_ppid |
Opcjonalnie: Unikalny identyfikator nieuwierzytelnionego użytkownika (który nie jest zalogowany) zdefiniowany przez wydawcę. |
AdPlacement
Miejsce docelowe wyświetlonej reklamy.
| Wartości w polu enum | |
|---|---|
AD_PLACEMENT_UNSPECIFIED |
Nieokreślone miejsce docelowe reklamy. |
AD_PLACEMENT_DISCOVER |
Reklamy Discover w miejscach docelowych. |
AD_PLACEMENT_FEED |
umieszczenie w kanale, |
AD_PLACEMENT_FOOTER |
Umieszczenie w stopce. |
AD_PLACEMENT_HEADER |
Umieszczenie w nagłówku. |
AD_PLACEMENT_HOME |
Miejsce docelowe na stronie głównej. |
AD_PLACEMENT_IN_CONTENT |
Miejsce docelowe w treści. |
AD_PLACEMENT_PROMOTED |
Promowane miejsce docelowe. |
AD_PLACEMENT_SEARCH |
Miejsce docelowe w wyszukiwarce. |
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 (pisane małymi literami, bez znaków interpunkcyjnych, bez spacji na początku i na końcu, zahaszowane za pomocą SHA-256). |
region_code |
Wymagane. Dwuliterowy kod regionu w formacie ISO-3166-1 alfa-2 z adresu użytkownika. |
postal_code |
Wymagane. Kod pocztowy w adresie użytkownika. |
address_line |
Opcjonalnie: Ulica i numer adresu użytkownika. Używane tylko w Google Analytics. To pole jest haszowane i prawdopodobnie szyfrowane. Znormalizuj wartość przed zaszyfrowaniem:
|
city |
Opcjonalnie: Miejscowość w adresie użytkownika. Używane tylko w Google Analytics. Wartość powinna być znormalizowana w ten sposób:
|
administrative_area |
Opcjonalnie: Region (stan/prowincja) w adresie użytkownika. Używane tylko w Google Analytics. Wartość powinna być znormalizowana w ten sposób:
|
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 |
mieć od 18 do 24 lat; |
AGE_RANGE_25_34 |
25–34 lata. |
AGE_RANGE_35_44 |
35–44 lata |
AGE_RANGE_45_54 |
45–54 lata. |
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 zostać 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 ds. 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 ds. danych. |
composite_data |
Grupa wielu typów identyfikatorów. |
google_user_id_data |
zaszyfrowane identyfikatory użytkowników Google; |
partner_provided_id_data |
Identyfikatory podawane przez partnera. |
AwsWrappedKeyInfo
Klucz szyfrujący dane obudowany przez klucz AWS KMS.
| Pola | |
|---|---|
key_type |
Wymagane. Typ algorytmu użytego do zaszyfrowania danych. |
role_arn |
Wymagane. Nazwa zasobu Amazon roli uprawnień, która ma być przyjmowana na potrzeby dostępu do odszyfrowywania 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 odniesienia, 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 odniesienia żądania. Lokalizacja odniesienia to lista regionów połączonych operatorem LUB. |
location_auto_detection_enabled |
Jeśli ta opcja jest ustawiona na „true”, usługa spróbuje automatycznie wykryć lokalizację bazową dla statystyk. |
Lokalizacja
Lokalizacja odniesienia żądania. Lokalizacja podstawowa znajduje się na liście OR kodów regionów ISO 3166-1 alfa-2 w przypadku żą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. 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, które zostały użyte do utworzenia listy odbiorców. |
Zgoda
Ustawienia dotyczące zgody wymaganej przez akt o rynkach cyfrowych (DMA) w przypadku użytkownika.
| 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 też 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 danych przesyłania |
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, który jest właścicielem tej kolekcji linków do partnerów. Format: accountTypes/{account_type}/accounts/{account} |
partner_link |
Wymagane. Link partnerski 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ą na tworzenie. |
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 ma wysoką wartość. |
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 kredytowego. |
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE |
Przesłane dane pochodzą z pliku wyborców dostarczonego przez osobę trzecią. |
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 partnerskiego do usunięcia. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
DeleteUserListRequest
Komunikat z prośbą o usunięcie listy użytkowników.
| 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ługa 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 wywołania tego 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 |
Opcjonalnie: 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. To pole jest opcjonalne w przypadku pozyskiwania zdarzeń z Google Ad Managera i pozyskiwania danych o użytkownikach. Wymagane w przypadku wszystkich innych zastosowań. |
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. Wymagane, gdy jest używane w |
category |
Opcjonalnie: Kategoria urządzenia. Na przykład „komputer”, „tablet”, „komórka”, „telewizor smart TV”. |
language_code |
Opcjonalnie: Język, w którym urządzenie jest używane, 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 tej metody, wszystkie pola są wymagane.
| Pola | |
|---|---|
encrypted_id |
Wymagane. Alfanumeryczny zaszyfrowany identyfikator. |
entity_type |
Wymagane. Typ elementu szyfrowania. Powinno to być zgodne z konfiguracją szyfrowania na potrzeby wyświetlania reklam lub przenoszenia danych. |
entity_id |
Wymagane. Identyfikator jednostki szyfrującej. 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 elementu szyfrowania.
| Wartości w polu enum | |
|---|---|
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED |
Nieokreślony typ elementu szyfrowania. |
CAMPAIGN_MANAGER_ACCOUNT |
konto Campaign Managera 360, |
CAMPAIGN_MANAGER_ADVERTISER |
reklamodawcą w usłudze Campaign Manager 360. |
DISPLAY_VIDEO_PARTNER |
partnera Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
reklamodawca w 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. Zapakowany klucz używany do szyfrowania 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 z danego powodu.
| 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. Może nie być wypełnione we wszystkich przypadkach. |
ErrorReason
Przyczyny błędów interfejsu Data Manager API. UWAGA: ten wyliczenie nie jest zamrożone i w przyszłości mogą zostać 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 |
Żądanie trwało zbyt długo. |
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 |
Nieprawidłowy format. |
INVALID_HEX_ENCODING |
Wartość zakodowana w systemie 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 jednym żądaniu 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 dokumentu Mobile ID 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ć wielu typów danych. |
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 włączono konwersji rozszerzonych dotyczących 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 korzystania z konwersji rozszerzonych. |
DUPLICATE_DESTINATION_REFERENCE |
Co najmniej 2 miejsca docelowe w żądaniu mają tę samą referencję. |
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER |
Nieobsługiwane konto dostawcy danych na potrzeby autoryzacji. |
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER |
Nieobsługiwane połączone konto do autoryzacji dostawcy danych. |
NO_IDENTIFIERS_PROVIDED |
Dane zdarzeń nie zawierają identyfikatorów użytkowników ani identyfikatorów reklam. W przypadku pozyskiwania 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 jest nieobsługiwana. |
NOT_ALLOWLISTED |
Konto nie znajduje się na liście dozwolonych w przypadku danej 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 |
Za mało elementów na liście w żądaniu. |
ALREADY_EXISTS |
Zasób już istnieje. |
IMMUTABLE_FIELD_FOR_UPDATE |
Podjęto próbę ustawienia niezmiennego pola w przypadku prośby 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 różnego od zera. |
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 |
Nie można licencjonować logicznej listy użytkowników z udostępnianym lub licencjonowanym segmentem. |
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 |
Listę 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 |
Użytkownicy zewnętrzni nie mogą zmieniać list odbiorców, które są wrażliwe pod względem prywatności lub zostały odrzucone z przyczyn prawnych. |
BILLABLE_RECORD_COUNT_IMMUTABLE |
Po ustawieniu pola rekordu, za które naliczane są opłaty 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 znajdować się na liście dozwolonych użytkowników. |
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 odbiorców Dopasowywania partnerów nie można tworzyć na kontach menedżera. |
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
Dostawca danych nie jest na liście dozwolonych dla THIRD_PARTY_PARTNER_DATA. |
ADVERTISER_TOS_NOT_ACCEPTED |
Reklamodawca nie zaakceptował warunków korzystania z usługi partnera. |
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
Reklamodawca nie jest na liście dozwolonych dla danych THIRD_PARTY_PARTNER_DATA. |
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 przetworzonej liście użytkowników 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 linku partnerskiego. |
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 funkcji 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 parametry 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 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 pasującej do podanego wzorca variable. |
TOO_MANY_USERS |
Maksymalna dozwolona liczba użytkowników na żądanie to 10 000. |
BASELINE_LOCATION_AUTO_DETECTION_FAILED |
Pole location_auto_detection_enabled w żądaniu miało wartość true, ale automatyczne wykrywanie lokalizacji odniesienia nie powiodło się. |
INSIGHTS_MISSING_FOR_DIMENSION |
Brak statystyk dotyczących tego wymiaru. |
REQUIRED_PREREQUISITE_LINK_MISSING |
Aby wykonać tę operację, usługa w Google Analytics musi mieć wymagane połączenie wstępne (np. połączenie z Google Ads). |
INVALID_REMOVE_AS_OF_TIME |
Czas usunięcia musi przypadać w przeszłości lub teraźniejszości. W przypadku usuwania odbiorców nie można używać sygnatur czasowych z przyszłości. |
REQUEST_TOO_OLD |
Stan żądania jest dostępny tylko przez około 50 dni od momentu otrzymania żądania przez interfejs API. |
CONVERSION_ACTION_TOO_RECENTLY_CREATED |
Działanie powodujące konwersję zostało utworzone zbyt niedawno. |
INVALID_AD_IDENTIFIER_FOR_ACCOUNT |
Identyfikator reklamy nie należy do konta. Na przykład |
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, aplikacji, sklepie stacjonarnym itp.). |
event_device_info |
Opcjonalnie: Informacje zebrane o używanym urządzeniu (jeśli takie są dostępne) 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ą zostać włączone do interfejsu API. |
user_properties |
Opcjonalnie: Informacje o użytkowniku w momencie wystąpienia zdarzenia, które zostały ocenione przez reklamodawcę. |
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 korzystającego z danych własnych. |
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 miało miejsce zdarzenie. |
subdivision_code |
Opcjonalnie: Kod pododdziału zgodny z normą ISO 3166-2, w którym wystąpiło zdarzenie. |
region_code |
Opcjonalnie: Dwuliterowy 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 dla 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 |
Zdarzenie zostało wygenerowane z innych źródeł. |
ExperimentalField
Pole eksperymentalne 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 podasz żadnej wartości, 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. |
FieldWarning
Szczegółowe ostrzeżenie na poziomie wiersza ze ścieżkami pól.
| Pola | |
|---|---|
reason |
Powód ostrzeżenia. |
description |
Szczegółowy komunikat z ostrzeżeniem opisujący problem. |
field |
Ścieżka pola, która wywołała ostrzeżenie. Użyj tego samego formatu co w polu |
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 (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 GetUserList.
| Pola | |
|---|---|
name |
Wymagane. Nazwa zasobu listy użytkowników do pobrania. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
GoogleUserIdData
Dane identyfikatora użytkownika Google zawierające zaszyfrowane identyfikatory użytkowników Google. Wymagany jest co najmniej 1 identyfikator użytkownika Google.
| Pola | |
|---|---|
google_user_ids[] |
Wymagane. Lista zaszyfrowanych identyfikatorów użytkowników Google. |
IngestAdEventsRequest
Żądanie przesłania zdarzeń związanych z reklamami.
| Pola | |
|---|---|
ad_events[] |
Wymagane. Wymagany (co najmniej 1). Lista zdarzeń związanych z reklamami. |
encryption_info |
Opcjonalnie: Informacje o kluczach szyfrowania używanych do szyfrowania danych. To pole musi być podane, gdy zdarzenia związane z reklamami zawierają wartość |
validate_only |
Opcjonalnie: Jeśli wartość to prawda, żądanie jest weryfikowane, ale nie wykonywane. |
IngestAdEventsResponse
Ten typ nie ma pól.
Odpowiedź z operacji wczytywania 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 informacje do określonych miejsc docelowych. W jednym żądaniu można przesłać maksymalnie 10 tys. 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 wartość to |
encoding |
Opcjonalnie: Wymagane w przypadku przesyłania plików |
encryption_info |
Opcjonalnie: Informacje o szyfrowaniu przesyłanych plików w domenie |
terms_of_service |
Opcjonalnie: Warunki usługi, które użytkownik zaakceptował lub odrzucił. |
IngestAudienceMembersResponse
Odpowiedź z IngestAudienceMembersRequest.
| Pola | |
|---|---|
request_id |
Automatycznie wygenerowany identyfikator prośby. |
field_warnings[] |
Szczegółowe ostrzeżenia na poziomie wiersza ze ścieżkami pól. |
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 przesł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 wartość to |
encoding |
Opcjonalnie: Wymagane w przypadku przesyłania plików |
encryption_info |
Opcjonalnie: Informacje o szyfrowaniu przesyłanych plików w domenie |
IngestEventsResponse
Odpowiedź z IngestEventsRequest.
| Pola | |
|---|---|
request_id |
Automatycznie wygenerowany identyfikator prośby. |
field_warnings[] |
Szczegółowe ostrzeżenia na poziomie wiersza ze ścieżkami pól. |
IngestUsersRequest
Prośba o przesłanie użytkowników do podanych miejsc docelowych.
| Pola | |
|---|---|
destinations[] |
Wymagane. Lista możliwych miejsc docelowych pozyskiwania danych. |
users[] |
Wymagane. Lista użytkowników do przetworzenia. |
encryption_info |
Opcjonalnie: Informacje o szyfrowaniu kluczy szyfrowania używanych do szyfrowania danych. |
validate_only |
Opcjonalnie: Jeśli wartość to |
encoding |
Wymagane. Typ kodowania identyfikatorów użytkowników. W przypadku zaszyfrowanych identyfikatorów użytkowników dotyczy to tylko kodowania zewnętrznego. |
IngestUsersResponse
Odpowiedź na żądanie IngestUsersRequest.
| Pola | |
|---|---|
request_id |
Wygenerowany identyfikator żądania dotyczącego przesyłania danych. |
IngestedUserListInfo
Reprezentuje listę użytkowników wypełnianą danymi przekazywanymi 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 ds. 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 ds. 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 inne firmy. |
PAIR_ID |
Identyfikatory dopasowywania danych o tożsamości użytkowników. |
PSEUDONYMOUS_ID |
Identyfikatory platformy zarządzania danymi:
|
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 klienta. 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 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 służący do odwoływania się do elementu. |
additional_item_parameters[] |
Opcjonalnie: Zbiór dowolnych 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 zastąpi to wartość ustawioną na poziomie koszyka. W przypadku innych zdarzeń to pole jest ignorowane. |
merchant_feed_label |
Opcjonalnie: Etykieta pliku danych Merchant Center. Jeśli kraje są nadal używane, zamiast nich można użyć 2-literowego kodu kraju w formacie ISO-3166-1 alfa-2. W przypadku zdarzeń związanych ze sprzedażą w sklepie stacjonarnym zastąpi to 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 w postaci pary 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 produktem w ramach zdarzenia w przypadku, gdy wartość konwersji jest inna dla każdego produktu. |
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 dowolnych 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 licencje są sprawdzane. 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 pozostałe 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
Prośba o wyświetlenie wszystkich zasobów UserListGlobalLicenseCustomerInfo na liście użytkowników z globalną licencją.
| Pola | |
|---|---|
parent |
Wymagane. Licencja globalna, której informacje o kliencie są sprawdzane. 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 pozostałe parametry przekazane do funkcji |
ListUserListGlobalLicenseCustomerInfosResponse
Odpowiedź na [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].
| Pola | |
|---|---|
user_list_global_license_customer_infos[] |
Informacje o kliencie dla 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 licencje są sprawdzane. 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 pozostałe 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 podana, 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 pozostałe 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ść z 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 |
Zakres współczynnika dopasowania wynosi 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 |
Zakres współczynnika dopasowania wynosi 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 urządzenia mobilnego.
| Pola | |
|---|---|
mobile_ids[] |
Wymagane. Lista identyfikatorów urządzeń mobilnych (identyfikatorów wyświetlania reklam na urządzeniach z Androidem, identyfikatorów IDFA w iOS w przypadku list użytkowników kierowanych na listę klientów oraz identyfikatorów wyświetlania reklam na urządzeniach z Androidem, identyfikatorów IDFA w iOS, identyfikatorów Xbox lub Microsoft, identyfikatorów Amazon Fire TV, identyfikatorów Roku i ogólnych identyfikatorów urządzeń w przypadku podstawowych list użytkowników). 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 przesyłanych danych. |
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
Obszar kluczy dla dokumentu tożsamości na urządzeniu mobilnym.
| Wartości w polu enum | |
|---|---|
KEY_SPACE_UNSPECIFIED |
Nie określono. |
IOS |
Przestrzeń kluczy iOS. |
ANDROID |
Przestrzeń kluczy Androida. |
PairData
Identyfikatory PAIR na liście odbiorców. Wymagany jest co najmniej 1 identyfikator PAIR.
Ta funkcja jest dostępna tylko dla partnerów ds. danych.
| Pola | |
|---|---|
pair_ids[] |
Wymagane. Dane umożliwiające identyfikację dostarczone przez usługę data clean room, zaszyfrowane algorytmem SHA256 i zaszyfrowane za pomocą przemiennego szyfru EC z użyciem 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 ds. danych.
| Pola | |
|---|---|
publisher_id |
Wymagane. Wartość niezmienna. Identyfikuje wydawcę, z którym jest dopasowywana lista użytkownikó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 członkostwa tej listy użytkowników do odpowiednich danych własnych 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ług data clean room. |
PartnerAudienceInfo
Dodatkowe informacje o odbiorcach partnerów.
Ta funkcja jest dostępna tylko dla partnerów ds. 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 właściciela 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 jest właścicielem konta partnera i przyznaje do niego dostęp. |
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 podasz żadnej wartości, 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. |
PartnerProvidedIdData
Dane podawane przez partnera zawierające identyfikatory podawane przez partnera. Wymagany jest co najmniej 1 identyfikator dostarczony przez partnera.
| Pola | |
|---|---|
partner_provided_ids[] |
Wymagane. Lista identyfikatorów podanych przez partnera. |
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świetliła się reklama.
| 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 ds. 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 |
Dane użytkownika na potrzeby reklamy są odrzucane przez użytkownika lub w ustawieniach domyślnych reklamodawcy. |
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 występuje 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 |
Na koncie docelowym nie podpisano warunków korzystania z konwersji rozszerzonych. |
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 minimalnego progu. |
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 |
WIP jest nieprawidłowo sformatowany 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 puli tożsamości, ponieważ została odrzucona przez warunek atestu. |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
System nie miał uprawnień niezbędnych 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 meczu. |
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 |
Niektóre identyfikatory reklam są nieprawidłowe. |
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 udało się 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 z nim 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 miejsca docelowego. |
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND |
Nie udało się znaleźć pasującego kliknięcia na podstawie 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
Przyczyna ostrzeżenia o przetwarzaniu.
| 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ń niezbędnych 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 puli tożsamości, ponieważ została odrzucona przez warunek atestu. |
PROCESSING_WARNING_REASON_INVALID_WIP |
WIP jest nieprawidłowo sformatowany 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 . Reprezentuje konkretną usługę Google.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 |
reklamodawca w 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 |
reklamodawca w Display & Video 360; |
DATA_PARTNER |
Dostawca danych. |
GOOGLE_ANALYTICS_PROPERTY |
Google Analytics. |
GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Połączenie z odbiorcami Google Ad Managera. |
FLOODLIGHT_CONFIG |
Konfiguracja Floodlight. |
GOOGLE_AD_MANAGER |
Google Ad Manager, |
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 synchronizowania zawartości lub metadanych listy użytkowników wystąpił błąd. Nie można użyć listy użytkowników. |
RemoveAllAudienceMembersRequest
Prośba o usunięcie wszystkich użytkowników z listy odbiorców w podanych miejscach docelowych. Zwraca wartość RemoveAllAudienceMembersResponse.
| Pola | |
|---|---|
destinations[] |
Wymagane. Lista miejsc docelowych, z których chcesz usunąć użytkowników. |
remove_as_of_time |
Opcjonalnie: Czas usunięcia. Jeśli ta opcja jest ustawiona, usunięci zostaną tylko członkowie listy odbiorców dodani ostatnio przed tym czasem. Jeśli nie jest ustawiony, przyjmuje się domyślnie bieżący czas. Czas usunięcia nie może przypadać w przyszłości. |
validate_only |
Opcjonalnie: Do celów testowych. Jeśli wartość to |
RemoveAllAudienceMembersResponse
Odpowiedź z RemoveAllAudienceMembersRequest.
| Pola | |
|---|---|
request_id |
Automatycznie wygenerowany identyfikator prośby. |
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 wartość to |
encoding |
Opcjonalnie: Wymagane w przypadku przesyłania plików |
encryption_info |
Opcjonalnie: Informacje o szyfrowaniu przesyłanych plików w domenie |
RemoveAudienceMembersResponse
Odpowiedź z RemoveAudienceMembersRequest.
| Pola | |
|---|---|
request_id |
Automatycznie wygenerowany identyfikator prośby. |
RemoveUsersRequest
Prośba o usunięcie użytkowników z podanych miejsc docelowych.
| Pola | |
|---|---|
destinations[] |
Wymagane. Lista możliwych miejsc docelowych pozyskiwania danych. |
user_data[] |
Wymagane. Poszczególne części danych UserData, które działają jako klucze do usunięcia przez użytkowników. |
encryption_info |
Opcjonalnie: Informacje o szyfrowaniu kluczy szyfrowania używanych do szyfrowania danych. |
validate_only |
Opcjonalnie: Jeśli wartość to |
encoding |
Wymagane. Typ kodowania identyfikatorów użytkowników. W przypadku zaszyfrowanych identyfikatorów użytkowników dotyczy to tylko kodowania zewnętrznego. |
RemoveUsersResponse
Odpowiedź na RemoveUsersRequest.
| Pola | |
|---|---|
request_id |
Wygenerowany identyfikator żądania dotyczącego przesyłania danych. |
RequestStatusPerDestination
Stan prośby 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 nie jest wypełniane, gdy żądanie ma |
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 usługi. |
audience_members_removal_status |
Stan żądania usunięcia członków listy odbiorców. |
remove_all_audience_members_status |
Stan prośby o usunięcie wszystkich użytkowników z listy 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 członków 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 w miejscu docelowym. |
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. |
google_user_id_data_ingestion_status |
Stan pozyskiwania danych identyfikatora użytkownika Google w miejscu docelowym. |
partner_provided_id_data_ingestion_status |
Stan pozyskiwania danych identyfikatorów dostarczonych przez partnera do miejsca docelowego. |
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 przesył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. |
IngestGoogleUserIdDataStatus
Stan pozyskiwania danych identyfikatora użytkownika Google 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 oni prawidłowo przetworzeni. |
google_user_id_count |
Łączna liczba identyfikatorów użytkowników Google wysłanych w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory użytkowników Google w żądaniu, niezależnie od tego, czy zostały one 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 oni prawidłowo 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 oni prawidłowo 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. |
IngestPartnerProvidedIdDataStatus
Stan pozyskiwania danych identyfikatora dostarczonych przez partnera 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. |
partner_provided_id_count |
Łączna liczba identyfikatorów dostarczonych przez partnera, które zostały wysłane w żądaniu przesyłania do miejsca docelowego. Obejmuje wszystkie identyfikatory dostarczone przez partnera 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 oni prawidłowo 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 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 oni prawidłowo 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. |
RemoveAllAudienceMembersStatus
Ten typ nie ma pól.
Stan prośby o usunięcie wszystkich użytkowników z listy odbiorców.
RemoveAudienceMembersStatus
Stan żądania usunięcia członków listy 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 pary 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. |
google_user_id_data_removal_status |
Stan usunięcia danych identyfikatora użytkownika Google z miejsca docelowego. |
partner_provided_id_data_removal_status |
Stan usuwania danych identyfikatora dostarczonych przez partnera 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 członków listy 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. |
RemoveGoogleUserIdDataStatus
Stan usunięcia danych identyfikatora użytkownika Google z miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
google_user_id_count |
Łączna liczba identyfikatorów użytkowników Google przesłanych w żądaniu usunięcia. Obejmuje wszystkie identyfikatory użytkowników Google 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 członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
mobile_id_count |
Łączna liczba identyfikatorów urządzeń mobilnych przesł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 pary z miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich członków listy 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 one usunięte. |
RemovePartnerProvidedIdDataStatus
Stan usuwania danych identyfikatora dostarczonych przez partnera z miejsca docelowego.
| Pola | |
|---|---|
record_count |
Łączna liczba członków listy odbiorców wysłanych w żądaniu usunięcia. Obejmuje wszystkich członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
partner_provided_id_count |
Łączna liczba identyfikatorów przesłanych przez partnera w żądaniu usunięcia. Obejmuje wszystkie identyfikatory dostarczone przez partnera w żądaniu, niezależnie od tego, czy zostały one 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 członków listy 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 członków listy odbiorców w żądaniu, niezależnie od tego, czy zostali oni usunięci. |
user_identifier_count |
Łączna liczba identyfikatorów użytkowników wysł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 członków listy 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 żądania.
| 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 mogą jednak występować ostrzeżenia. |
PROCESSING |
Żądanie jest przetwarzane. |
FAILED |
Przetwarzanie wszystkich rekordów nie powiodło się. Sprawdź pole , aby uzyskać szczegółowe informacje o błędach, a pole , aby uzyskać szczegółowe informacje o ostrzeżeniach. |
PARTIAL_SUCCESS |
Przetwarzanie niektórych rekordów zostało ukończone bez błędów, ale w przypadku innych wystąpiły błędy. Sprawdź pole , aby uzyskać szczegółowe informacje o błędach, a pole , aby uzyskać szczegółowe informacje o ostrzeżeniach. |
RetrieveInsightsRequest
Wiadomość z prośbą o wywołanie funkcji DM API MarketingDataInsightsService.RetrieveInsights
| Pola | |
|---|---|
parent |
Wymagane. Konto rodzica, do którego należy lista użytkowników. Format: |
baseline |
Wymagane. Wartość odniesienia 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 ds. 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 zbioru powiązanych atrybutów tego samego wymiaru.
| Pola | |
|---|---|
user_interest_id |
Identyfikator zainteresowania użytkownika. |
lift |
Miara wzrostu, jaki odbiorcy uzyskali w przypadku wartości atrybutu w porównaniu z wartością bazową. Zakres [0–1]. |
age_range |
Przedział wiekowy odbiorców, dla których podano 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 oryginalnym żą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 żadnego 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 co najwyżej 50 linków partnerskich. Maksymalna wartość to 100. Wartości powyżej 100 zostaną ograniczone do 100. |
page_token |
Token strony otrzymany z poprzedniego wywołania Podczas paginacji wszystkie pozostałe 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:
W przypadku linków partnerskich z zestawem funkcji
Przykład: |
SearchPartnerLinksResponse
Odpowiedź z SearchPartnerLinksRequest.
| Pola | |
|---|---|
partner_links[] |
Linki partnera 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 członków tej listy użytkowników w sieci reklamowej Google. |
search_network_members_count |
Tylko dane wyjściowe. Szacunkowa liczba członków tej listy użytkowników w domenie google.com. Są to elementy dostępne do kierowania w kampaniach w sieci wyszukiwania. |
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 członków tej listy użytkowników 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 użycia w 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 zamiar zakupu, |
TARGETING_TYPE_REMARKETING |
kierowanie na remarketing, |
TermsOfService
Warunki 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 decyzję rozmówcy o zaakceptowaniu lub odrzuceniu warunków 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
Wysyłanie prośby o zaktualizowanie zasobu UserListDirectLicense.
| Pola | |
|---|---|
user_list_direct_license |
Wymagane. Pole |
update_mask |
Opcjonalnie: Lista pól do zaktualizowania. Znak specjalny |
UpdateUserListGlobalLicenseRequest
Wysyłanie prośby o zaktualizowanie zasobu UserListGlobalLicense.
| Pola | |
|---|---|
user_list_global_license |
Wymagane. Pole |
update_mask |
Opcjonalnie: Lista pól do zaktualizowania. Znak specjalny |
UpdateUserListRequest
Wiadomość żądania dla 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. |
Użytkownik
Reprezentuje pojedynczego użytkownika i zawiera identyfikatory, takie jak informacje umożliwiające identyfikację i identyfikatory urządzeń mobilnych, które odnoszą się do tego samego użytkownika.
| Pola | |
|---|---|
user_data |
Wymagane. Wiele rodzajów danych przekazywanych przez użytkowników, które służą do identyfikowania użytkownika. |
mobile_data |
Wymagane. Wiele ciągów identyfikatorów urządzeń mobilnych reprezentujących jednego użytkownika. |
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 pliku |
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 przesyłanych danych. |
UserIdentifier
Pojedynczy identyfikator użytkownika.
| Pola | |
|---|---|
Pole zbiorcze identifier. Musisz określić dokładnie 1 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
Zasób listy 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 określająca, 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 tej liście użytkowników. |
account_access_status |
Opcjonalnie: Wskazuje, czy to udostępnienie 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ą danymi przesłanymi 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 wyliczenie jest używane 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 do kierowania. Szczegółowe informacje 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 ds. 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ą udzielana 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 licencji 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, do której 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 – WŁĄCZONY lub WYŁĄCZONY. |
UserListGlobalLicense
globalną licencję na listę użytkowników,
Ta funkcja jest dostępna tylko dla partnerów ds. 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ą udzielana 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, do której przyznawana jest licencja. |
license_type |
Wartość niezmienna. Typ produktu klienta, na który licencjonowana jest lista użytkowników. |
status |
Opcjonalnie: Stan UserListGlobalLicense – WŁĄCZONA lub WYŁĄCZONA. |
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, do której przyznawana jest licencja. |
user_list_display_name |
Tylko dane wyjściowe. Nazwa listy użytkowników, na którą udzielana 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 – WŁĄCZONY lub WYŁĄCZONY. |
pricing |
Tylko dane wyjściowe. Ceny licencji 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 |
licencję DataMart Buy Side, |
UserListLicenseClientAccountType
Możliwa usługa konta 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 |
reklamodawca w Display & Video 360; |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Połączenie z odbiorcami 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 tej ceny. |
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 ten cennik jest aktywny. |
buyer_approval_state |
Tylko dane wyjściowe. Stan zatwierdzenia tych cen przez kupującego. To pole jest tylko do odczytu. |
cost_micros |
Opcjonalnie: Koszt powią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. Rodzaj kosztu tej ceny. Można go ustawić tylko w operacji |
max_cost_micros |
Opcjonalnie: Maksymalny CPM, jaki można naliczyć 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 parametr 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 na listę użytkowników.
| Wartości w polu enum | |
|---|---|
USER_LIST_LICENSE_STATUS_UNSPECIFIED |
Brak informacji. |
USER_LIST_LICENSE_STATUS_ENABLED |
Aktywny – licencje na listę użytkowników są nadal przyznawane. |
USER_LIST_LICENSE_STATUS_DISABLED |
Stan nieaktywny – lista użytkowników nie jest już licencjonowana. |
UserProperties
Informacje o użytkowniku w momencie wystąpienia zdarzenia, które zostały ocenione przez reklamodawcę. 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, która ma być używana. |
ViewType
Typ zdarzenia.
| Wartości w polu enum | |
|---|---|
VIEW_TYPE_UNSPECIFIED |
Nieokreślony typ widoku. |
VIEW_TYPE_MRC_VIEWED |
Wyświetlenie 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: Procent pikseli, które były widoczne (0–100). |
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 reklamowych, niezależnie od tego, czy były widoczne. |
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. |
WarningReason
Przyczyny ostrzeżeń nieblokujących zwróconych podczas przetwarzania.
| Wartości w polu enum | |
|---|---|
WARNING_REASON_UNSPECIFIED |
Nieokreślona przyczyna ostrzeżenia. |
WARNING_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
Na koncie nie jest włączona zmienna niestandardowa w . |
WARNING_REASON_CUSTOM_VARIABLE_NOT_PREDEFINED |
Wartość zmiennej niestandardowej w nie należy do wstępnie zdefiniowanych dozwolonych wartości skonfigurowanych dla zmiennej niestandardowej na koncie docelowym. |
WARNING_REASON_CART_DATA_NOT_SUPPORTED_WITH_GBRAID_OR_WBRAID |
Funkcja nie jest obsługiwana w przypadku ani . |
WARNING_REASON_CART_DATA_ITEM_MERCHANT_PRODUCT_ID_MISSING |
W elemencie koszyka brakuje . |
WARNING_REASON_CART_DATA_ITEM_UNIT_PRICE_MISSING |
W elemencie koszyka brakuje . |
WARNING_REASON_GENERIC |
Ogólna przyczyna ostrzeżenia w przypadku problemów, które nie pasują do innych kategorii. |
WARNING_REASON_INVALID_CLIENT_ID |
Wartość jest nieprawidłowa. |
WARNING_REASON_INVALID_SUBDIVISION_CODE |
Wartość jest nieprawidłowa. |
WARNING_REASON_INVALID_REGION_CODE |
Wartość jest nieprawidłowa. |
WARNING_REASON_INVALID_SUBCONTINENT_CODE |
Wartość jest nieprawidłowa. |
WARNING_REASON_INVALID_CONTINENT_CODE |
Wartość jest nieprawidłowa. |
WARNING_REASON_INVALID_DEVICE_CATEGORY |
Urządzenie jest nieprawidłowe. |
WARNING_REASON_INVALID_DEVICE_SCREEN_RESOLUTION |
Urządzenie lub jest nieprawidłowe. |
WARNING_REASON_INVALID_MERCHANT_ID |
Wartość jest nieprawidłowa. |