CustomInterest

Zainteresowanie niestandardowe. To lista użytkowników według zainteresowań.

Zapis JSON
{
  "resourceName": string,
  "status": enum (CustomInterestStatus),
  "type": enum (CustomInterestType),
  "members": [
    {
      object (CustomInterestMember)
    }
  ],
  "id": string,
  "name": string,
  "description": string
}
Pola
resourceName

string

Niezmienna. Nazwa zasobu zainteresowania niestandardowego. Nazwy zasobów zainteresowań niestandardowych mają postać:

customers/{customerId}/customInterests/{custom_interest_id}

status

enum (CustomInterestStatus)

Stan tego niestandardowego zainteresowania. Wskazuje, czy zainteresowanie niestandardowe jest włączone czy usunięte.

type

enum (CustomInterestType)

Typ zainteresowania niestandardowego: CUSTOM_AFFINITY lub CUSTOM_INTENT. Domyślnie typ ma wartość CUSTOM_AFFINITY.

members[]

object (CustomInterestMember)

Lista elementów składowych niestandardowego zainteresowania, z którego się ono składa. Członków można dodawać podczas tworzenia zainteresowania niestandardowego. Jeśli członkowie są prezentowani w operacji UPDATE, dotychczasowi członkowie zostaną zastąpieni.

id

string (int64 format)

Tylko dane wyjściowe. Identyfikator niestandardowego zainteresowania.

name

string

Nazwa zainteresowania niestandardowego. Powinna być niepowtarzalna w przypadku tej samej listy odbiorców o podobnych zainteresowaniach. To pole jest wymagane do operacji tworzenia.

description

string

Opis tej niestandardowej listy odbiorców opartej na zainteresowaniach.

CustomInterestStatus

Enum zawierający możliwe typy niestandardowych zainteresowań.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
ENABLED Stan włączony – zainteresowanie niestandardowe jest włączone i można na nie kierować reklamy.
REMOVED Stan „Usunięty” – niestandardowe zainteresowanie zostało usunięte i nie można go używać do kierowania reklam.

CustomInterestType

Wyliczenie zawierające możliwe niestandardowe typy zainteresowań.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używany tylko w przypadku zwracanej wartości. Reprezentuje wartość nieznana w tej wersji.
CUSTOM_AFFINITY Umożliwia reklamodawcom promującym markę definiowanie niestandardowych list odbiorców o podobnych zainteresowaniach.
CUSTOM_INTENT Umożliwia reklamodawcom definiowanie list niestandardowych odbiorców o podobnych zamiarach.

CustomInterestMember

Członek listy odbiorców o podobnych zainteresowaniach. Członkiem może być słowo kluczowe lub adres URL. Jest ona niezmienna, co oznacza, że można ją tylko utworzyć lub usunąć, ale nie zmienić.

Zapis JSON
{
  "memberType": enum (CustomInterestMemberType),
  "parameter": string
}
Pola
memberType

enum (CustomInterestMemberType)

Typ elementu niestandardowego zainteresowania: SŁOWO_KLUCZOWE lub ADRES_URL.

parameter

string

tekst słowa kluczowego, gdy memberType ma wartość KEYWORD (słowo kluczowe) lub ciąg znaków URL, gdy memberType ma wartość URL.

CustomInterestMemberType

Enum zawierający możliwe typy członków niestandardowych zainteresowań.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
KEYWORD Typ członka niestandardowych zainteresowań: SŁOWO_KLUCZOWE.
URL Adres URL typu członka „Niestandardowe zainteresowania”.