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)
  }
}
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. Steuert, ob Anzeigenaufträge und Werbebuchungen des Werbetreibenden sein Budget ausgeben und auf Inventar bieten können.

  • Zulässige Werte sind ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED und ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Wenn ENTITY_STATUS_SCHEDULED_FOR_DELETION festgelegt ist, wird der Werbetreibende 30 Tage nach der geplanten Löschung gelöscht.
updateTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel des Zeitpunkts der letzten Aktualisierung des Werbetreibenden. Vom System zugewiesen.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
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, mit denen der Zugriff auf die Daten von Werbetreibenden festgelegt wird.
integrationDetails

object (IntegrationDetails)

Integrationsdetails des Werbetreibenden. Für den Werbetreibenden ist derzeit nur integrationCode anwendbar. Andere Felder von „IntegrationDetails“ werden nicht unterstützt und ignoriert, falls sie angegeben sind.
servingConfig

object (AdvertiserTargetingConfig)

Targeting-Einstellungen, die sich auf die Anzeigenbereitstellung des Werbetreibenden beziehen.
prismaEnabled

boolean

Gibt an, ob die Integration mit Mediaocean (Prisma) aktiviert ist. Wenn Sie diese Option aktivieren, erklären Sie sich mit Folgendem einverstanden:

Im Namen meines Unternehmens autorisiere ich Mediaocean (Prisma), Pläne für Budgetsegmente an Google zu senden. Außerdem autorisiere ich Google, entsprechende Berichte und Rechnungen von DV360 an Mediaocean zu senden, um Budgetplanung, Abrechnung und Abgleich für diesen Werbetreibenden durchzuführen.
billingConfig

object (AdvertiserBillingConfig)

Abrechnungsbezogene Einstellungen des Werbetreibenden

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.example.com
timeZone

string

Nur Ausgabe Der Standard-TZ-Datenbankname der Zeitzone des Werbetreibenden. Beispiel: America/New_York.

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

Bei Werbetreibenden mit einem CM360-Hybridkonto ist die Zeitzone mit der des zugehörigen CM360-Kontos identisch. Bei Werbetreibenden, die nur Drittanbieter verwenden, entspricht die Zeitzone der des übergeordneten Partners.
currencyCode

string

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

Zulässige Codes und die Währungen, die sie repräsentieren:

Währungscode : Währungsname

  • ARS : Argentinischer Peso
  • AUD : Australischer Dollar
  • BRL : Brasilianischer Real
  • CAD : Kanadischer Dollar
  • CHF : Schweizer Franken
  • CLP : Chilenischer Peso
  • CNY : Chinesischer Renminbi Yuan
  • 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 Neuer Schekel
  • INR : Indische Rupie
  • JPY : Japanischer Yen
  • KRW : Südkoreanischer Won
  • MXN : Mexikanischer Peso
  • MYR : Malaysischer Ringgit
  • NGN : Nigerianischer Naira
  • NOK : Norwegische Krone
  • NZD : Neuseeland-Dollar
  • PEN : Peruanischer Nuevo Sol
  • PLN : Polnischer Zloty
  • 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 
{

  // 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.
}
Felder
Union-Feld ad_server_config_scheme Erforderlich. Für ad_server_config_scheme ist nur einer der folgenden Werte zulässig:
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 eines Drittanbieters verwenden.

ThirdPartyOnlyConfig

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

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

boolean

Gibt an, ob die Berichterstellung zu Auftrags-IDs für Pixel aktiviert ist. Wenn dieser Wert auf „true“ festgelegt ist, kann er nicht mehr geändert werden.

CmHybridConfig

Einstellungen für Werbetreibende, die sowohl Campaign Manager 360 (CM360) als auch Ad-Server eines Drittanbieters 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 Gruppe von CM360-Werbetreibenden-IDs mit der gemeinsamen CM360-Floodlight-Konfiguration.
cmSyncableSiteIds[]

string (int64 format)

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

Wenn diese Angabe in der advertisers.create-Methode fehlt oder leer ist, erstellt das System automatisch eine CM360-Website.

Wenn Sie Websites aus dieser Liste entfernen, werden möglicherweise die mit CM360 synchronisierten DV360-Creatives gelöscht. Es muss mindestens eine Website angegeben werden.
dv360ToCmDataSharingEnabled

boolean

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

boolean

