REST Resource: advertisers

Zasób: Reklamodawca

pojedynczy reklamodawca w Display & Video 360 (DV360);

Zapis JSON
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  }
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu reklamodawcy.

advertiserId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy. Przypisany przez system.

partnerId

string (int64 format)

Wymagany. Niezmienna. Unikalny identyfikator partnera, do którego należy reklamodawca.

displayName

string

Wymagany. Wyświetlana nazwa reklamodawcy.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.

entityStatus

enum (EntityStatus)

Wymagany. Określa, czy zamówienia reklamowe i elementy zamówienia reklamodawcy mogą wydawać budżety i ustalać stawki za zasoby reklamowe.

  • Akceptowane wartości to ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSEDENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Jeśli ustawisz wartość ENTITY_STATUS_SCHEDULED_FOR_DELETION, reklamodawca zostanie usunięty po 30 dniach od zaplanowania usunięcia.
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy reklamodawca został ostatnio zaktualizowany. Przypisany przez system.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

generalConfig

object (AdvertiserGeneralConfig)

Wymagany. Ustawienia ogólne reklamodawcy.

adServerConfig

object (AdvertiserAdServerConfig)

Wymagany. Niezmienna. Ustawienia reklamodawcy związane z serwerem reklam.

creativeConfig

object (AdvertiserCreativeConfig)

Wymagany. Ustawienia reklamodawcy związane z kreacją.

dataAccessConfig

object (AdvertiserDataAccessConfig)

Ustawienia określające, jak można uzyskać dostęp do danych reklamodawcy.

integrationDetails

object (IntegrationDetails)

Szczegóły integracji reklamodawcy. Obecnie reklamodawca może korzystać tylko z formy integrationCode. Inne pola w IntegrationDetails nie są obsługiwane i w razie podania zostaną zignorowane.

servingConfig

object (AdvertiserTargetingConfig)

Ustawienia kierowania związane z wyświetlaniem reklam reklamodawcy.

prismaEnabled

boolean

Określa, czy integracja z Mediaocean (Prisma) jest włączona. Włączając tę opcję, akceptujesz te zasady:

W imieniu mojej firmy upoważniam firmę Mediaocean (Prisma) do udostępniania planów segmentu budżetu firmie Google, a firmę Google upoważniam do udostępniania odpowiednich raportów i faktur z usługi DV360 firmie Mediaocean do celów planowania budżetu, rozliczeń i uzgodnień z reklamodawcami.

billingConfig

object (AdvertiserBillingConfig)

Wymagany. Ustawienia reklamodawcy związane z płatnościami.

AdvertiserGeneralConfig

Ustawienia ogólne reklamodawcy.

Zapis JSON
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
Pola
domainUrl

string

Wymagany. Adres URL domeny głównej witryny reklamodawcy. System wyśle te informacje do wydawców, którzy wymagają adresu URL witryny, aby powiązać kampanię z reklamodawcą.

Podaj adres URL bez ścieżki ani ciągu zapytania, który zaczyna się od http: lub https:. Na przykład http://www.example.com

timeZone

string

Tylko dane wyjściowe. Standardowa nazwa bazy danych TZ strefy czasowej reklamodawcy. Na przykład: America/New_York.

Więcej informacji: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

W przypadku reklamodawców hybrydowych w CM360 strefa czasowa jest taka sama jak na powiązanym koncie CM360. W przypadku reklamodawców korzystających tylko z serwera reklamowego firmy zewnętrznej strefa czasowa jest taka sama jak na koncie partnera nadrzędnego.

currencyCode

string

Wymagany. Niezmienna. Waluta reklamodawcy w formacie ISO 4217.

Akceptowane kody i odpowiadające im waluty:

