REST Resource: advertisers

Zasób: reklamodawca

Pojedynczy reklamodawca w sieci reklamowej 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. Przypisana przez system.

partnerId

string (int64 format)

Wymagane. Stały. Unikalny identyfikator partnera, do którego należy reklamodawca.

displayName

string

Wymagane. Wyświetlana nazwa reklamodawcy.

Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów.

entityStatus

enum (EntityStatus)

Wymagane. 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_PAUSED i ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Jeśli ma wartość ENTITY_STATUS_SCHEDULED_FOR_DELETION, reklamodawca zostanie usunięty po 30 dniach od zaplanowania jego usunięcia.
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji reklamodawcy. Przypisana przez system.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

generalConfig

object (AdvertiserGeneralConfig)

Wymagane. Ogólne ustawienia reklamodawcy.

adServerConfig

object (AdvertiserAdServerConfig)

Wymagane. Stały. Ustawienia reklamodawcy związane z serwerem reklam.

creativeConfig

object (AdvertiserCreativeConfig)

Wymagane. Ustawienia związane z kreacją reklamodawcy.

dataAccessConfig

object (AdvertiserDataAccessConfig)

Ustawienia, które określają sposób dostępu do danych reklamodawcy.

integrationDetails

object (IntegrationDetails)

Szczegóły integracji reklamodawcy. Obecnie w przypadku reklamodawcy obowiązuje tylko integrationCode. Inne pola IntegrationDetails nie są obsługiwane i będą ignorowane, jeśli zostaną podane.

servingConfig

object (AdvertiserTargetingConfig)

Ustawienia kierowania związane z wyświetlaniem reklam przez reklamodawcę.

prismaEnabled

boolean

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

W imieniu mojej firmy upoważniam firmę Mediaocean (Prisma) do wysyłania planów segmentów budżetu do Google oraz upoważniam Google do wysyłania odpowiednich raportów i faktur z DV360 do firmy Mediaocean na potrzeby planowania budżetu, rozliczeń i uzgodnień w przypadku tego reklamodawcy.

billingConfig

object (AdvertiserBillingConfig)

Wymagane. Ustawienia płatności reklamodawcy.

AdvertiserGeneralConfig

Ogólne ustawienia reklamodawcy.

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

string

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

Podaj adres URL bez ścieżki ani ciągu zapytania zaczynający się od http: lub https:. np. 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 korzystających z hybrydowych kont CM360 strefa czasowa jest taka sama jak strefy czasowej powiązanego konta CM360. w przypadku reklamodawców zewnętrznych strefa czasowa jest taka sama jak strefy czasowej partnera nadrzędnego.

currencyCode

string

Wymagane. Stały. Waluta reklamodawcy w formacie ISO 4217.

Akceptowane kody i waluty te to:

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 sumy ad_server_config_scheme. Wymagane. ad_server_config_scheme może mieć tylko jedną z tych wartości:
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 używają zarówno Campaign Managera 360 (CM360), jak i 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 jest włączone raportowanie identyfikatora zamówienia dla pikseli. Tej wartości nie można zmienić, gdy jest ustawiona na true.

CmHybridConfig

Ustawienia dla reklamodawców, którzy używają zarówno Campaign Managera 360 (CM360), jak i 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)

Wymagane. Stały. Identyfikator konta w konfiguracji Floodlight CM360 połączonej z reklamodawcą DV360.

cmFloodlightConfigId

string (int64 format)

Wymagane. Stały. Identyfikator konfiguracji Floodlight w CM360 połączonej z reklamodawcą DV360.

cmAdvertiserIds[]

string (int64 format)

Tylko dane wyjściowe. Zbiór identyfikatorów reklamodawców CM360 korzystających z tej samej konfiguracji Floodlight w CM360.

cmSyncableSiteIds[]

string (int64 format)

Lista witryn w CM360, których miejsca docelowe będą synchronizowane z DV360 jako kreacje.

Jeśli go nie ma lub nie ma w polu metody advertisers.create, system automatycznie utworzy witrynę w CM360.

Usunięcie witryn z tej listy może spowodować usunięcie kreacji DV360 zsynchronizowanych z CM360. Musisz podać co najmniej jedną witrynę.

