形式の説明については、概要をご覧ください。
| フィールド | 必須 | タイプ | 書き込み可能 | 説明 | |||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| キャンペーン ID | 既存のキャンペーンを編集する場合にのみ必要 | integer | いいえ | キャンペーンの数値 ID 値。空白のままにすると、新しいキャンペーン ID が作成され、一意の ID が割り当てられます。必要に応じて、新しいキャンペーンを作成するときに、カスタム識別子を使用して、新しいキャンペーンに広告掲載オーダーを割り当てることができます。カスタム識別子の形式は、ext[カスタム識別子] です（例: ext123）。ファイルがアップロードされて処理されると、すべてのカスタム識別子は DBM によって割り当てられる ID に置き換えられ、オブジェクトはカスタム識別子に基づいて関連付けられます（広告申込情報とキャンペーンの関連付けなど）。 | |||||||||||||||||||||||||||||||||||||||||||||
| 広告主 ID | ○ | integer | いいえ | 広告主の数値 ID 値。有効な既存の広告主 ID である必要があります | |||||||||||||||||||||||||||||||||||||||||||||
| 名前 | ○ | 文字列 | ○ | エントリの名前。 | |||||||||||||||||||||||||||||||||||||||||||||
| タイムスタンプ | 既存のエントリを編集する場合に必要 | integer | いいえ | エントリのタイムスタンプ。これは、ダウンロードとアップロードの間にエントリが変更されていないことを確認するために、システムによって使用されます。 | |||||||||||||||||||||||||||||||||||||||||||||
| ステータス | ○ | 文字列 | ○ | エントリのステータス設定。
| |||||||||||||||||||||||||||||||||||||||||||||
| キャンペーンの目標 | ○ | 文字列 | ○ | 該当するキャンペーン目標を 1 つ選択します。
| |||||||||||||||||||||||||||||||||||||||||||||
| キャンペーン目標の KPI | ○ | 文字列 | ○ | 該当するキャンペーン目標の KPI を 1 つ選択します。
| |||||||||||||||||||||||||||||||||||||||||||||
| キャンペーン目標の KPI 値 | ○ | float | ○ | キャンペーン目標の KPI の正の数値。キャンペーン目標の主要指標である「視認可能率」と「クリック率」については、このフィールドの値をパーセンテージで入力します（80% の場合は「80」と入力します）。KPI が「その他」の場合、このフィールドは目標の簡単な説明です。 | |||||||||||||||||||||||||||||||||||||||||||||
| クリエイティブ タイプ | ○ | 文字列、リスト | ○ | 使用するクリエイティブ タイプのリスト。
| |||||||||||||||||||||||||||||||||||||||||||||
| キャンペーン予算 | いいえ | float | ○ | キャンペーンの正の予算額。常に金額の予算であるため、常に通貨金額の浮動小数点数です。通貨は、広告主の通貨で標準単位（通貨単位の 1/1,000,000 ではなく）で表示されます。 | |||||||||||||||||||||||||||||||||||||||||||||
| キャンペーン開始日 | ○ | 文字列 | ○ | キャンペーンの開始日（MM/DD/YYYY HH:mm 形式） | |||||||||||||||||||||||||||||||||||||||||||||
| キャンペーン終了日 | いいえ | 文字列 | ○ | キャンペーンの終了日（MM/DD/YYYY HH:mm 形式） | |||||||||||||||||||||||||||||||||||||||||||||
| フリークエンシーが有効 | ○ | 文字列 | ○ | キャンペーンでインプレッション ベースのフリークエンシー キャップを有効または無効にします。
| |||||||||||||||||||||||||||||||||||||||||||||
| フリークエンシー エクスポージャー | [Frequency Enabled] が [TRUE] の場合に必須 | integer | ○ | 指定したフリークエンシー額のインプレッション数を示す正の整数値（「y 期間に x 回表示」の x に相当）。 | |||||||||||||||||||||||||||||||||||||||||||||
| フリークエンシー期間 | [Frequency Enabled] が [TRUE] の場合に必須 | 文字列 | ○ | フリークエンシー キャップの期間の単位を指定します。
2025 年 2 月 28 日をもって、フリークエンシー キャップの期間が 30 日を超えるものは使用できなくなります。この列に「存続期間」を割り当てようとすると、エラーが返されます。 | |||||||||||||||||||||||||||||||||||||||||||||
| 頻度 | [Frequency Enabled] が [TRUE] の場合に必須 | integer | ○ | フリークエンシー期間の種類の期間の正の整数値（「y 期間に x 回のインプレッションを表示」の y）。 2025 年 2 月 28 日をもって、フリークエンシー キャップの期間が 30 日を超えるものは使用できなくなります。[頻度期間] 列に [月単位] が割り当てられているときに、この列に 2 以上の値を割り当てようとすると、エラーが返されます。 | |||||||||||||||||||||||||||||||||||||||||||||
| キャンペーンの予算セグメント | いいえ | 文字列、リストのリスト | ○ | キャンペーンの予算セグメントのセット。リストの形式 =（ID、名前、タイプ、金額、開始日、終了日、外部予算ソース、外部予算 ID、請求書グループ ID、Prisma クライアント コード、Prisma 商品コード、Prisma 見積もりコード、Prisma タイプ、サプライヤー）。
例:「(; マイ予算; インプレッション数; 234; 2020 年 1 月 1 日 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; クライアント; プロダクト; 見積もり; ディスプレイ; マイサプライヤー;)」ID と終了日は指定しません。
| |||||||||||||||||||||||||||||||||||||||||||||
| 年齢や性別によるターゲティング: 性別 | いいえ | 文字列、リスト | ○ | ターゲットに設定する性別のリスト。次のいずれかの値を選択します。
| |||||||||||||||||||||||||||||||||||||||||||||
| 年齢によるターゲティング | いいえ | 文字列、リスト | ○ | ユーザーの年齢層をターゲットに設定します。開始年齢と終了年齢を 1 つずつ選択し、不明な年齢を含めるかどうかを true または false で指定して、開始年齢から終了年齢までの範囲を指定します。使用できる [開始] と [終了] の年齢のリストをご覧ください。 例 1: 18 ～ 55 歳のユーザーをターゲットにし、不明な年齢のユーザーも含めるには、{開始; 終了; 不明な年齢を含める（true または false）} の形式で指定します = 18;55;true; 例 2: 35 歳以上のユーザーのみをターゲットにし、不明な年齢のユーザーを除外するには、次のように指定します = 35;+;false;。 [開始] に指定できる値:
To に指定できる値:
| |||||||||||||||||||||||||||||||||||||||||||||
| ユーザー層ターゲティングの世帯収入 | いいえ | 文字列、リスト | ○ | 世帯収入の範囲をターゲットに設定します。収入の範囲を指定する場合は、1 つの Top_of_Range 収入範囲と 1 つの Bottom_of_Range 収入範囲を選択し、収入が不明な世帯を含めるかどうかを true または false で指定します。使用できる Top_of_Range と Bottom_of_Range の範囲のリストをご覧ください。 例 1: 上位 10 ～ 50% の世帯をターゲットにし、収入が不明な世帯も含めるには、{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true という形式で指定します。 例 2: 下位 50% の世帯のみをターゲットにし、収入が不明な世帯は除外するには、{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true という形式で指定します。 Top_of_Range と Bottom_of_Range に使用できる値:
| |||||||||||||||||||||||||||||||||||||||||||||
| ユーザー層ターゲティング: 子供の有無 | ○ | 文字列、リスト | ○ | ターゲットに設定する子供の有無のリスト。使用可能な値を 1 つ以上選択します。
| |||||||||||||||||||||||||||||||||||||||||||||
| 地域ターゲティング - 含める | いいえ | 文字列、リスト | ○ | ターゲティングに含める地域のリスト。 この列では、ターゲティング タイプ リストの形式は（TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など）です。このリストは数値の昇順で生成されます。 | |||||||||||||||||||||||||||||||||||||||||||||
| 地域ターゲティング - 除外 | いいえ | 文字列、リスト | ○ | ターゲティングから除外する地域のリスト。 この列では、ターゲティング タイプ リストの形式は（TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など）です。このリストは数値の昇順で生成されます。 | |||||||||||||||||||||||||||||||||||||||||||||
| ターゲット言語 - 含める | いいえ | 文字列、リスト | ○ | ターゲティングに含める言語のリスト。 この列では、ターゲティング タイプ リストの形式は（TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など）です。このリストは数値の昇順で生成されます。 | |||||||||||||||||||||||||||||||||||||||||||||
| ターゲット言語 - 除外 | いいえ | 文字列、リスト | ○ | ターゲティングで除外する言語のリスト。 この列では、ターゲティング タイプ リストの形式は（TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など）です。このリストは数値の昇順で生成されます。 | |||||||||||||||||||||||||||||||||||||||||||||
| デジタル コンテンツ ラベル - 除外 | いいえ | 文字列、リスト | ○ | 除外するデジタル コンテンツ ラベルのリスト。リストの形式 =（G、PG など）。
| |||||||||||||||||||||||||||||||||||||||||||||
| ブランド保護の機密性設定 | いいえ | 文字列 | ○ | 周辺のコンテンツのカテゴリに基づいて広告枠をブロックする感度設定を選択します。
| |||||||||||||||||||||||||||||||||||||||||||||
| ブランド保護のカスタム設定 | [ブランド セーフティのカスタム設定] が [カスタムを使用する] の場合に必須 | 文字列、リスト | ○ | ブランド セーフティの機密性設定が [カスタムを使用する] の場合は、標準コンテンツ分類システムのリストを指定します。例: 性、アルコール、タバコなど。
| |||||||||||||||||||||||||||||||||||||||||||||
| 第三者認証サービス | いいえ | 文字列 | ○ | 第三者認証サービス プロバイダ。
| |||||||||||||||||||||||||||||||||||||||||||||
| 第三者確認ラベル | いいえ | 文字列、リスト | ○ | [サードパーティの確認サービス] が [なし] 以外の場合は、選択したプロバイダでサポートされているラベルのリストを指定します。 | |||||||||||||||||||||||||||||||||||||||||||||
| 視認性ターゲティング（アクティブ ビュー） | いいえ | 文字列 | ○ | 予測される視認性の割合を目標に設定します。パーセンテージは浮動小数点数で表されます。{0.1、0.2、0.3、0.4、0.5、0.6、0.7、0.8、0.9} のいずれか | |||||||||||||||||||||||||||||||||||||||||||||
| 位置ターゲティング - 画面上のディスプレイ | いいえ | 文字列、リスト | ○ | 画面上のディスプレイ広告の位置ターゲティング。次のいずれかの値を選択します。
| |||||||||||||||||||||||||||||||||||||||||||||
| 位置ターゲティング - 動画の画面上の位置 | いいえ | 文字列、リスト | ○ | 画面上の動画広告の掲載位置ターゲティング。次のいずれかの値を選択します。
| |||||||||||||||||||||||||||||||||||||||||||||
| 位置ターゲティング - コンテンツ内の表示位置 | いいえ | 文字列、リスト | ○ | ターゲットとするディスプレイ広告のコンテンツの位置。次のいずれかの値を選択します。
| |||||||||||||||||||||||||||||||||||||||||||||
| 位置ターゲティング - コンテンツ内の動画の位置 | いいえ | 文字列、リスト | ○ | ターゲットとする動画広告のコンテンツの位置。次のいずれかの値を選択します。
| |||||||||||||||||||||||||||||||||||||||||||||
| 広告枠ソース ターゲティング - 認定販売者のオプション | [タイプ] が「ディスプレイ」または「動画」または「オーディオ」の場合に必須 | 文字列 | ○ | 認定直接販売者、認定直接販売者と認定販売パートナー、認定販売者と不明をターゲットに設定する設定。「認定直接販売者」は、認定販売者のみターゲットにすることを意味します。「認定直接販売者と認定販売パートナー」は、認定販売者と認定販売パートナーをターゲットにすることを意味します。「認定販売者および未参加のパブリッシャー」は、認定販売者、販売パートナー、不明な販売者をターゲットに設定することを意味します。
| |||||||||||||||||||||||||||||||||||||||||||||
| 広告枠ソース ターゲティング - 含める | いいえ | 文字列、リスト | ○ | ターゲティングに含める広告枠ソース、エクスチェンジ、サブエクスチェンジのリスト。 この列には、ディスプレイ＆ビデオ 360 API の リストの形式 =（InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; など） | |||||||||||||||||||||||||||||||||||||||||||||
| 広告枠ソース ターゲティング - 除外 | いいえ | 文字列、リスト | ○ | ターゲティングで除外する広告枠ソース、エクスチェンジ、サブエクスチェンジのリスト。 この列には、ディスプレイ＆ビデオ 360 API の リストの形式 =（InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; など） | |||||||||||||||||||||||||||||||||||||||||||||
| 広告枠ソース ターゲティング - 新しいエクスチェンジをターゲットに設定する | いいえ | 文字列 | ○ | 新しいエクスチェンジをターゲットに設定する。
| |||||||||||||||||||||||||||||||||||||||||||||
| 環境ターゲティング | いいえ | 文字列、リスト | ○ | ターゲットとする環境のリスト。使用可能な値を 1 つ以上選択します。[ウェブ] を選択していない場合、[最適化されていないウェブ] は選択できません。
|