Gibt an, ob DV360-Kosten an CM360 gesendet werden.
cmFloodlightLinkingAuthorized

boolean

Erforderlich. Nicht veränderbar. Wenn Sie dieses Feld auf true setzen, autorisieren Sie im Namen Ihres Unternehmens die Freigabe der Informationen aus der Floodlight-Konfiguration für 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 von Integral Ad Service (IAS) bereitgestellte ID zum Konfigurieren der Kampagnenüberwachung. Das DV360-System hängt das IAS-Tag „Campaign Monitor“ mit dieser ID an das Creative-Tag an.
obaComplianceDisabled

boolean

Gibt an, ob die Funktion „Infos zur Anzeige“ von Google deaktiviert werden soll, durch die Ihren Anzeigen für verhaltensbezogene Onlinewerbung (Online Behavioral Advertising, OBA) sowie behördliche Anforderungen ein Logo hinzugefügt wird, um den Inhalt als Anzeige zu kennzeichnen, und Transparenzinformationen (bei Interaktion mit der Anzeige). Über „Infos zur Anzeige“ haben Nutzer mehr Kontrolle darüber, welche Anzeigen ihnen präsentiert werden, und können erklären, warum sie Ihre Anzeige sehen. Weitere Informationen

Wenn Sie dieses Feld auf true setzen, müssen Anzeigen, die über Display & Video 360 ausgeliefert werden, folgende Anforderungen erfüllen:

  • Die OBA-Anforderungen (Online Behavioral Advertising) entsprechen Ihrem Vertrag mit der Google Marketing Platform.
  • Im Europäischen Wirtschaftsraum (EWR) müssen Sie Transparenzinformationen und einen Mechanismus für Nutzer zur Meldung illegaler Inhalte in Anzeigen bereitstellen. Wenn Sie eine alternative Lösung zur Kennzeichnung von Anzeigen, zur Transparenz und zur Meldung von Inhalten verwenden, müssen Sie dafür sorgen, dass diese die erforderlichen Transparenzinformationen und einen Meldemechanismus für illegale Inhalte enthält. Außerdem müssen Sie Google über das entsprechende Formular über Meldungen zu illegalen Inhalten informieren.
dynamicCreativeEnabled

boolean

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

boolean

Wenn Sie dieses Feld auf true setzen, autorisieren Sie Google im Namen Ihres Unternehmens, Video-Creatives zu verwenden, die mit diesem Display & Video 360-Werbetreibenden verknüpft sind, um Berichte und Funktionen in Bezug auf die Fernsehkampagnen des Werbetreibenden bereitzustellen.

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

AdvertiserDataAccessConfig

Einstellungen, mit denen der Zugriff auf werbetreibendenbezogene Daten festgelegt wird.

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

object (AdvertiserSdfConfig)

Einstellungen für strukturierte Datendateien (Structured Data Files, SDF) für den Werbetreibenden

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

AdvertiserSdfConfig

Einstellungen für strukturierte Datendateien (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, setzen Sie dieses Feld auf true und geben Sie die neue Konfiguration in sdfConfig an.
sdfConfig

object (SdfConfig)

Die SDF-Konfiguration für den Werbetreibenden.

AdvertiserTargetingConfig

Targeting-Einstellungen, die sich auf die Anzeigenbereitstellung eines Werbetreibenden beziehen.

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

boolean

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

AdvertiserBillingConfig

Abrechnungsbezogene Einstellungen eines Werbetreibenden

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

string (int64 format)

Die ID eines Abrechnungsprofils, das dem Werbetreibenden zugewiesen ist.

Wenn kein Wert angegeben wird, wird in diesem Feld standardmäßig die standardmäßige Abrechnungsprofil-ID des übergeordneten Partners des Werbetreibenden verwendet.

Methoden

audit

 Überprüft einen Werbetreibenden.

create

 Erstellt einen neuen Werbetreibenden.

delete

 Löscht einen Werbetreibenden.

editAssignedTargetingOptions

 Bearbeitet die Targeting-Optionen eines einzelnen Werbetreibenden.

get

 Ruft einen Werbetreibenden ab.

list

 Listet die Werbetreibenden auf, auf die der aktuelle Nutzer zugreifen kann.

listAssignedTargetingOptions

 Listet die zugewiesenen Targeting-Optionen eines Werbetreibenden für verschiedene Targeting-Typen auf.

patch

 Aktualisiert einen vorhandenen Werbetreibenden.