dv360ToCmDataSharingEnabled

boolean

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

dv360ToCmCostReportingEnabled

boolean

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

cmFloodlightLinkingAuthorized

boolean

Wymagane. Stały. Ustawiając to pole na true, zezwalasz w imieniu swojej firmy na udostępnianie informacji z danej konfiguracji Floodlight tym sieci reklamowej & Reklamodawca wideo 360.

AdvertiserCreativeConfig

Ustawienia związane z kreacjami reklamodawcy.

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

string (int64 format)

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

obaComplianceDisabled

boolean

Określa, czy wyłączyć oferowaną przez Google funkcję „O tej reklamie”, która dodaje plakietki (aby zidentyfikować treść jako reklamę) i informacje o przejrzystości (w przypadku interakcji z funkcją „O tej reklamie”) do Twoich reklam pod kątem internetowych reklam behawioralnych (OBA) i zgodnie z przepisami. Dzięki funkcji „O tej reklamie” użytkownicy mają większą kontrolę nad wyświetlanymi reklamami i wyjaśniają, dlaczego widzą Twoją reklamę. Więcej informacji

Jeśli ustawisz w tym polu wartość true, pamiętaj, że reklamy wyświetlane przez sieć reklamową Filmy 360 muszą spełniać te wymagania:

  • zachować zgodność z zasadami internetowych reklam behawioralnych (OBA) zgodnie z warunkami Twojej umowy z Google Marketing Platform.
  • w Europejskim Obszarze Gospodarczym należy udostępniać informacje o przejrzystości i mechanizm zgłaszania nielegalnych treści zawartych w reklamach. Jeśli korzystasz z alternatywnego rozwiązania do obsługi plakietek, przejrzystości i zgłaszania reklam, musisz upewnić się, że zawiera ono wymagane informacje dotyczące przejrzystości i mechanizm zgłaszania nielegalnych treści. Powiadom Google też o wszelkich zgłoszeniach treści niezgodnych z prawem, korzystając z odpowiedniego formularza.
dynamicCreativeEnabled

boolean

Określa, czy reklamodawca ma włączone kreacje dynamiczne.

videoCreativeDataSharingAuthorized

boolean

Ustawiając to pole na true, upoważniasz w imieniu swojej firmy Google do używania kreacji wideo powiązanych z tymi reklamami Reklamodawca wideo 360 zapewniający raportowanie i funkcje związane z kampaniami telewizyjnymi reklamodawcy.

Ma zastosowanie tylko wtedy, gdy reklamodawca ma konfigurację serwera reklam CM360 hybrid.

AdvertiserDataAccessConfig

Ustawienia, które określają sposób dostępu do danych powiązanych z reklamodawcą.

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

object (AdvertiserSdfConfig)

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

Jeśli nie określono tego ustawienia, 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

Wskazuje, czy reklamodawca zastępuje konfigurację plików SDF swojego partnera nadrzędnego.

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

sdfConfig

object (SdfConfig)

Konfiguracja SDF reklamodawcy.

AdvertiserTargetingConfig

Ustawienia kierowania związane z wyświetlaniem reklam przez danego reklamodawcę.

Zapis JSON
{
  "exemptTvFromViewabilityTargeting": boolean
}
Pola
exemptTvFromViewabilityTargeting

boolean

Określa, czy urządzenia CTV są wykluczone z kierowania według widoczności w przypadku wszystkich elementów zamówienia wideo należących do reklamodawcy.

AdvertiserBillingConfig

Ustawienia płatności reklamodawcy.

Zapis JSON
{
  "billingProfileId": string
}
Pola
billingProfileId

string (int64 format)

Identyfikator profilu płatności przypisanego do reklamodawcy.

Metody

audit

przeprowadza audyt reklamodawcy;

create

Tworzy nowego reklamodawcę.

delete

Usuwa reklamodawcę.

editAssignedTargetingOptions

Umożliwia edycję opcji kierowania w ramach jednego reklamodawcy.

get

Pobiera reklamodawcę.

list

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

listAssignedTargetingOptions

Wyświetla listę opcji kierowania przypisanych do reklamodawcy w różnych typach kierowania.

patch

Aktualizuje istniejącego reklamodawcę.