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. Hier wird festgelegt, ob Anzeigenaufträge und Werbebuchungen des Werbetreibenden ihr 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 der Wert auf ENTITY_STATUS_SCHEDULED_FOR_DELETION festgelegt ist, wird der Werbetreibende 30 Tage nach dem geplanten Löschzeitpunkt gelöscht.
updateTime

string (Timestamp format)

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

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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, mit denen festgelegt wird, 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 ignoriert, wenn sie angegeben werden.
servingConfig

object (AdvertiserTargetingConfig)

Targeting-Einstellungen im Zusammenhang mit der 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 gestatte ich Mediaocean (Prisma), Pläne für Budgetsegmente an Google zu senden. Außerdem gestatte ich Google, zugehörige Berichte und Rechnungen von DV360 zur Budgetplanung, zur Abrechnung und zum Abgleich für diesen Werbetreibenden an Mediaocean zu senden.
billingConfig

object (AdvertiserBillingConfig)

Erforderlich. 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 Hauptwebsite des Werbetreibenden. Das System sendet diese Informationen an Publisher, die eine Website-URL benötigen, um eine Kampagne mit einem Werbetreibenden zu verknüpfen.

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 TZ-Datenbank 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 hybriden CM360-Werbetreibenden entspricht die Zeitzone der des verknüpften CM360-Kontos. Bei Werbetreibenden, die ausschließlich Drittanbieter-Tools verwenden, entspricht die Zeitzone der des übergeordneten Partners.
currencyCode

string

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

Folgende Codes und die zugehörigen Währungen sind zulässig:

Währungscode : Währungsname

  • ARS : Argentinischer Peso
  • AUD : Australischer Dollar
  • BRL : Brasilianischer Real
  • CAD : Kanadischer Dollar
  • CHF : Schweizer Franken
  • CLP : Chilenischer Peso
  • CNY : Chinesischer 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 Schekel
  • INR : Indische Rupie
  • JPY : Japanischer Yen
  • KRW : Südkoreanischer Won
  • MXN : Mexikanische Pesos
  • MYR : Malaysischer Ringgit
  • NGN : 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 
{

  // 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)

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

object (CmHybridConfig)

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

ThirdPartyOnlyConfig

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

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

boolean

Gibt an, ob die Berichterstellung nach Auftrags-ID für Pixel aktiviert ist. Dieser Wert kann nicht mehr geändert werden, nachdem 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 CM360-Werbetreibenden-IDs, die dieselbe CM360-Floodlight-Konfiguration verwenden.
cmSyncableSiteIds[]

string (int64 format)

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

Wenn in der advertisers.create-Methode kein Wert angegeben oder das Feld leer ist, erstellt das System automatisch eine CM360-Website.

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

boolean

Ob DV360-Daten in CM360-Berichte zur Datenübertragung eingeschlossen werden sollen.
dv360ToCmCostReportingEnabled

boolean

Ob DV360-Kosten in CM360 erfasst werden sollen.
cmFloodlightLinkingAuthorized

boolean

Erforderlich. Nicht veränderbar. Wenn Sie dieses Feld auf true festlegen, genehmigen Sie im Namen Ihres Unternehmens die Freigabe von Informationen aus der angegebenen 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 ID für die Konfiguration der Kampagnenüberwachung durch Integral Ad Service (IAS). Das DV360-System fügt dem Creative-Tag ein IAS-Tag vom Typ „Campaign Monitor“ mit dieser ID hinzu.
obaComplianceDisabled

boolean

Legen Sie fest, ob die Google-Funktion „Infos zur Anzeige“ deaktiviert werden soll. Diese Funktion fügt Ihren Anzeigen Kennzeichnungen (zur Kennzeichnung des Inhalts als Werbung) und Informationen zur Transparenz (bei Interaktion mit „Infos zur Anzeige“) hinzu, um die Anforderungen an verhaltensbezogene Onlinewerbung (OBA) und an die Regulierung einzuhalten. 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, müssen Anzeigen, die über Display & Video 360 ausgeliefert werden, Folgendes erfüllen:

  • 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 Transparenzinformationen und einen Mechanismus angeben, mit dem Nutzer illegale Inhalte in Anzeigen melden können. Wenn Sie eine alternative Lösung für die Anzeigenkennzeichnung, Werbetransparenz und Berichte verwenden, müssen Sie dafür sorgen, dass sie die erforderlichen Informationen zur Transparenz und einen Mechanismus zur Meldung 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 dynamische Creatives für den Werbetreibenden aktiviert sind.
videoCreativeDataSharingAuthorized

boolean

Wenn Sie dieses Feld auf true festlegen, erteilen Sie im Namen Ihres Unternehmens Google die Berechtigung, 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, die festlegen, wie auf werbebezogene Daten zugegriffen werden darf.

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

object (AdvertiserSdfConfig)

Einstellungen für strukturierte Datendateien (Structured Data Files, SDFs) 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, legen Sie in diesem Feld den Wert true fest und geben Sie die neue Konfiguration in sdfConfig an.
sdfConfig

object (SdfConfig)

Die SDF-Konfiguration für den Werbetreibenden.

AdvertiserTargetingConfig

Targeting-Einstellungen im Zusammenhang mit der Anzeigenbereitstellung eines Werbetreibenden.

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

boolean

Ob 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

 Audits für einen Werbetreibenden

create

 Erstellt einen neuen Werbetreibenden.

delete

 Löscht einen Werbetreibenden.

editAssignedTargetingOptions

 Hier können Sie die Targeting-Optionen für einen einzelnen Werbetreibenden bearbeiten.

get

 Ruft einen Werbetreibenden ab.

list

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

listAssignedTargetingOptions

 Hier werden die zugewiesenen Targeting-Optionen eines Werbetreibenden für verschiedene Targeting-Typen aufgelistet.

patch

 Aktualisiert einen vorhandenen Werbetreibenden.