UserList

Lista użytkowników. Jest to lista użytkowników, na których klient może kierować reklamy.

Zapis JSON
{
  "resourceName": string,
  "membershipStatus": enum (UserListMembershipStatus),
  "sizeRangeForDisplay": enum (UserListSizeRange),
  "sizeRangeForSearch": enum (UserListSizeRange),
  "type": enum (UserListType),
  "closingReason": enum (UserListClosingReason),
  "accessReason": enum (AccessReason),
  "accountUserListStatus": enum (UserListAccessStatus),
  "id": string,
  "readOnly": boolean,
  "name": string,
  "description": string,
  "integrationCode": string,
  "membershipLifeSpan": string,
  "sizeForDisplay": string,
  "sizeForSearch": string,
  "eligibleForSearch": boolean,
  "eligibleForDisplay": boolean,
  "matchRatePercentage": integer,

  // Union field user_list can be only one of the following:
  "crmBasedUserList": {
    object (CrmBasedUserListInfo)
  },
  "similarUserList": {
    object (SimilarUserListInfo)
  },
  "ruleBasedUserList": {
    object (RuleBasedUserListInfo)
  },
  "logicalUserList": {
    object (LogicalUserListInfo)
  },
  "basicUserList": {
    object (BasicUserListInfo)
  }
  // End of list of possible types for union field user_list.
}
Pola
resourceName

string

Stałe. Nazwa zasobu listy użytkowników. Nazwy zasobów list użytkowników mają postać:

customers/{customerId}/userLists/{userListId}

membershipStatus

enum (UserListMembershipStatus)

Stan członkostwa na tej liście użytkowników. Wskazuje, czy lista użytkowników jest otwarta czy aktywna. Tylko otwarte listy użytkowników mogą zawierać większą liczbę użytkowników i na które można kierować reklamy.

sizeRangeForDisplay

enum (UserListSizeRange)

Tylko dane wyjściowe. Zakres rozmiaru w odniesieniu do liczby użytkowników z listy UserList w sieci reklamowej Google.

To pole jest tylko do odczytu.

type

enum (UserListType)

Tylko dane wyjściowe. Typ tej listy.

To pole jest tylko do odczytu.

closingReason

enum (UserListClosingReason)

Wskazanie przyczyny, dla której stan członkostwa na liście użytkowników jest zamknięty. Jest ono wypełniane tylko w przypadku list, które zostały automatycznie zamknięte ze względu na brak aktywności, i zostanie usunięte, gdy stan członkostwa na liście stanie się otwarty.

accessReason

enum (AccessReason)

Tylko dane wyjściowe. Wskazuje przyczynę przyznania temu kontu dostępu do listy. Powód może być „UDOSTĘPNIONE”, „WŁAŚCIWE”, Z LICENCJĄ lub SUBSKRYBOWANO.

To pole jest tylko do odczytu.

accountUserListStatus

enum (UserListAccessStatus)

Wskazuje, czy udostępnianie jest nadal włączone. Gdy udostępniasz użytkownikowi listę UserList, to pole jest ustawione na ENABLED. Później właściciel listy użytkowników może odwołać udostępnienie i WYŁĄCZYĆ. Domyślna wartość tego pola to ENABLED.

id

string (int64 format)

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

readOnly

boolean

Tylko dane wyjściowe. Opcja wskazująca, czy użytkownik może edytować listę. Zależy od własności i typu listy. np. nie można edytować zewnętrznych list użytkowników remarketingu.

To pole jest tylko do odczytu.

name

string

Nazwa tej listy użytkowników. W zależności od parametru accessReason nazwa listy użytkowników może nie być unikalna (np. if accessReason=SHARED)

description

string

Opis tej listy użytkowników.

integrationCode

string

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

membershipLifeSpan

string (int64 format)

Liczba dni, przez które plik cookie użytkownika pozostaje na liście od ostatniego dodania do niej. To pole musi zawierać się w zakresie od 0 do 540 włącznie. W przypadku list użytkowników utworzonych w systemie CRM to pole może jednak mieć wartość 10 000, co oznacza, że nie ma daty ważności.

To pole jest ignorowane w przypadku typów logicalUserList i RuleBasedUserList. Członkostwo na takich listach zależy od reguł zdefiniowanych przez te listy.

sizeForDisplay

string (int64 format)

