REST Resource: advertisers

Ressource: Werbetreibender

Ein einzelner Werbetreibender in Display & Video 360 (DV360).

JSON-Darstellung 
{
  "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
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname des Werbetreibenden.
advertiserId

string (int64 format)

Nur Ausgabe. Die eindeutige ID des Werbetreibenden. Vom System zugewiesen.
partnerId

string (int64 format)

Erforderlich. Nicht veränderbar. Die eindeutige ID des Partners, zu dem der Werbetreibende gehört.
displayName

string

Erforderlich. Der Anzeigename des Werbetreibenden.

Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein.
entityStatus

enum (EntityStatus)

Erforderlich. Hier können Sie festlegen, ob für Anzeigenaufträge und Werbebuchungen des Werbetreibenden Budgets ausgegeben und Gebote für Inventar abgegeben werden können.

  • Zulässige Werte sind ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED und ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Wenn der Wert auf ENTITY_STATUS_SCHEDULED_FOR_DELETION festgelegt ist, wird der Werbetreibende 30 Tage nach der ersten Planung zum Löschen gelöscht.
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann der Werbetreibende zuletzt aktualisiert wurde. Vom System zugewiesen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
generalConfig

object (AdvertiserGeneralConfig)

Erforderlich. Allgemeine Einstellungen des Werbetreibenden.
adServerConfig

object (AdvertiserAdServerConfig)

Erforderlich. Nicht veränderbar. Ad-Server-bezogene Einstellungen des Werbetreibenden.
creativeConfig

object (AdvertiserCreativeConfig)

Erforderlich. Creative-bezogene Einstellungen des Werbetreibenden.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Einstellungen, die regeln, wie auf Daten von Werbetreibenden zugegriffen werden darf.
integrationDetails

object (IntegrationDetails)

Integrationsdetails des Werbetreibenden. Derzeit gilt nur integrationCode für den Werbetreibenden. Andere Felder von IntegrationDetails werden nicht unterstützt und werden ignoriert, falls sie angegeben werden.
servingConfig

object (AdvertiserTargetingConfig)

Targeting-Einstellungen für die Anzeigenbereitstellung des Werbetreibenden.
prismaEnabled

boolean

Gibt an, ob die Integration mit Mediaocean (Prisma) aktiviert ist. Wenn Sie diese Option aktivieren, stimmen Sie Folgendem zu:

Im Namen meines Unternehmens autorisiere ich Mediaocean (Prisma), Budgetsegmentpläne an Google zu senden, und ich autorisiere Google, entsprechende Berichte und Rechnungen aus DV360 an Mediaocean zu senden, um Budgetplanung, Abrechnung und Abgleich für diesen Werbetreibenden zu ermöglichen.
billingConfig

object (AdvertiserBillingConfig)

Erforderlich. Abrechnungsbezogene Einstellungen des Werbetreibenden.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Optional. Gibt an, ob dieser Werbetreibende Werbebuchungen enthält, mit denen politische Werbung in der EU ausgeliefert wird.

Wenn dieses Feld auf DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING gesetzt ist, geschieht Folgendes:

  • Allen neuen Werbebuchungen, die unter diesem Werbetreibenden erstellt werden, wird DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING zugewiesen, sofern nicht anders angegeben.
  • Alle vorhandenen Werbebuchungen unter diesem Werbetreibenden, für die kein Wert festgelegt ist, werden innerhalb eines Tages auf DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING aktualisiert.
defaultBusinessName

string

Optional. Der Standardname des Unternehmens des Werbetreibenden.

Dieser Wert wird für YouTube- und Demand Gen-Anzeigen dieses Werbetreibenden verwendet, wenn kein Name des Unternehmens angegeben ist.
defaultLogoAssetId

string (int64 format)

Optional. Die Asset-ID des Standardlogobilds für den Werbetreibenden.

Dies ist die Asset-ID, die von YouTube- und Demand-Anzeigen unter diesem Werbetreibenden verwendet wird, wenn kein Logo-Asset angegeben ist.

Sie müssen advertisers.adAssets.upload verwenden, um dieses Asset über die API hochzuladen.

AdvertiserGeneralConfig

Allgemeine Einstellungen eines Werbetreibenden.

JSON-Darstellung 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
Felder
domainUrl

string

Erforderlich. Die Domain-URL der primären Website des Werbetreibenden. Das System sendet diese Informationen an Publisher, die eine Website-URL benötigen, um eine Kampagne einem Werbetreibenden zuzuordnen.

Geben Sie eine URL ohne Pfad oder Abfragestring an, die mit http: oder https: beginnt. Beispiel: http://www.beispiel.de
timeZone

string

Nur Ausgabe. Der Standardname der Zeitzone des Werbetreibenden aus der TZ-Datenbank. Beispiel: America/New_York.

Weitere Informationen finden Sie unter https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

Bei CM360-Hybridwerbetreibenden entspricht die Zeitzone der des zugehörigen CM360-Kontos. Bei Werbetreibenden, die nur Drittanbieter verwenden, entspricht die Zeitzone der des übergeordneten Partners.
currencyCode

string

Erforderlich. Nicht veränderbar. Die Währung des Werbetreibenden im ISO 4217-Format.

Die akzeptierten Codes und die Währungen, die sie repräsentieren, sind:

Währungscode : Name der Währung

  • ARS : Argentinischer Peso
  • AUD : Australischer Dollar
  • BRL : Brasilianischer Real
  • CAD : Kanadischer Dollar
  • CHF : Schweizer Franken
  • CLP : Chilenischer Peso
  • CNY : Chinesischer Renminbi
  • COP : Kolumbianischer Peso
  • CZK : Tschechische Krone
  • DKK : Dänische Krone
  • EGP : Ägyptisches Pfund
  • EUR : Euro
  • GBP : Britisches Pfund
  • HKD : Hongkong-Dollar
  • HUF : Ungarischer Forint
  • IDR : Indonesische Rupiah
  • ILS : Israelischer Schekel
  • INR : Indische Rupie
  • JPY : Japanischer Yen
  • KRW : Südkoreanischer Won
  • MXN : Mexikanische Pesos
  • MYR : Malaysischer Ringgit
  • NGN : Nigerianischer Naira
  • NOK : Norwegische Krone
  • NZD : Neuseeland-Dollar
  • PEN : Peruanischer Nuevo Sol
  • PLN : Polnischer Złoty
  • RON : Neuer rumänischer Leu
  • RUB : Russischer Rubel
  • SEK : Schwedische Krone
  • TRY : Türkische Lira
  • TWD : Neuer Taiwan-Dollar
  • USD : US-Dollar
  • ZAR : Südafrikanischer Rand

AdvertiserAdServerConfig

Ad-Server-bezogene Einstellungen eines Werbetreibenden.

JSON-Darstellung 
{

  // 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.
}
Felder
Erforderlich. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Die Konfiguration für Werbetreibende, die nur Ad-Server von Drittanbietern verwenden.
cmHybridConfig

object (CmHybridConfig)

Die Konfiguration für Werbetreibende, die sowohl Campaign Manager 360 (CM360) als auch Ad-Server von Drittanbietern verwenden.
Ende der sich gegenseitig ausschließenden Felder.

ThirdPartyOnlyConfig

Einstellungen für Werbetreibende, die nur Ad-Server von Drittanbietern verwenden.

JSON-Darstellung 
{
  "pixelOrderIdReportingEnabled": boolean
}
Felder
pixelOrderIdReportingEnabled

boolean

Gibt an, ob die Berichterstellung für Bestell-IDs für Pixel aktiviert ist. Dieser Wert kann nicht mehr geändert werden, sobald er auf true festgelegt wurde.

CmHybridConfig

Einstellungen für Werbetreibende, die sowohl Campaign Manager 360 (CM360) als auch Ad-Server von Drittanbietern verwenden.

JSON-Darstellung 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Felder
cmAccountId

string (int64 format)

Erforderlich. Nicht veränderbar. Konto-ID der CM360-Floodlight-Konfiguration, die mit dem DV360-Werbetreibenden verknüpft ist.
cmFloodlightConfigId

string (int64 format)

Erforderlich. Nicht veränderbar. ID der CM360-Floodlight-Konfiguration, die mit dem DV360-Werbetreibenden verknüpft ist.
cmAdvertiserIds[]

string (int64 format)

Nur Ausgabe. Die Gruppe von CM360-Werbetreibenden-IDs, für die die CM360-Floodlight-Konfiguration freigegeben ist.
cmSyncableSiteIds[]

string (int64 format)

Eine Liste der CM360-Websites, deren Placements als Creatives mit DV360 synchronisiert werden.

Wenn sie in der advertisers.create-Methode fehlt oder leer ist, wird automatisch eine CM360-Website erstellt.

Wenn Sie Websites aus dieser Liste entfernen, werden möglicherweise DV360-Creatives gelöscht, die aus CM360 synchronisiert wurden. Es muss mindestens ein Standort angegeben werden.
dv360ToCmDataSharingEnabled

boolean

Gibt an, ob DV360-Daten in CM360-Datenübertragungsberichte aufgenommen werden sollen.
dv360ToCmCostReportingEnabled

boolean

Gibt an, ob DV360-Kosten in CM360 erfasst werden sollen.
cmFloodlightLinkingAuthorized

boolean

Erforderlich. Nicht veränderbar. Wenn Sie dieses Feld auf true setzen, autorisieren Sie im Namen Ihres Unternehmens die Weitergabe von Informationen aus der angegebenen Floodlight-Konfiguration an diesen Display & Video 360-Werbetreibenden.

AdvertiserCreativeConfig

Creative-bezogene Einstellungen eines Werbetreibenden.

JSON-Darstellung 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Felder
iasClientId

string (int64 format)

Eine ID zum Konfigurieren der Kampagnenüberwachung, die von Integral Ad Service (IAS) bereitgestellt wird. Das DV360-System fügt dem Creative-Tag ein IAS-Tag für „Campaign Monitor“ mit dieser ID hinzu.
obaComplianceDisabled

boolean

Ob Sie die Google-Funktion „Infos zur Anzeige“ deaktivieren möchten, mit der Ihren Anzeigen für verhaltensbezogene Onlinewerbung (OBA) und behördliche Anforderungen ein Logo hinzugefügt wird, das den Inhalt als Werbung ausweist, und Informationen zur Transparenz bereitgestellt werden (wenn mit „Über diese Anzeige“ interagiert wird). Mit „Infos zur Anzeige“ können Nutzer besser steuern, welche Anzeigen ihnen präsentiert werden. Außerdem können Sie ihnen erklären, warum sie Ihre Anzeige sehen. Weitere Informationen

Wenn Sie dieses Feld auf true festlegen, beachten Sie bitte, dass Anzeigen, die über Display & Video 360 ausgeliefert werden, die folgenden Anforderungen erfüllen müssen:

  • Sie müssen gemäß Ihrem Vertrag mit der Google Marketing Platform OBA-konform (Online Behavioral Advertising) sein.
  • Im Europäischen Wirtschaftsraum (EWR) müssen Sie in Anzeigen Transparenzinformationen und eine Funktion zum Melden illegaler Inhalte einfügen. Wenn Sie eine alternative Lösung zur Anzeigenkennzeichnung, Transparenz und Berichterstellung verwenden, müssen Sie dafür sorgen, dass sie die erforderlichen Transparenzinformationen und die Funktion zum Melden illegaler Inhalte enthält. Außerdem müssen Sie Google über das entsprechende Formular über Meldungen von illegalen Inhalten informieren.
dynamicCreativeEnabled

boolean

Gibt an, ob der Werbetreibende für dynamische Creatives aktiviert ist.
videoCreativeDataSharingAuthorized

boolean

Wenn Sie dieses Feld auf true festlegen, autorisieren Sie Google im Namen Ihres Unternehmens, Video-Creatives, die mit diesem Display & Video 360-Werbetreibenden verknüpft sind, für Berichte und Funktionen im Zusammenhang mit den TV-Kampagnen des Werbetreibenden zu verwenden.

Gilt nur, wenn der Werbetreibende eine CM360 hybrid-Ad-Server-Konfiguration hat.

AdvertiserDataAccessConfig

Einstellungen, mit denen gesteuert wird, wie auf Daten zu Werbetreibenden zugegriffen werden kann.

JSON-Darstellung 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Felder
sdfConfig

object (AdvertiserSdfConfig)

Einstellungen für Dateien mit strukturierten Daten (Structured Data Files, SDF) für den Werbetreibenden.

Wenn keine Angabe erfolgt, werden die SDF-Einstellungen des übergeordneten Partners verwendet.

AdvertiserSdfConfig

Einstellungen für Dateien mit strukturierten Daten (Structured Data Files, SDF) eines Werbetreibenden.

JSON-Darstellung 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Felder
overridePartnerSdfConfig

boolean

Gibt an, ob dieser Werbetreibende die SDF-Konfiguration seines übergeordneten Partners überschreibt.

Standardmäßig übernimmt ein Werbetreibender die SDF-Konfiguration vom übergeordneten Partner. Wenn Sie die Partnerkonfiguration überschreiben möchten, legen Sie dieses Feld auf true fest und geben Sie die neue Konfiguration in sdfConfig an.
sdfConfig

object (SdfConfig)

Die SDF-Konfiguration für den Werbetreibenden.

AdvertiserTargetingConfig

Targeting-Einstellungen für die Anzeigenbereitstellung eines Werbetreibenden.

JSON-Darstellung 
{
  "exemptTvFromViewabilityTargeting": boolean
}
Felder
exemptTvFromViewabilityTargeting

boolean

Gibt an, ob Geräte für internetfähige Fernseher für alle Videowerbebuchungen des Werbetreibenden vom Sichtbarkeits-Targeting ausgenommen sind.

AdvertiserBillingConfig

Abrechnungsbezogene Einstellungen eines Werbetreibenden.

JSON-Darstellung 
{
  "billingProfileId": string
}
Felder
billingProfileId

string (int64 format)

Erforderlich. Die ID eines Abrechnungsprofils, das dem Werbetreibenden zugewiesen ist.

Methoden

audit

 Prüfungen für einen Werbetreibenden durchführen

create

 Erstellt einen neuen Werbetreibenden.

delete

 Löscht einen Werbetreibenden.

editAssignedTargetingOptions

 Bearbeitet Targeting-Optionen für einen einzelnen Werbetreibenden.

get

 Ruft einen Werbetreibenden ab.

list

 Listet Werbetreibende auf, auf die der aktuelle Nutzer Zugriff hat.

listAssignedTargetingOptions

 Hier werden die Targeting-Optionen eines Werbetreibenden für alle Targeting-Typen aufgeführt.

patch

 Aktualisiert einen vorhandenen Werbetreibenden.