構造化データ - v4.2 - キャンペーン

この SDF バージョンは廃止されました。構造化データファイルを引き続き使用するには、SDF v10 を使用してください。このドキュメントは、以前に生成されたファイルを参照する場合にのみ使用してください。

形式の説明については、概要をご覧ください。

フィールド	必須	タイプ	書き込み可能	説明
キャンペーン ID	既存のキャンペーンを編集する場合にのみ必要	integer	いいえ	キャンペーンの数値 ID 値。空白のままにすると、新しいキャンペーン ID が作成され、一意の ID が割り当てられます。 オプションとして、新しいキャンペーンを作成する際に、カスタム識別子を使用して新しいキャンペーンに広告掲載オーダーを割り当てることができます。 カスタム識別子の形式は、ext[カスタム識別子] です（例: ext123）。 ファイルがアップロードされて処理されると、すべてのカスタム識別子は DBM によって割り当てられる ID に置き換えられ、オブジェクトはカスタム識別子に基づいて関連付けられます（例: 広告掲載オーダーとキャンペーン）。
広告主 ID	はい	integer	いいえ	広告主の数値 ID 値。有効な既存の広告主 ID である必要があります。
名前	はい	文字列	はい	エントリの名前。
タイムスタンプ	既存のエントリを編集する場合に必要	integer	いいえ	エントリのタイムスタンプ。これは、ダウンロードとアップロードの間にエントリが変更されていないことを確認するために、システムによって使用されます。
ステータス	はい	文字列	はい	エントリのステータス設定。 有効 一時停止 アーカイブ済み 削除済み
キャンペーンの目標	はい	文字列	はい	該当するキャンペーン目標を 1 つ選択します。 ブランドや商品の認知度を高める オンラインのユーザー行動やアクセス数を伸ばす オフラインや店舗での販売を促進する アプリのインストールやエンゲージメントを増やす
キャンペーン目標の KPI	はい	文字列	はい	該当するキャンペーン目標の KPI を 1 つ選択します。 CPM 視認範囲の割合 CPIAVC CPA クリック単価 クリック率 その他
キャンペーン目標の KPI の値	はい	float	はい	キャンペーン目標の KPI の正の数。キャンペーン目標の KPI が「視認範囲の割合」と「クリック率」の場合は、このフィールドに値をパーセンテージで入力します（例: 80% の場合は「80」と入力します）。KPI が「その他」の場合は、このフィールドに目標の簡単な説明を入力します。
クリエイティブ タイプ	はい	文字列、リスト	はい	使用するクリエイティブ タイプのリスト。 ディスプレイ 動画 音声
キャンペーン予算	いいえ	float	はい	キャンペーンの予算額（正の数）。常に金額の予算となるため、通貨額は常に float になります。通貨は、広告主の通貨で標準単位で表示されます（通貨単位の 1/1,000,000 ではありません）。
キャンペーン開始日	はい	文字列	はい	キャンペーンの開始日（MM/DD/YYYY HH:mm 形式）
キャンペーン終了日	いいえ	文字列	はい	キャンペーンの終了日（MM/DD/YYYY HH:mm 形式）
フリークエンシーが有効	はい	文字列	はい	キャンペーンでインプレッション ベースのフリークエンシー キャップを有効または無効にします。 TRUE FALSE
フリークエンシーの表示回数	[フリークエンシーが有効] が [TRUE] の場合に必要	integer	はい	指定されたフリークエンシー期間内のインプレッション数の正の整数値（「y 期間に x 回インプレッションを表示する」の x）。
フリークエンシー期間	[フリークエンシーが有効] が [TRUE] の場合に必要	文字列	はい	フリークエンシー キャップの期間単位を指定します。 分 時間 数日間 数週間 月 全期間
フリークエンシー期間の長さ	[フリークエンシーが有効] が [TRUE] の場合に必要	integer	はい	フリークエンシー期間の長さの正の整数値（「y 期間に x 回インプレッションを表示する」の y）。
年齢や性別によるターゲティング - 性別	いいえ	文字列、リスト	はい	ターゲットにする性別のリスト。次のいずれかの値を選択します。 女性 男性 不明
年齢や性別によるターゲティング - 年齢	いいえ	文字列、リスト	はい	ユーザーの年齢層をターゲットにします。開始年齢と終了年齢を 1 つずつ選択し、不明な年齢を含めるかどうかを指定して、範囲を指定します。指定できる開始年齢と終了年齢のリストをご覧ください。 例 1: 18 ～ 55 歳をターゲットにし、不明な年齢を含める場合は、{開始; 終了; 不明を含める True / False} = 18;55;true; の形式で指定します。 例 2: 35 歳以上のユーザーのみをターゲットにし、不明な年齢を除外する場合は、35;+;false; と指定します。 開始年齢に指定できる値: 18 25 35 45 55 65 終了年齢に指定できる値: 25 35 45 55 65 +
年齢や性別によるターゲティング - 世帯収入	いいえ	文字列、リスト	はい	世帯収入の範囲をターゲットにします。範囲の上限と下限を 1 つずつ選択し、不明な収入の世帯を含めるかどうかを指定して、収入の範囲を指定します。指定できる範囲の上限と下限のリストをご覧ください。 例 1: 世帯の上位 10% ～ 50% をターゲットにし、不明な収入の世帯を含める場合は、{範囲の上限; 範囲の下限; 不明を含める True / False} = Top 10%;41-50%;true; の形式で指定します。 例 2: 世帯の下位 50% のみをターゲットにし、不明な収入の世帯を除外する場合は、{範囲の上限; 範囲の下限; 不明を含める True / False} = Lower 50%;Lower 50%;true; の形式で指定します。 範囲の上限と下限に指定できる値: 上位 10% 11 ～ 20% 21 ～ 30% 31 ～ 40% 41 ～ 50% 下位 50%
年齢や性別によるターゲティング - 子供の有無	はい	文字列、リスト	はい	ターゲットにする子供の有無のリスト。 次のいずれかの値を選択します。 親 子供なし 不明
地域ターゲティング - 含める	いいえ	文字列、リスト	はい	ターゲティングに含める地域のリスト。リスト形式 = (GeoLocation.id; GeoLocation.id; など)。
地域ターゲティング - 除外する	いいえ	文字列、リスト	はい	ターゲティングから除外する地域のリスト。リスト形式 = (GeoLocation.id;GeoLocation.id; など)。
ターゲット言語 - 含める	いいえ	文字列、リスト	はい	ターゲティングに含める言語のリスト。リスト形式 = (Language.id;Language.id; など)。
ターゲット言語 - 除外する	いいえ	文字列、リスト	はい	ターゲティングから除外する言語のリスト。リスト形式 = (Language.id;Language.id; など)。
デジタル コンテンツ ラベル - 除外する	いいえ	文字列、リスト	はい	除外するデジタル コンテンツ ラベルのリスト。リスト形式 = (G;PG; など)。 G PG T MA ?
ブランド保護の感度設定	いいえ	文字列	はい	周辺のコンテンツのカテゴリに基づいて広告枠をブロックする感度設定を選択します。 ブロックしない キャンペーン マネージャーのベリフィケーションを使用する カスタムを使用
ブランド保護のカスタム設定	[ブランド保護のカスタム設定] が [カスタムを使用] の場合に必要	文字列、リスト	はい	ブランド保護の感度設定が [カスタムを使用] の場合は、標準コンテンツ分類子のリストを指定します。例: (Adult;Alcohol;Tobacco; など)。 アダルト 中傷 ダウンロード、共有 武器および兵器 ギャンブル 暴力 性的内容を示唆 冒とく アルコール 薬物 タバコ 政治 宗教 惨事 交通事故 デリケートな社会問題 衝撃的
第三者認証サービス	いいえ	文字列	はい	第三者認証サービスのプロバイダ。 なし Integral Ad Science DoubleVerify Adloox
第三者認証ラベル	いいえ	文字列、リスト	はい	第三者認証サービスが [なし] 以外の場合は、選択したプロバイダでサポートされている ラベル のリストを指定します。
視認性ターゲティング - アクティブ ビュー	いいえ	文字列	はい	予測視認性の割合をターゲットにします。割合は float で表されます。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} のいずれか
視認性ターゲティング - 広告掲載順位 - 含める	いいえ	文字列	はい	広告掲載順位をターゲットにします。次のいずれかの値を選択します。 すべて ATF BTF 不明
視認性ターゲティング - 広告掲載順位 - 除外する	いいえ	文字列	はい	ターゲティングから広告掲載順位を除外します。次のいずれかの値を選択します。 ATF BTF 不明
広告在庫ソース ターゲティング - 認定販売者のみ	[タイプ] が [ディスプレイ]、[動画]、[音声] のいずれかである場合に必要	文字列	はい	認定販売者のみ、認定販売者と販売パートナー、認定販売者と不明をターゲットにする設定。[認定直接販売者] は、認定販売者のみがターゲットになることを意味します。[TRUE] は、認定販売者と販売パートナーをターゲットにすることを意味します。[FALSE] は、認定販売者、販売パートナー、不明な販売者をターゲットにすることを意味します。 TRUE FALSE 認定直接販売者
広告在庫ソース ターゲティング - 含める	いいえ	文字列、リスト	はい	ターゲティングに含める広告枠のリスト。リスト形式 = (InventorySource.id; InventorySource.id;)。
広告在庫ソース ターゲティング - 除外する	いいえ	文字列、リスト	はい	ターゲティングから除外する広告枠のリスト。リスト形式 = (InventorySource.id; InventorySource.id;)。
広告在庫ソース ターゲティング - 新しいエクスチェンジをターゲットにする	いいえ	文字列	はい	新しいエクスチェンジをターゲットにする設定。 正しい False
環境ターゲティング	[タイプ] が [ディスプレイ]、[動画]、[音声] のいずれかである場合に必要	文字列、リスト	はい	ターゲットにする環境のリスト。リスト形式 = (デスクトップ ウェブ; モバイルアプリ; など)。 ディスプレイ環境の場合: デスクトップ ウェブ モバイル ウェブ モバイルアプリ モバイルアプリ インタースティシャル モバイル向けデスクトップ ウェブ 動画の場合: デスクトップ ウェブ動画 デスクトップ ウェブゲーム デスクトップ ウェブ - 記事内 デスクトップ ウェブ - フィード内 モバイル ウェブ動画 モバイルアプリ動画 モバイルアプリ動画インタースティシャル 音声の場合: デスクトップ ウェブ音声 モバイル Web Audio モバイルアプリ音声