Tylko dane wyjściowe. Szacowana liczba użytkowników na tej liście użytkowników w sieci reklamowej Google. Jeśli liczba użytkowników nie została jeszcze określona, wartość wynosi null.

To pole jest tylko do odczytu.

eligibleForDisplay

boolean

Tylko dane wyjściowe. Wskazuje, że ta lista użytkowników może być wyświetlana w sieci reklamowej Google.

To pole jest tylko do odczytu.

matchRatePercentage

integer

Tylko dane wyjściowe. Wskazuje współczynnik dopasowania list kierowania na listę klientów. Zakres tego pola wynosi [0–100]. W przypadku innych typów list lub gdy nie można obliczyć współczynnika dopasowania, ta wartość będzie mieć wartość null.

To pole jest tylko do odczytu.

Pole sumy user_list. Lista użytkowników.

Musisz ustawić dokładnie jeden. user_list może być tylko jedną z tych wartości:

crmBasedUserList

object (CrmBasedUserListInfo)

Lista użytkowników CRM podana przez reklamodawcę.

similarUserList

object (SimilarUserListInfo)

Tylko dane wyjściowe. listy użytkowników podobne do list użytkowników z innej listy użytkowników. Te listy są tylko do odczytu i automatycznie tworzone przez Google.

ruleBasedUserList

object (RuleBasedUserListInfo)

Lista użytkowników generowana przez regułę.

logicalUserList

object (LogicalUserListInfo)

Lista użytkowników, która jest niestandardową kombinacją list użytkowników i ich zainteresowań.

basicUserList

object (BasicUserListInfo)

Kierowanie na listy użytkowników jako zbiór działań powodujących konwersję lub działań remarketingowych.

UserListMembershipStatus

Wyliczenie zawierające możliwe stany członkostwa na liście użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
OPEN Stan otwarty – lista gromadzi członków i można na nią kierować reklamy.
CLOSED Stan „Zamknięte” – nie są dodawani nowi użytkownicy. Nie można go używać do kierowania.

UserListSizeRange

Wyliczenie zawierające możliwe zakresy rozmiarów listy użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
LESS_THAN_FIVE_HUNDRED Lista użytkowników zawiera mniej niż 500 użytkowników.
LESS_THAN_ONE_THOUSAND Lista użytkowników zawiera liczbę użytkowników w zakresie od 500 do 1000.
ONE_THOUSAND_TO_TEN_THOUSAND Lista użytkowników zawiera liczbę użytkowników w zakresie od 1000 do 10 000.
TEN_THOUSAND_TO_FIFTY_THOUSAND Lista użytkowników zawiera liczbę użytkowników w zakresie od 10 000 do 50 000.
FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND Lista użytkowników zawiera liczbę użytkowników w zakresie od 50 000 do 100 000.
ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND Lista użytkowników zawiera liczbę użytkowników z zakresu od 100 000 do 300 000.
THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND Lista użytkowników zawiera liczbę użytkowników z zakresu od 300 000 do 500 000.
FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION Lista użytkowników zawiera liczbę użytkowników w zakresie od 500 000 do 1 miliona.
ONE_MILLION_TO_TWO_MILLION Lista użytkowników zawiera liczbę użytkowników w zakresie od 1 do 2 milionów.
TWO_MILLION_TO_THREE_MILLION Lista użytkowników zawiera liczbę użytkowników w zakresie od 2 do 3 milionów.
THREE_MILLION_TO_FIVE_MILLION Lista użytkowników zawiera liczbę użytkowników w zakresie od 3 do 5 milionów.
FIVE_MILLION_TO_TEN_MILLION Lista użytkowników zawiera liczbę użytkowników w zakresie od 5 do 10 milionów.
TEN_MILLION_TO_TWENTY_MILLION Lista użytkowników zawiera liczbę użytkowników w zakresie od 10 do 20 milionów.
TWENTY_MILLION_TO_THIRTY_MILLION Lista użytkowników zawiera liczbę użytkowników w zakresie od 20 do 30 milionów.
THIRTY_MILLION_TO_FIFTY_MILLION Lista użytkowników zawiera liczbę użytkowników w zakresie od 30 do 50 milionów.
OVER_FIFTY_MILLION Lista użytkowników zawiera ponad 50 milionów użytkowników.

UserListType

