REST Resource: advertisers

Ressource: Werbetreibender

Ein einzelner Werbetreibender in Display- und 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. Damit wird gesteuert, ob die 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 ENTITY_STATUS_SCHEDULED_FOR_DELETION festgelegt ist, wird der Werbetreibende 30 Tage nach der ersten geplanten Löschung gelöscht.
updateTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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-Einstellungen des Werbetreibenden.

creativeConfig

object (AdvertiserCreativeConfig)

Erforderlich. Creative-bezogene Einstellungen des Werbetreibenden.

dataAccessConfig

object (AdvertiserDataAccessConfig)

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

integrationDetails

object (IntegrationDetails)

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

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, stimmen Sie Folgendem zu:

Im Namen meines Unternehmens gestatte 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 für diesen Werbetreibenden Budgetplanung, Abrechnung und Abgleich vorzunehmen.

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 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 Standard-TZ-Datenbankname für die Zeitzone des Werbetreibenden. Beispiel: America/New_York.

Weitere Informationen: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Bei Werbetreibenden mit einem CM360-Hybridkonto entspricht die Zeitzone der Zeitzone des zugehörigen CM360-Kontos. Bei Drittanbieter-Werbetreibenden entspricht die Zeitzone der des übergeordneten Partners.

currencyCode

string

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

Zulässige Codes und die darin enthaltenen Währungen:

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
  • 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-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 eines Drittanbieters verwenden.

cmHybridConfig

object (CmHybridConfig)

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

ThirdPartyOnlyConfig

Einstellungen für Werbetreibende, die nur Ad-Server eines Drittanbieters verwenden.

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

boolean

Gibt an, ob die Berichterstellung nach Auftrags-ID für Pixel aktiviert ist. Sobald 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 nutzen.

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 mit derselben CM360-Floodlight-Konfiguration.

cmSyncableSiteIds[]

string (int64 format)

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

Falls dieser Parameter in der Methode advertisers.create fehlt oder leer ist, erstellt das System automatisch eine CM360-Website.

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

dv360ToCmDataSharingEnabled

boolean

Gibt an, ob DV360-Daten in CM360-Datenübertragungsberichten berücksichtigt werden sollen.

dv360ToCmCostReportingEnabled

boolean

Gibt an, ob DV360-Kosten an CM360 gemeldet werden sollen.

cmFloodlightLinkingAuthorized

boolean

Erforderlich. Nicht veränderbar. Indem Sie dieses Feld auf true setzen, autorisieren Sie im Namen Ihres Unternehmens die Freigabe von Informationen aus der angegebenen Floodlight-Konfiguration für diese Display- und Video 360-Werbetreibender

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. Im DV360-System wird der IAS „Campaign Monitor“ hinzugefügt. -Tag mit dieser ID in das Creative-Tag ein.

obaComplianceDisabled

boolean

Ob die Google-Funktion „Infos zur Anzeige“ deaktiviert werden soll, die Ihren Anzeigen für verhaltensbezogene Onlinewerbung (Online Behavioral Advertising, OBA) und regulatorische Anforderungen Kennzeichen (zur Identifizierung des Inhalts als Anzeige) und Transparenzinformationen (bei Interaktion mit der Funktion „Infos zur Anzeige“) hinzufügt. Mit „Infos zur Anzeige“ haben Nutzer mehr Kontrolle darüber, welche Anzeigen sie sehen, und können erläutern, warum sie Ihre Anzeige sehen. Weitere Informationen

Wenn Sie dieses Feld auf true setzen, werden über Display- und Video 360 muss folgende Anforderungen erfüllen:

  • Sie muss gemäß Ihrem Vertrag mit der Google Marketing Platform OBA-konform (Online Behavioral Advertising) sein.
  • Im Europäischen Wirtschaftsraum (EWR) sollten Sie Informationen zur Transparenz und einen Mechanismus bereitstellen, mit dem Nutzer illegale Inhalte in Anzeigen melden können. Wenn Sie eine alternative Lösung zur Anzeigenkennzeichnung, Werbetransparenz und zur Berichterstellung verwenden, müssen Sie sicherstellen, dass diese die erforderlichen Informationen zur Transparenz enthält und illegale Inhalte meldet. Außerdem müssen Sie Google mithilfe des entsprechenden Formulars über Meldungen von illegalen Inhalten informieren.
dynamicCreativeEnabled

boolean

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

videoCreativeDataSharingAuthorized

boolean

Indem Sie dieses Feld auf true setzen, autorisieren Sie Google im Namen Ihres Unternehmens, Video-Creatives zu verwenden, die mit diesem Display- und Video 360-Werbetreibender, der Berichte und Funktionen zu seinen Fernsehkampagnen bereitstellt

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

AdvertiserDataAccessConfig

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

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

object (AdvertiserSdfConfig)

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

Wenn nicht angegeben, 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

Hiermit wird angegeben, ob dieser Werbetreibende die Konfiguration der strukturierten Datendateien des übergeordneten Partners überschreibt.

Standardmäßig übernimmt ein Werbetreibender die Konfiguration der strukturierten Datendateien 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 Konfiguration der strukturierten Datendateien für den Werbetreibenden.

AdvertiserTargetingConfig

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

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

boolean

Hiermit wird angegeben, ob internetfähige Geräte 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)

Die ID eines Abrechnungsprofils, das dem Werbetreibenden zugewiesen ist.

Methoden

audit

Prüft einen Werbetreibenden.

create

Erstellt einen neuen Werbetreibenden.

delete

Löscht einen Werbetreibenden.

editAssignedTargetingOptions

Bearbeitet die Targeting-Optionen für einen einzelnen Werbetreibenden.

get

Ruft einen Werbetreibenden ab.

list

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

listAssignedTargetingOptions

Listet zugewiesene Targeting-Optionen eines Werbetreibenden für alle Targeting-Typen auf.

patch

Aktualisiert einen vorhandenen Werbetreibenden.