AssetGroup

Grupa komponentów. AssetGroupAsset służy do łączenia zasobu z grupą komponentów. AssetGroupSignal służy do powiązania sygnału z grupą komponentów.

Zapis JSON
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "primaryStatus": enum (AssetGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AssetGroupPrimaryStatusReason)
  ],
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Pola
resourceName

string

Niezmienne. Nazwa zasobu grupy komponentów. Nazwy zasobów grup komponentów mają postać:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

Tylko dane wyjściowe. Identyfikator grupy komponentów.

campaign

string

Niezmienne. Kampania, z którą powiązana jest ta grupa komponentów. Komponent, który jest połączony z grupą komponentów.

name

string

To pole jest wymagane. Nazwa grupy komponentów. To pole jest wymagane. Jego minimalna długość to 1, a maksymalna – 128 znaków. Nie może się powtarzać w ramach kampanii.

finalUrls[]

string

Lista końcowych adresów URL ze wszystkimi przekierowaniami między domenami. Domyślnie w kampanii Performance Max adresy URL mogą się rozwijać, chyba że z tego zrezygnujesz.

finalMobileUrls[]

string

Lista końcowych adresów URL dla urządzeń mobilnych po wszystkich przekierowaniach między domenami. Domyślnie w kampanii Performance Max adresy URL mogą się rozwijać, chyba że z tego zrezygnujesz.

status

enum (AssetGroupStatus)

Stan grupy komponentów.

primaryStatus

enum (AssetGroupPrimaryStatus)

Tylko dane wyjściowe. Główny stan grupy komponentów. Zapewnia informacje o przyczynach, dla których grupa komponentów nie wyświetla się lub nie wyświetla w optymalny sposób.

primaryStatusReasons[]

enum (AssetGroupPrimaryStatusReason)

Tylko dane wyjściowe. Podaje powody, dla których grupa komponentów nie wyświetla się lub nie wyświetla w optymalny sposób. Jeśli grupa komponentów działa bez problemów, pole jest puste.

path1

string

Pierwsza część tekstu, która może się pojawić jako dołączony do adresu URL wyświetlanego w reklamie.

path2

string

Druga część tekstu, która może być dołączana do adresu URL wyświetlanego w reklamie. To pole można skonfigurować tylko wtedy, gdy ustawiona jest ścieżka 1.

adStrength

enum (AdStrength)

Tylko dane wyjściowe. Ogólna skuteczność reklamy w tej grupie komponentów.

AssetGroupStatus

Możliwe stany grupy komponentów.

Wartości w polu enum
UNSPECIFIED Stan nie został określony.
UNKNOWN Otrzymana wartość nie jest znana w tej wersji.
ENABLED Grupa komponentów jest włączona.
PAUSED Grupa komponentów jest wstrzymana.
REMOVED Grupa komponentów została usunięta.

AssetGroupPrimaryStatus

Wartość wyliczeniowa opisująca możliwy stan podstawowy grupy komponentów. Zapewnia informacje o przyczynach, dla których grupa komponentów nie wyświetla się lub nie wyświetla w optymalny sposób.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
ELIGIBLE Grupa komponentów kwalifikuje się do wyświetlania.
PAUSED Grupa komponentów jest wstrzymana.
REMOVED Grupa komponentów została usunięta.
NOT_ELIGIBLE Grupa komponentów nie kwalifikuje się do wyświetlania.
LIMITED Grupa komponentów ma ograniczoną możliwość wyświetlania.
PENDING Grupa komponentów czeka na zatwierdzenie i może być wyświetlana w przyszłości.

AssetGroupPrimaryStatusReason

Wartość opisująca możliwe przyczyny stanu głównego grupy komponentów. Podaje powody, dla których grupa komponentów nie wyświetla się lub nie wyświetla w optymalny sposób. Jeśli grupa komponentów działa bez problemów, pole jest puste.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
ASSET_GROUP_PAUSED Określony przez użytkownika stan grupy komponentów jest wstrzymany.
ASSET_GROUP_REMOVED Określony przez użytkownika stan grupy komponentów zostanie usunięty.
CAMPAIGN_REMOVED Określony przez użytkownika stan kampanii zostanie usunięty.
CAMPAIGN_PAUSED Określony przez użytkownika stan kampanii jest wstrzymany.
CAMPAIGN_PENDING Określony przez użytkownika czas rozpoczęcia tej kampanii przypada w przyszłości.
CAMPAIGN_ENDED Określony przez użytkownika czas zakończenia tej kampanii minął.
ASSET_GROUP_LIMITED Grupa komponentów została zatwierdzona, ale ze względu na zasady wyświetla reklamy tylko w ograniczonym zakresie.
ASSET_GROUP_DISAPPROVED Grupa komponentów została oznaczona jako odrzucona.
ASSET_GROUP_UNDER_REVIEW Grupa komponentów nie przeszła weryfikacji zgodności z zasadami reklamowymi.