Wyliczenie zawierające możliwe typy list użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
REMARKETING UserList przedstawiona jako zbiór typów konwersji.
LOGICAL Lista użytkowników przedstawiana jako połączenie innych list i zainteresowań użytkowników.
EXTERNAL_REMARKETING Lista użytkowników utworzona na platformie Google Ad Manager.
RULE_BASED Lista użytkowników powiązana z regułą.
SIMILAR UserList z użytkownikami podobnymi do użytkowników innej listy.
CRM_BASED Lista użytkowników zawierająca własne dane z systemu CRM przekazane przez reklamodawcę w postaci e-maili lub innych formatów.

UserListClosingReason

Wyliczenie opisujące możliwe przyczyny zamknięcia listy użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
UNUSED Lista użytkowników została zamknięta, ponieważ nie była używana od ponad roku.

AccessReason

Wyliczenie opisujące możliwe przyczyny dostępu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
OWNED Zasób jest własnością użytkownika.
SHARED Zasób jest udostępniany użytkownikowi.
LICENSED Użytkownik otrzyma licencję na zasób.
SUBSCRIBED Użytkownik zasubskrybował zasób.
AFFILIATED Użytkownik ma dostęp do zasobu.

UserListAccessStatus

Wyliczenie zawierające możliwe stany dostępu do listy użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ENABLED Dostęp jest włączony.
DISABLED Dostęp jest wyłączony.

CrmBasedUserListInfo

Lista użytkowników CRM podana przez reklamodawcę.

Zapis JSON
{
  "uploadKeyType": enum (CustomerMatchUploadKeyType),
  "dataSourceType": enum (UserListCrmDataSourceType),
  "appId": string
}
Pola
uploadKeyType

enum (CustomerMatchUploadKeyType)

Typ pasującego klucza listy. Na tej samej liście nie można umieszczać mieszanych typów danych. To pole jest wymagane w przypadku operacji DODAWANIA.

dataSourceType

enum (UserListCrmDataSourceType)

Źródło danych listy. Wartość domyślna to FIRST_PARTY. Tylko klienci znajdujący się na liście dozwolonych mogą tworzyć listy CRM z zewnętrznych źródeł.

appId

string