Kod waluty : nazwa waluty

  • ARS : peso argentyńskie
  • AUD : dolar australijski
  • BRL : real brazylijski
  • CAD : dolar kanadyjski
  • CHF : frank szwajcarski
  • CLP : peso chilijskie
  • CNY : juan chiński
  • COP : peso kolumbijskie
  • CZK : korona czeska
  • DKK : korona duńska
  • EGP : funt egipski
  • EUR : euro
  • GBP : funt brytyjski
  • HKD : dolar hongkoński
  • HUF : forint węgierski
  • IDR : rupia indonezyjska
  • ILS : Szekel izraelski
  • INR : rupia indyjska
  • JPY : jen japoński
  • KRW : won południowokoreański
  • MXN : peso meksykańskie
  • MYR : ringgit malezyjski
  • NGN : naira nigeryjska
  • NOK : korona norweska
  • NZD : Dolar nowozelandzki
  • PEN : nowy sol peruwiański
  • PLN : złoty polski
  • RON : nowy lej rumuński
  • RUB : rubel rosyjski
  • SEK : korona szwedzka
  • TRY : lira turecka
  • TWD : nowy dolar tajwański
  • USD : dolar amerykański
  • ZAR : rand południowoafrykański

AdvertiserAdServerConfig

Ustawienia reklamodawcy związane z serwerem reklam.

Zapis JSON
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
Pola
Pole unii ad_server_config_scheme. Wymagany. ad_server_config_scheme może być tylko jednym z tych elementów:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Konfiguracja dla reklamodawców, którzy korzystają tylko z serwerów reklamowych firm zewnętrznych.

cmHybridConfig

object (CmHybridConfig)

Konfiguracja dla reklamodawców, którzy korzystają zarówno z Campaign Managera 360 (CM360), jak i z serwerów reklamowych firm zewnętrznych.

ThirdPartyOnlyConfig

Ustawienia dla reklamodawców, którzy korzystają tylko z serwerów reklamowych firm zewnętrznych.

Zapis JSON
{
  "pixelOrderIdReportingEnabled": boolean
}
Pola
pixelOrderIdReportingEnabled

boolean

Określa, czy raportowanie identyfikatora zamówienia dla pikseli jest włączone. Po ustawieniu wartości true nie można jej zmienić.

CmHybridConfig

Ustawienia dla reklamodawców, którzy korzystają zarówno z Campaign Managera 360 (CM360), jak i z serwerów reklamowych firm zewnętrznych.

Zapis JSON
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Pola
cmAccountId

string (int64 format)

Wymagany. Niezmienna. Identyfikator konta konfiguracji Floodlight CM360 połączonej z reklamodawcą DV360.

cmFloodlightConfigId

string (int64 format)

Wymagany. Niezmienna. Identyfikator konfiguracji Floodlight CM360 połączonej z reklamodawcą DV360.

cmAdvertiserIds[]

string (int64 format)

Tylko dane wyjściowe. Zestaw identyfikatorów reklamodawców CM360, które mają ten sam identyfikator konfiguracji Floodlight CM360.

cmSyncableSiteIds[]

string (int64 format)

Lista witryn CM360, których miejsca docelowe zostaną zsynchronizowane z DV360 jako kreacje.

Jeśli w metodzie advertisers.create nie ma podanego parametru lub jest on pusty, system automatycznie utworzy witrynę CM360.

Usunięcie witryn z tej listy może spowodować usunięcie kreacji DV360 zsynchronizowanych z CM360. Musisz określić co najmniej 1 witrynę.

dv360ToCmDataSharingEnabled

boolean

Określa, czy dane DV360 mają być uwzględniane w raportach Przenoszenia danych w CM360.

dv360ToCmCostReportingEnabled

boolean

Określa, czy koszty DV360 mają być raportowane do CM360.

cmFloodlightLinkingAuthorized

boolean

Wymagany. Niezmienna. Ustawienie tego pola na true oznacza, że w imieniu swojej firmy zezwalasz na udostępnianie informacji z danej konfiguracji Floodlight temu reklamodawcy w Display & Video 360.

AdvertiserCreativeConfig

Ustawienia kreacji reklamodawcy.

Zapis JSON
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Pola
iasClientId

string (int64 format)

Identyfikator służący do konfigurowania monitorowania kampanii przez Integral Ad Service (IAS). System DV360 doda do tagu kreacji tag IAS „Campaign Monitor” zawierający ten identyfikator.

obaComplianceDisabled

boolean

