REST Resource: advertisers

{
  "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)
  }
}

string

出力専用。広告主のリソース名。

string (int64 format)

出力専用。広告主の一意の ID。システムによって割り当てられます。

string (int64 format)

必須。変更不可。広告主が属するパートナーの一意の ID。

string

必須。広告主の表示名。

UTF-8 でエンコードし、最大サイズは 240 バイトにする必要があります。

enum (EntityStatus)

必須。広告主様の広告掲載オーダーと広告申込情報で予算を消化したり、広告枠に入札したりできるかどうかを制御します。

• 指定できる値は ENTITY_STATUS_ACTIVE、ENTITY_STATUS_PAUSED、ENTITY_STATUS_SCHEDULED_FOR_DELETION です。
• ENTITY_STATUS_SCHEDULED_FOR_DELETION に設定すると、広告主は削除が最初にスケジュールされた日から 30 日後に削除されます。

string (Timestamp format)

出力専用。広告主が最後に更新されたときのタイムスタンプ。システムによって割り当てられます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

object (AdvertiserGeneralConfig)

必須。広告主の全般設定。

object (AdvertiserAdServerConfig)

必須。変更不可。広告主の広告サーバー関連の設定。

object (AdvertiserCreativeConfig)

必須。広告主のクリエイティブ関連の設定。

object (AdvertiserDataAccessConfig)

広告主データへのアクセス方法を管理する設定。

object (IntegrationDetails)

広告主様の統合の詳細。現在、広告主に適用できるのは integrationCode のみです。IntegrationDetails の他のフィールドはサポートされていないため、指定した場合は無視されます。

object (AdvertiserTargetingConfig)

広告主の広告配信に関連するターゲティング設定。

boolean

Mediaocean（Prisma）との統合が有効かどうか。この機能を有効にすると、以下に同意したことになります。

私は会社を代表して、Mediaocean（Prisma）が予算セグメント プランを Google に送信すること、および Google が、この広告主の予算プラン、支払いと請求、調整のために対応するレポートと請求書をディスプレイ＆ビデオ 360 から Mediaocean に送信することを許可します。

object (AdvertiserBillingConfig)

必須。広告主の請求関連の設定。

{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}

string

必須。広告主様のメインのウェブサイトのドメイン URL。キャンペーンを広告主に関連付けるためにウェブサイト URL を必要とするパブリッシャーには、この情報が送信されます。

http: または https: で始まる URL には、パスやクエリ文字列を含めないでください。例: http://www.example.com

string

出力専用。広告主のタイムゾーンの標準 TZ データベース名。たとえば、America/New_York です。

詳細については、https://en.wikipedia.org/wiki/List_of_tz_database_time_zones をご覧ください。

キャンペーン マネージャー 360 ハイブリッド広告主の場合、タイムゾーンは関連付けられているキャンペーン マネージャー 360 アカウントのタイムゾーンと同じです。サードパーティのみを使用する広告主の場合、タイムゾーンは親パートナーのタイムゾーンと同じです。

string

必須。変更不可。広告主様の通貨（ISO 4217 形式）。

使用できるコードと、それに対応する通貨は次のとおりです。

通貨コード: 通貨名

• ARS : アルゼンチンペソ
• AUD : オーストラリア ドル
• BRL : ブラジル レアル
• CAD : カナダドル
• CHF : スイス フラン
• CLP : チリ ペソ
• CNY : 中国人民元
• COP : コロンビアペソ
• CZK : チェコ コルナ
• DKK : デンマーク クローネ
• EGP : エジプト ポンド
• EUR : ユーロ
• GBP : イギリスポンド
• HKD : 香港ドル
• HUF : フォリント（ハンガリー）
• IDR : インドネシア ルピア
• ILS : イスラエル シェケル
• INR : インドルピー
• JPY: 日本円
• KRW : 韓国ウォン
• MXN : メキシコ ペソ
• MYR : マレーシア リンギット
• NGN : ナイジェリア ナイラ
• NOK : ノルウェー クローネ
• NZD : ニュージーランド ドル
• PEN : ペルー ヌエボソル
• PLN : ポーランド ズウォティ
• RON : 新ルーマニア レウ
• RUB : ロシアルーブル
• SEK : スウェーデン クローナ
• TRY : トルコ リラ
• TWD : ニュー台湾ドル
• USD : 米ドル
• ZAR : 南アフリカ ランド

{

  // 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.
}

object (ThirdPartyOnlyConfig)

第三者広告サーバーのみを使用している広告主向けの設定。