Ciąg znaków jednoznacznie identyfikujący aplikację mobilną, z której pobrano dane. W iOS ciąg identyfikatora to 9-cyfrowy ciąg widoczny na końcu adresu URL w App Store (np. „476943146” w przypadku gry „Flood-It! 2”. Link do App Store to http://itunes.apple.com/us/app/flood-it!-2/id476943146). W przypadku Androida ciąg identyfikatora to nazwa pakietu aplikacji (np. „com.labpixies.colordrips” w przypadku „Kropek kolorów” w przypadku linku Google Play pod adresem https://play.google.com/store/apps/details?id=com.labpixies.colordrips)). Wymagane przy tworzeniu listy CrmBasedUserList na potrzeby przesyłania identyfikatorów wyświetlania reklam mobilnych.

CustomerMatchUploadKeyType

Wartość Enum opisująca możliwe typy kluczy przesyłania kierowania na listę klientów.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
CONTACT_INFO Członkowie są dopasowywani na podstawie danych klienta, takich jak adres e-mail, numer telefonu czy adres pocztowy.
CRM_ID Członkowie są dopasowywani na podstawie identyfikatora użytkownika wygenerowanego i przypisanego przez reklamodawcę.
MOBILE_ADVERTISING_ID Członkowie są dopasowywani na podstawie identyfikatorów reklam mobilnych.

UserListCrmDataSourceType

Wyliczenie opisujące typ źródła danych CRM z listą użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
FIRST_PARTY Przesłane dane są danymi własnymi.
THIRD_PARTY_CREDIT_BUREAU Przesłane dane pochodzą z zewnętrznego biura informacji kredytowej.
THIRD_PARTY_VOTER_FILE Przesłane dane pochodzą z pliku wyborcy należącego do innej firmy.

SimilarUserListInfo

Lista podobnych użytkowników to lista użytkowników podobnych do użytkowników z innej listy. Te listy są tylko do odczytu i są tworzone automatycznie przez Google.

Zapis JSON
{
  "seedUserList": string
}
Pola
seedUserList

string

Wyjściowa lista użytkowników, na której podstawie pochodzi ta lista.

RuleBasedUserListInfo

Reprezentacja listy użytkowników wygenerowanej przez regułę.

Zapis JSON
{
  "prepopulationStatus": enum (UserListPrepopulationStatus),
  "flexibleRuleUserList": {
    object (FlexibleRuleUserListInfo)
  }
}
Pola
prepopulationStatus

enum (UserListPrepopulationStatus)

Stan wstępnego wypełniania. Jeśli nie zostanie ustawione, to pole ma domyślnie wartość BRAK, co oznacza, że poprzedni użytkownicy nie będą brani pod uwagę. Jeśli zasada ma wartość REQUESTED, na liście pojawią się dotychczasowi użytkownicy witryny lub aplikacji, którzy pasują do definicji listy (działa tylko w sieci reklamowej). Dodane zostaną tylko użytkownicy z ostatnich 30 dni, w zależności od okresu członkostwa na liście i daty dodania tagu remarketingowego. Po przetworzeniu żądania stan zostanie zmieniony na ZAKOŃCZONO lub FAILED, jeśli żądanie nie zostanie zrealizowane.

flexibleRuleUserList

object (FlexibleRuleUserListInfo)

Elastyczna reprezentacja użytkowników korzystających z reguły z jednym lub wieloma działaniami. Elastyczna lista użytkowników jest definiowana przez 2 listy operandów – inclusiveOperands i exclusion. Każdy operand reprezentuje zbiór użytkowników na podstawie działań, które podjęli w danym przedziale czasu. Te listy operandów są łączone z operatorem AND_NOT, dzięki czemu użytkownicy reprezentowani przez operandy włączające są uwzględniani na liście użytkowników, pomniejszonej o użytkowników reprezentowanych przez operandy wyłączne.

UserListPrepopulationStatus

Wartość Enum opisująca możliwy stan wstępnego wypełnienia listy użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
REQUESTED Wysyłam prośbę o wstępne przygotowanie.
FINISHED Wstępne wypełnianie zostało zakończone.
FAILED Nie udało się wstępnie wypełnić.

FlexibleRuleUserListInfo

Elastyczna reprezentacja użytkowników korzystających z reguły z jednym lub wieloma działaniami. Elastyczna lista użytkowników jest definiowana przez 2 listy operandów – inclusiveOperands i exclusion. Każdy operand reprezentuje zbiór użytkowników na podstawie działań, które podjęli w danym przedziale czasu. Te listy operandów są łączone z operatorem AND_NOT, dzięki czemu użytkownicy reprezentowani przez operandy włączające są uwzględniani na liście użytkowników, pomniejszonej o użytkowników reprezentowanych przez operandy wyłączne.

Zapis JSON
{
  "inclusiveRuleOperator": enum (UserListFlexibleRuleOperator),
  "inclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ],
  "exclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ]
}
Pola
inclusiveRuleOperator

enum (UserListFlexibleRuleOperator)

Operator określający sposób łączenia argumentów inkluzywnych.

inclusiveOperands[]

object (FlexibleRuleOperandInfo)

Reguły reprezentujące użytkowników, którzy powinni zostać uwzględnieni na liście użytkowników. Znajdują się one po lewej stronie operatora AND_NOT i połączone za pomocą operatorów I/LUB, zgodnie z operatorem włącznie.

exclusiveOperands[]

object (FlexibleRuleOperandInfo)

Reguły reprezentujące użytkowników, którzy powinni zostać wykluczeni z listy użytkowników. Znajdują się one po prawej stronie operatora AND_NOT i są połączone operatorem LUB.

UserListFlexibleRuleOperator

Wartość Enum opisująca możliwe operatory reguł połączonych list użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AND A I B.
OR A LUB B.

FlexibleRuleOperandInfo

Reguła elastyczna, która obejmuje wspólną regułę i okres ważności.

Zapis JSON
{
  "rule": {
    object (UserListRuleInfo)
  },
  "lookbackWindowDays": string
}
Pola
rule

object (UserListRuleInfo)

Lista grup elementów reguły, które definiują tę regułę. Grupy elementów reguł są grupowane.

lookbackWindowDays

string (int64 format)

Okres ważności dla tej reguły w dniach. Od teraz do X dni temu.

UserListRuleInfo

Reguła zdefiniowana przez klienta oparta na parametrach niestandardowych wysyłanych przez witryny internetowe lub przesłanych przez reklamodawcę.

Zapis JSON
{
  "ruleType": enum (UserListRuleType),
  "ruleItemGroups": [
    {
      object (UserListRuleItemGroupInfo)
    }
  ]
}
Pola
ruleType

enum (UserListRuleType)

Typ reguły określa sposób grupowania elementów reguł.

Wartością domyślną jest operator LUB dla ORAZ (dysjuncjonująca postać zwykła). Oznacza to, że elementy reguł zostaną połączone operatorem ORAZ w grupach elementów reguł, a same grupy zostaną połączone operatorem LUB.

LUB dla ORAZ jest jedynym obsługiwanym typem listy elastyczności reguł_elastycznej.

ruleItemGroups[]

object (UserListRuleItemGroupInfo)

Lista grup elementów reguły, które definiują tę regułę. Grupy elementów reguły są grupowane na podstawie typu reguły.

UserListRuleType

Wyliczenie opisujące możliwe typy reguł listy użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AND_OF_ORS Spójna postać normalna.
OR_OF_ANDS Nieporządna postać normalna.

UserListRuleItemGroupInfo

Grupa elementów reguł.

Zapis JSON
{
  "ruleItems": [
    {
      object (UserListRuleItemInfo)
    }
  ]
}
Pola
ruleItems[]

object (UserListRuleItemInfo)

Elementy reguły, które zostaną pogrupowane według typu reguły.

UserListRuleItemInfo

Element reguły atomowej.

Zapis JSON
{
  "name": string,

  // Union field rule_item can be only one of the following:
  "numberRuleItem": {
    object (UserListNumberRuleItemInfo)
  },
  "stringRuleItem": {
    object (UserListStringRuleItemInfo)
  },
  "dateRuleItem": {
    object (UserListDateRuleItemInfo)
  }
  // End of list of possible types for union field rule_item.
}
Pola
name

string

Nazwa zmiennej reguły. Powinna odpowiadać nazwie klucza wywoływanego przez piksel. Nazwa musi zaczynać się od litery US-ascii, podkreślenia lub kodu UTF8, który jest większy niż 127, i składa się z liter, cyfr, podkreśleń lub znaków podkreślenia lub kodu UTF8 o wartości większej niż 127. W przypadku witryn dostępne są 2 wbudowane adresy URL zmiennej (nazwa = 'url__') i adres URL strony odsyłającej (nazwa = 'ref_url__'). To pole musi zostać wypełnione podczas tworzenia nowego elementu reguły.

Pole sumy rule_item. Element reguły atomowej. rule_item może być tylko jedną z tych wartości:
numberRuleItem

object (UserListNumberRuleItemInfo)

Element reguły atomowej składający się z operacji liczbowej.

stringRuleItem

object (UserListStringRuleItemInfo)

Element reguły atomowej składający się z operacji na ciągu znaków.

dateRuleItem

object (UserListDateRuleItemInfo)

Element reguły atomowej składający się z operacji związanej z datą.

UserListNumberRuleItemInfo

Element reguły składający się z operacji liczbowej.

Zapis JSON
{
  "operator": enum (UserListNumberRuleItemOperator),
  "value": number
}
Pola
operator

enum (UserListNumberRuleItemOperator)

Operator porównania liczb. To pole jest wymagane i musi je wypełnić podczas tworzenia nowego elementu reguły liczbowej.

value

number

Wartość liczbowa do porównania ze zmienną. To pole jest wymagane i musi je wypełnić podczas tworzenia nowego elementu reguły liczbowej.

UserListNumberRuleItemOperator

Wyliczenie opisujące możliwe operatory elementu reguły listy użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
GREATER_THAN Większe niż.
GREATER_THAN_OR_EQUAL Większe niż lub równe.
EQUALS Równa się.
NOT_EQUALS Inne niż równa się.
LESS_THAN Mniejsze niż.
LESS_THAN_OR_EQUAL Mniejsze lub równe.

UserListStringRuleItemInfo

Element reguły składający się z operacji w postaci ciągu znaków.

Zapis JSON
{
  "operator": enum (UserListStringRuleItemOperator),
  "value": string
}
Pola
operator

enum (UserListStringRuleItemOperator)

Operator porównania ciągów znaków. To pole jest wymagane i musi je wypełnić podczas tworzenia nowego elementu reguły ciągu znaków.

value

string

Po prawej stronie elementu reguły ciągu znaków. W przypadku adresów URL i adresów URL stron odsyłających wartość nie może zawierać niedozwolonych znaków adresu URL, takich jak znaki nowego wiersza, cudzysłowy, znaki tabulacji czy nawiasy. To pole jest wymagane i musi je wypełnić podczas tworzenia nowego elementu reguły ciągu znaków.

UserListStringRuleItemOperator

Wyliczenie opisujące możliwe operatory elementu reguły ciągu listy użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
CONTAINS Zawiera.
EQUALS Równa się.
STARTS_WITH Zaczyna się od.
ENDS_WITH Kończy się na.
NOT_EQUALS Inne niż równa się.
NOT_CONTAINS Nie zawiera.
NOT_STARTS_WITH Nie zaczyna się od.
NOT_ENDS_WITH Nie kończy się na.

UserListDateRuleItemInfo

Element reguły składający się z operacji daty.

Zapis JSON
{
  "operator": enum (UserListDateRuleItemOperator),
  "value": string,
  "offsetInDays": string
}
Pola
operator

enum (UserListDateRuleItemOperator)

Operator porównania dat. To pole jest wymagane i musi je wypełnić podczas tworzenia nowego elementu reguły daty.

value

string

Ciąg znaków reprezentujący wartość daty, która ma zostać porównana ze zmienną reguły. Obsługiwany format daty to RRRR-MM-DD. Czas jest podawany w strefie czasowej klienta.

offsetInDays

string (int64 format)

Względna wartość daty po prawej stronie wskazywana przez przesunięcie liczby dni od teraz. Pole wartości zastąpi to pole, gdy obecne są oba.

UserListDateRuleItemOperator

Wyliczenie opisujące możliwe operatory elementu reguły daty listy użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
EQUALS Równa się.
NOT_EQUALS Inne niż równa się.
BEFORE Wcześniej.
AFTER Po.

LogicalUserListInfo

Reprezentuje listę użytkowników, która jest niestandardową kombinacją list użytkowników.

Zapis JSON
{
  "rules": [
    {
      object (UserListLogicalRuleInfo)
    }
  ]
}
Pola
rules[]

object (UserListLogicalRuleInfo)

Logiczne reguły listy, które definiują tę listę użytkowników. Reguły te to operator logiczny (ALL/ANY/NONE) oraz lista list użytkowników. Podczas oceny wszystkie reguły są sprawdzane za pomocą operatora ORAZ.

Wymagane do tworzenia logicznej listy użytkowników.

UserListLogicalRuleInfo

Reguła logiczna dotycząca listy użytkowników. Reguła zawiera operator logiczny (i/lub nie) i listę użytkowników, które są operandami.

Zapis JSON
{
  "operator": enum (UserListLogicalRuleOperator),
  "ruleOperands": [
    {
      object (LogicalUserListOperandInfo)
    }
  ]
}
Pola
operator

enum (UserListLogicalRuleOperator)

Operator logiczny reguły.

ruleOperands[]

object (LogicalUserListOperandInfo)

Lista operandów reguły.

UserListLogicalRuleOperator

Wartość Enum opisująca możliwe operatory reguł logicznych listy użytkowników.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ALL Oraz wszystkie operandy.
ANY lub - co najmniej jeden z operandów.
NONE Nie – żaden z operandów.

LogicalUserListOperandInfo

Parametr logicznej listy użytkowników, która składa się z listy użytkowników.

Zapis JSON
{
  "userList": string
}
Pola
userList

string

Nazwa zasobu listy użytkowników w postaci operandu.

BasicUserListInfo

Kierowanie na listy użytkowników jako zbiór konwersji lub działań remarketingowych.

Zapis JSON
{
  "actions": [
    {
      object (UserListActionInfo)
    }
  ]
}
Pola
actions[]

object (UserListActionInfo)

Działania powiązane z tą listą użytkowników.

UserListActionInfo

Reprezentuje typ działania służący do tworzenia remarketingowych list użytkowników.

Zapis JSON
{

  // Union field user_list_action can be only one of the following:
  "conversionAction": string,
  "remarketingAction": string
  // End of list of possible types for union field user_list_action.
}
Pola
Pole sumy user_list_action. Podtypy działań związanych z listą użytkowników. user_list_action może być tylko jedną z tych wartości:
conversionAction

string

Działanie powodujące konwersję, które nie pochodzi z remarketingu.

remarketingAction

string

Działanie remarketingowe.