Czy chcesz wyłączyć funkcję Google „O tej reklamie”, która dodaje do reklam plakietek (w celu identyfikacji treści jako reklamy) i informacje o przejrzystości (w przypadku interakcji z funkcją „O tej reklamie”), aby zachować zgodność z zasadami dotyczącymi internetowej reklamy behawioralnej (OBA) i wymaganiami prawnymi. Komunikaty „O tej reklamie” zapewniają użytkownikom większą kontrolę nad wyświetlanymi im reklamami i pomagają Ci wyjaśnić, dlaczego widzą Twoją reklamę. Więcej informacji

Jeśli ustawisz to pole na true, pamiętaj, że reklamy wyświetlane w Display & Video 360 muszą być zgodne z tymi zasadami:

  • muszą być zgodne z zasadami internetowej reklamy behawioralnej (OBA) zgodnie z zawartą umową z Google Marketing Platform;
  • W Europejskim Obszarze Gospodarczym reklamy muszą zawierać informacje zwiększające przejrzystość oraz mechanizm umożliwiający użytkownikom zgłaszanie treści niezgodnych z prawem. Jeśli korzystasz z alternatywnego rozwiązania dotyczącego plakietek, przejrzystości i raportowania, musisz się upewnić, że zawiera ono wymagane informacje dotyczące przejrzystości i mechanizm zgłaszania treści niezgodnych z prawem. Musisz też powiadamiać Google o wszelkich zgłoszeniach treści niezgodnych z prawem, korzystając z odpowiedniego formularza.
dynamicCreativeEnabled

boolean

Czy reklamodawca ma włączone kreacje dynamiczne.

videoCreativeDataSharingAuthorized

boolean

Ustawiając w tym polu wartość true, w imieniu swojej firmy upoważniasz Google do używania kreacji wideo powiązanych z reklamodawcą z Display & Video 360 na potrzeby generowania raportów i udostępniania funkcji związanych z jego kampaniami telewizyjnymi.

Dotyczy to tylko sytuacji, gdy reklamodawca ma CM360 hybrid konfigurację serwera reklam.

AdvertiserDataAccessConfig

Ustawienia, które określają, jak można uzyskać dostęp do danych związanych z reklamodawcami.

Zapis JSON
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Pola
sdfConfig

object (AdvertiserSdfConfig)

Ustawienia plików uporządkowanych danych (SDF) reklamodawcy.

Jeśli nie są określone, używane są ustawienia SDF partnera nadrzędnego.

AdvertiserSdfConfig

Ustawienia plików uporządkowanych danych (SDF) reklamodawcy.

Zapis JSON
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Pola
overridePartnerSdfConfig

boolean

Określa, czy ten reklamodawca zastępuje konfigurację SDF swojego nadrzędnego partnera.

Domyślnie reklamodawca dziedziczy konfigurację SDF od partnera nadrzędnego. Aby zastąpić konfigurację partnera, ustaw to pole na true i w polu sdfConfig podaj nową konfigurację.

sdfConfig

object (SdfConfig)

Konfiguracja SDF dla reklamodawcy.

AdvertiserTargetingConfig

Ustawienia kierowania związane z wyświetlaniem reklam reklamodawcy.

Zapis JSON
{
  "exemptTvFromViewabilityTargeting": boolean
}
Pola
exemptTvFromViewabilityTargeting

boolean

Określ, czy urządzenia CTV mają być wykluczone z kierowania według widoczności w przypadku wszystkich elementów zamówienia wideo reklamodawcy.

AdvertiserBillingConfig

Ustawienia reklamodawcy związane z płatnościami.

Zapis JSON
{
  "billingProfileId": string
}
Pola
billingProfileId

string (int64 format)

Wymagany. Identyfikator profilu płatności przypisanego do reklamodawcy.

Metody

audit

Sprawdzanie reklamodawcy.

create

Tworzy nowego reklamodawcę.

delete

Usuwa reklamodawcę.

editAssignedTargetingOptions

Edytowanie opcji kierowania na poziomie jednego reklamodawcy.

get

Pobiera informacje o reklamodawcy.

list

Wyświetla listę reklamodawców, do których ma dostęp bieżący użytkownik.

listAssignedTargetingOptions

Wyświetla przypisane opcje kierowania reklamodawcy według typów kierowania.

patch

Aktualizuje istniejącego reklamodawcę.