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
}
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, dem der Werbetreibende angehö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, zu dem der Werbetreibende zuletzt aktualisiert wurde. 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 für den Zugriff auf Daten von Werbetreibenden
integrationDetails

object (IntegrationDetails)

Integrationsdetails des Werbetreibenden. Derzeit gilt nur integrationCode für den Werbetreibenden. 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 ermächtige ich Google, entsprechende Berichte und Rechnungen von DV360 an Mediaocean zu senden, um Budgetplanung, Abrechnung und Abgleich für diesen Werbetreibenden durchzuführen.

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 die 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 Standardname der TZ-Datenbank in der Zeitzone des Werbetreibenden. Beispiel: America/New_York.

Mehr dazu: 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, ist die Zeitzone mit der des übergeordneten Partners identisch.
currencyCode

string

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

Zulässige Codes und die Währungen, die sie darstellen:

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 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 für Werbetreibende, die Ad-Server von Drittanbietern verwenden.

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

boolean

Gibt an, ob Berichte zu Auftrags-IDs für Pixel aktiviert werden. 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,
  "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
cmSyncableSiteIds[]

string (int64 format)

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

Ist das Feld in der advertisers.create-Methode nicht vorhanden oder leer, erstellt das System automatisch eine CM360-Website.

Wenn Sie Websites aus dieser Liste entfernen, werden möglicherweise mit CM360 synchronisierte 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 die DV360-Kosten an CM360 gemeldet werden sollen.
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 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 von Integral Ad Service (IAS) bereitgestellte ID zum Konfigurieren der Kampagnenüberwachung. Im DV360-System wird das IAS-Tag „Campaign Monitor“ mit dieser ID an das Creative-Tag angehängt.
obaComplianceDisabled

boolean

Gibt an, ob die OBA-Konformität (Online Behavioral Advertising) von DV360 verwendet wird.

Warnung: Wenn Sie die OBA-Einstellungen ändern, wird der Audit-Status Ihrer Creatives möglicherweise von einigen Anzeigenplattformen zurückgesetzt. Sie können dann erst wieder ausgeliefert werden, wenn sie wieder freigegeben wurden.
dynamicCreativeEnabled

boolean

Gibt an, ob dynamische Creatives für den Werbetreibenden aktiviert sind.
videoCreativeDataSharingAuthorized

boolean

Indem 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 für den Zugriff auf werbetreibendenbezogene Daten.

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, 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, die sich auf die Anzeigenbereitstellung eines Werbetreibenden beziehen.

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

boolean

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

Methoden

audit

 Überprüft einen Werbetreibenden.

bulkEditAdvertiserAssignedTargetingOptions

 Targeting-Optionen für einen einzelnen Werbetreibenden im Bulk bearbeiten

bulkListAdvertiserAssignedTargetingOptions

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

create

 Erstellt einen neuen Werbetreibenden.

delete

 Löscht einen Werbetreibenden.

get

 Ruft einen Werbetreibenden ab.

list

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

patch

 Aktualisiert einen vorhandenen Werbetreibenden.