REST Resource: advertisers

Zasób: reklamodawca

pojedynczego reklamodawcę 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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
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)

Wymagane. Wartość niezmienna. Unikalny identyfikator partnera, do którego należy reklamodawca.
displayName

string

Wymagane. Wyświetlana nazwa reklamodawcy.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 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 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.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też 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)

Wymagane. Ustawienia ogólne reklamodawcy.
adServerConfig

object (AdvertiserAdServerConfig)

Wymagane. Wartość niezmienna. Ustawienia reklamodawcy związane z serwerem reklam.
creativeConfig

object (AdvertiserCreativeConfig)

Wymagane. Ustawienia reklamodawcy związane z kreacjami.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Ustawienia, które określają, w jaki sposób można uzyskać dostęp do danych reklamodawcy.
integrationDetails

object (IntegrationDetails)

Szczegóły integracji reklamodawcy. Obecnie reklamodawca może korzystać tylko z 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 reklamodawcy.
prismaEnabled

boolean

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

W imieniu mojej firmy upoważniam 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 Mediaocean na potrzeby planowania budżetu, rozliczeń i uzgadniania w przypadku tego reklamodawcy.
billingConfig

object (AdvertiserBillingConfig)

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

enum (EuPoliticalAdvertisingStatus)

Opcjonalnie: Czy ten reklamodawca zawiera elementy zamówienia, które wyświetlają reklamy polityczne w Unii Europejskiej.

Jeśli to pole ma wartość DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, zostaną wykonane te działania:

  • Wszystkie nowe elementy zamówienia utworzone w ramach tego reklamodawcy zostaną przypisane do: DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, chyba że określono inaczej.
  • Wszystkie dotychczasowe elementy zamówienia tego reklamodawcy, które nie mają ustawionej wartości, zostaną zaktualizowane do DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING w ciągu dnia.
defaultBusinessName

string

Opcjonalnie: Domyślna nazwa firmy reklamodawcy.

Jeśli nie podasz nazwy firmy, w reklamach w YouTube i reklamach generujących popyt tego reklamodawcy będzie używana ta wartość.
defaultLogoAssetId

string (int64 format)

Opcjonalnie: Identyfikator zasobu domyślnego obrazu logo reklamodawcy.

To jest identyfikator zasobu, który będzie używany przez reklamy w YouTube i reklamy generujące popyt w przypadku tego reklamodawcy, jeśli nie zostanie podany komponent z logo.

Aby przesłać ten zasób za pomocą interfejsu API, musisz użyć advertisers.adAssets.upload.

AdvertiserGeneralConfig

Ustawienia ogólne 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, aby powiązać kampanię z reklamodawcą.

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

string

Tylko dane wyjściowe. Standardowa nazwa strefy czasowej reklamodawcy w bazie danych TZ. 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. W przypadku reklamodawców korzystających tylko z serwera reklamowego firmy zewnętrznej strefa czasowa jest taka sama jak u partnera nadrzędnego.
currencyCode

string

Wymagane. Wartość niezmienna. Waluta reklamodawcy w formacie ISO 4217.

Akceptowane kody i waluty, które reprezentują:

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 : 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
Pola
Wymagane. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
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.
Koniec pól wykluczających się wzajemnie.

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)

Wymagane. Wartość niezmienna. Identyfikator konta konfiguracji Floodlight CM360 połączonej z reklamodawcą DV360.
cmFloodlightConfigId

string (int64 format)

Wymagane. Wartość 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órzy korzystają z tej samej konfiguracji Floodlight CM360.
cmSyncableSiteIds[]

string (int64 format)

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

Jeśli w metodzie advertisers.create nie ma tej wartości lub jest ona pusta, 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 CM360.
dv360ToCmCostReportingEnabled

boolean

Określa, czy raportować koszty DV360 w CM360.
cmFloodlightLinkingAuthorized

boolean

Wymagane. Wartość niezmienna. Ustawiając to pole na true, w imieniu swojej firmy upoważniasz do udostępniania informacji z danej konfiguracji Floodlight temu reklamodawcy 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 do konfigurowania monitorowania kampanii udostępniany przez Integral Ad Service (IAS). System DV360 dołączy do tagu kreacji tag IAS „Campaign Monitor” zawierający ten identyfikator.
obaComplianceDisabled

boolean

Określa, czy wyłączyć funkcję Google „O tej reklamie”, która dodaje do reklam oznaczenia reklam (umożliwiające identyfikację treści jako reklamy) i informacje dotyczące przejrzystości (w przypadku interakcji z funkcją „O tej reklamie”) w celu spełnienia wymagań dotyczących internetowej reklamy behawioralnej (OBA) i wymagań prawnych. Komunikaty „O tej reklamie” zapewniają użytkownikom większą kontrolę nad wyświetlanymi im reklamami i pomagają Ci wyjaśnić, dlaczego odbiorcy widzą Twoją reklamę. Więcej informacji

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

  • Zgodnie z zawartą umową z Google Marketing Platform reklamy muszą być zgodne z zasadami internetowej reklamy behawioralnej (OBA).
  • W Europejskim Obszarze Gospodarczym (EOG) reklamy muszą zawierać informacje dotyczące przejrzystości oraz mechanizm umożliwiający użytkownikom zgłaszanie treści niezgodnych z prawem. Jeśli korzystasz z alternatywnego rozwiązania do oznaczania reklam, zapewniania 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 oraz że powiadamiasz Google o wszelkich zgłoszeniach treści niezgodnych z prawem za pomocą odpowiedniego formularza.
dynamicCreativeEnabled

boolean

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

boolean

Ustawiając to pole na true, w imieniu swojej firmy upoważniasz Google do używania kreacji wideo powiązanych z tym reklamodawcą Display & Video 360 w celu dostarczania raportów i funkcji związanych z kampaniami telewizyjnymi reklamodawcy.

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

AdvertiserDataAccessConfig

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

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

object (AdvertiserSdfConfig)

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

Jeśli nie zostanie określone, używane będą 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 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 polu 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ą wykluczone z kierowania według widoczności we wszystkich elementach zamówienia wideo reklamodawcy.

AdvertiserBillingConfig

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

Zapis JSON 
{
  "billingProfileId": string
}
Pola
billingProfileId

string (int64 format)

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

Metody

audit

 Przeprowadza kontrolę reklamodawcy.

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 ma dostęp bieżący użytkownik.

listAssignedTargetingOptions

 Wyświetla listę przypisanych opcji kierowania reklamodawcy według typów kierowania.

patch

 Aktualizuje istniejącego reklamodawcę.