object (CmHybridConfig)

キャンペーン マネージャー 360（CM360）と第三者広告サーバーの両方を使用する広告主向けの設定です。

{
  "pixelOrderIdReportingEnabled": boolean
}

boolean

ピクセルのオーダー ID レポートが有効かどうか。この値は、true に設定すると変更できません。

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

string (int64 format)

必須。変更不可。ディスプレイ&ビデオ 360 広告主にリンクされている CM360 Floodlight 設定のアカウント ID。

string (int64 format)

必須。変更不可。ディスプレイ&ビデオ 360 広告主にリンクされている CM360 Floodlight 設定の ID。

string (int64 format)

出力専用。キャンペーン マネージャー 360 の Floodlight 設定を共有する CM360 広告主 ID のセット。

string (int64 format)

プレースメントがクリエイティブとしてディスプレイ＆ビデオ 360 に同期される CM360 サイトのリスト。

advertisers.create メソッドに存在しない場合や空の場合は、CM360 サイトが自動的に作成されます。

このリストからサイトを削除すると、キャンペーン マネージャー 360 からディスプレイ＆ビデオ 360 に同期されたクリエイティブが削除される可能性があります。少なくとも 1 つのサイトを指定する必要があります。

boolean

キャンペーン マネージャー 360 のデータ転送レポートにディスプレイ＆ビデオ 360 のデータを追加するかどうか。

boolean

ディスプレイ＆ビデオ 360 の費用をキャンペーン マネージャー 360 に報告するかどうか。

boolean

必須。変更不可。このフィールドを true に設定すると、指定した Floodlight 設定からこのディスプレイ＆ビデオ 360 広告主への情報の共有を、会社を代表して承認します。

{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}

string (int64 format)

Integral Ad Service（IAS）が提供するキャンペーン モニタリングの設定用 ID。ディスプレイ＆ビデオ 360 のシステムは、この ID を含む IAS の「キャンペーン モニター」タグをクリエイティブ タグに追加します。

boolean

オンライン行動ターゲティング広告（OBA）と規制要件に基づき、Google の「この広告について」機能を無効にするかどうか。この機能は、コンテンツを広告として示すバッジと、透明性に関する情報（「この広告について」で操作）を広告に追加します。[この広告について] を使用すると、ユーザーは表示される広告をより細かく管理できます。また、広告主は広告が表示された理由を説明できます。詳細

このフィールドを true に設定する場合は、ディスプレイ＆ビデオ 360 で配信される広告は次の要件を満たす必要があります。

• Google マーケティング プラットフォームとの契約に定めるとおり、オンライン行動ターゲティング広告（OBA）に準拠している。
• 欧州経済領域（EEA）では、透明性に関する情報と、ユーザーが違法なコンテンツを報告するメカニズムを広告に含める必要があります。広告のバッジ、透明性、レポートの代替ソリューションを使用している場合は、必要な透明性情報と違法なコンテンツの報告メカニズムが含まれていることを確認してください。また、違法なコンテンツの報告があった場合は、適切なフォームを使用して Google に通知する必要があります。

boolean

広告主がダイナミック クリエイティブに対して有効になっているかどうか。

boolean

このフィールドを true に設定すると、会社を代表して、このディスプレイ&ビデオ 360 広告主に関連付けられた動画クリエイティブを使用して、広告主のテレビ キャンペーンに関連するレポートと機能を提供する権限を Google に許可したことになります。

広告主が CM360 hybrid 広告サーバー設定を使用している場合にのみ適用されます。

{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}

object (AdvertiserSdfConfig)

広告主の構造化データファイル（SDF）の設定。

指定しない場合、親パートナーの SDF 設定が使用されます。

{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}

boolean

この広告主が親パートナーの SDF 設定をオーバーライドするかどうか。

デフォルトでは、広告主は親パートナーから SDF の設定を継承します。パートナーの構成をオーバーライドするには、このフィールドを true に設定し、sdfConfig に新しい構成を指定します。

object (SdfConfig)

広告主の SDF 設定。

• overridePartnerSdfConfig が true の場合は必須です。
• overridePartnerSdfConfig が false の場合にのみ出力します。

{
  "exemptTvFromViewabilityTargeting": boolean
}

boolean

広告主のすべての動画広告申込情報について、インターネット テレビ デバイスを視認性ターゲティングの適用対象外とするかどうか。

{
  "billingProfileId": string
}

string (int64 format)

必須。広告主に割り当てられた請求プロファイルの ID。