REST Resource: advertisers

Zasób: reklamodawca

Jeden 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. Przypisana przez system.
partnerId

string (int64 format)

To pole jest wymagane. Stałe. Unikalny identyfikator partnera, do którego należy reklamodawca.
displayName

string

To pole jest wymagane. Wyświetlana nazwa reklamodawcy.

Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów.
entityStatus

enum (EntityStatus)

To pole jest wymagane. Określa, czy zamówienia reklamowe i elementy zamówienia reklamodawcy mogą wydawać swoje 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 ustawisz 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 formacie „Zulu” RFC3339 UTC 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)

To pole jest wymagane. Ogólne ustawienia reklamodawcy.
adServerConfig

object (AdvertiserAdServerConfig)

To pole jest wymagane. Stałe. Ustawienia reklamodawcy związane z serwerem reklam.
creativeConfig

object (AdvertiserCreativeConfig)

To pole jest wymagane. Ustawienia reklamodawcy związane z kreacją.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Ustawienia określające sposób uzyskiwania dostępu do danych reklamodawcy.
integrationDetails

object (IntegrationDetails)

Szczegóły integracji reklamodawcy. Obecnie reklamodawca ma do dyspozycji tylko integrationCode. Inne pola wartości IntegrationDetails nie są obsługiwane i zostaną zignorowane, jeśli zostaną podane.
servingConfig

object (AdvertiserTargetingConfig)

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

boolean

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

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

object (AdvertiserBillingConfig)

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

AdvertiserGeneralConfig

Ogólne ustawienia reklamodawcy.

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

string

To pole jest wymagane. Adres URL domeny głównej witryny reklamodawcy. System wyśle te informacje do wydawców, którzy do powiązania kampanii z reklamodawcą wymagają adresu URL witryny.

Podaj adres URL bez ścieżki ani ciągu zapytania rozpoczynający się od http: lub https:. np. http://www.example.com.
timeZone

string

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

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

W przypadku reklamodawców hybrydowych CM360 strefa czasowa jest taka sama jak na powiązanym koncie CM360, a w przypadku reklamodawców zewnętrznych jest taka sama jak w przypadku partnera nadrzędnego.
currencyCode

string

To pole jest wymagane. Stałe. Waluta reklamodawcy w formacie ISO 4217.

Akceptowane kody i waluty, w których się pojawiają, 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. To pole jest wymagane. ad_server_config_scheme może być 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 korzystają zarówno z 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 włączone jest raportowanie identyfikatora zamówienia w przypadku pikseli. Po ustawieniu wartości true nie można zmienić tej wartości.

CmHybridConfig

Ustawienia dla reklamodawców, którzy korzystają zarówno z 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)

To pole jest wymagane. Stałe. Identyfikator konta konfiguracji Floodlight CM360 połączonej z reklamodawcą DV360.
cmFloodlightConfigId

string (int64 format)

To pole jest wymagane. Stałe. 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 współdzielą konfigurację Floodlight CM360.
cmSyncableSiteIds[]

string (int64 format)

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

Jeśli jej nie ma w metodzie advertisers.create lub jest ona pusta, system automatycznie utworzy witrynę w CM360.

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

boolean

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

boolean

Określa, czy raport o kosztach DV360 ma być raportowany w CM360.
cmFloodlightLinkingAuthorized

boolean

To pole jest wymagane. Stałe. Ustawiając w tym polu wartość true, zezwalasz w imieniu swojej firmy na udostępnianie informacji z danej konfiguracji Floodlight temu reklamodawcy w Display & Video 360.

AdvertiserCreativeConfig

Ustawienia reklamodawcy związane z kreacjami.

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 tagu kreacji tag „Monitor kampanii” IAS zawierający ten identyfikator.
obaComplianceDisabled

boolean

Określa, czy wyłączyć dostępną w Google funkcję Google „O tej reklamie”, która dodaje plakietki (umożliwiające identyfikację treści jako reklamę) i informacje o przejrzystości (w przypadku interakcji z reklamą „O tej reklamie”) w ramach internetowych reklam behawioralnych (OBA) i wymagań prawnych. Ta reklama zapewnia użytkownikom większą kontrolę nad reklamami, które oglądają, i wyjaśnia, dlaczego widzą Twoją reklamę. Więcej informacji

Jeśli wybierzesz w tym polu wartość true, pamiętaj, że reklamy wyświetlane przez Display & Video 360 muszą być zgodne z tymi zasadami:

  • zapewniać zgodność reklam behawioralnych online (OBA) zgodnie z umową z Google Marketing Platform;
  • W krajach Europejskiego Obszaru Gospodarczego (EOG) informacje o przejrzystości oraz mechanizm zgłaszania nielegalnych treści w reklamach przez użytkowników. Jeśli korzystasz z alternatywnych rozwiązań do zgłaszania treści naruszających zasady, przejrzystości reklam i oznaczeń, musisz zadbać o to, aby zawierały wymagane informacje o przejrzystości i mechanizmie zgłaszania nielegalnych treści. W takim przypadku również powiadamiaj Google o wszelkich zgłaszanych treściach niezgodnych z prawem, korzystając z odpowiedniego formularza.
dynamicCreativeEnabled

boolean

Wskazuje, czy reklamodawca może korzystać z kreacji dynamicznych.
videoCreativeDataSharingAuthorized

boolean

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

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

AdvertiserDataAccessConfig

Ustawienia określające sposób uzyskiwania 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 podasz żadnej wartości, zostaną użyte 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 reklamodawca zastępuje konfigurację SDF swojego partnera nadrzędnego.

Domyślnie reklamodawca dziedziczy konfigurację SDF od partnera nadrzędnego. Aby zastąpić konfigurację partnera, ustaw to pole na true i podaj nową konfigurację w: sdfConfig.
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śla, czy urządzenia CTV są zwolnione 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)

Identyfikator profilu płatności przypisanego do reklamodawcy.

Jeśli nie podasz wartości, w tym polu domyślnie będzie używany domyślny identyfikator profilu płatności partnera nadrzędnego reklamodawcy.

Metody

audit

 Kontroluje reklamodawcę.

create

 Tworzy nowego reklamodawcę.

delete

 Usuwa reklamodawcę.

editAssignedTargetingOptions

 Edytuje opcje kierowania w ramach jednego reklamodawcy.

get

 Pobiera reklamodawcę.

list

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

listAssignedTargetingOptions

 Wyświetla listę opcji kierowania przypisanych przez reklamodawcę według różnych typów kierowania.

patch

 Aktualizuje istniejącego reklamodawcę.