構造化データ - v8 - キャンペーン

この SDF バージョンはベータ版です。一部のユーザーのみが利用できます。ベータ版のバージョンには、予告なく変更が行われる場合があります。

SDF バージョン 8 では、ベータ版のデマンド ジェネレーション リソースがサポートされています。デマンド ジェネレーション広告申込情報、広告グループ、広告は、ベータ版に登録したユーザーのみが利用できます。

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

フィールド	必須	タイプ	書き込み可能	説明
キャンペーン ID	既存のキャンペーンを編集する場合にのみ必須	integer	いいえ	キャンペーンの数値 ID 値。空白のままにすると、新しいキャンペーン ID が作成されて一意の ID が割り当てられます。必要に応じて、新しいキャンペーンを作成するときに、広告掲載オーダーを新しいキャンペーンに割り当てる目的でカスタム ID を使用できます。カスタム識別子の形式は「ext[カスタム識別子]」です（例: ext123）。ファイルのアップロードと処理が行われると、すべてのカスタム識別子が DBM によって割り当てられた ID に置き換えられ、そのカスタム識別子に基づいてオブジェクトが関連付けられます（広告掲載オーダーからキャンペーンへなど）。
広告主 ID	○	integer	いいえ	広告主の数値 ID 値。既存の有効な広告主 ID を指定してください
名前	○	文字列	○	エントリの名前。
タイムスタンプ	既存のエントリを編集する場合は必須	integer	いいえ	エントリのタイムスタンプ。ダウンロードとアップロードの間にエントリが変更されていないことを確認するために使用されます。
ステータス	○	文字列	○	エントリのステータス設定。 有効 一時停止 アーカイブ済み
キャンペーンの目標	○	文字列	○	該当するキャンペーン目標を 1 つ選択してください。 ブランドや商品の認知度を高める オンラインのユーザー行動やアクセス数を伸ばす オフラインや店舗での販売を促進する アプリのインストールやエンゲージメントを増やす
キャンペーン目標の KPI	○	文字列	○	該当するキャンペーン目標 KPI を 1 つ選択してください。 CPM 視認可能な割合 CPIAVC CPA CPC クリック率 その他
キャンペーン目標の KPI 値	○	float	○	キャンペーン目標の KPI の正の数値。キャンペーンの目標 KPI が「視認可能率」の場合「クリック率」このフィールドの値をパーセンテージで入力します（例:80% は「80」と入力されます。KPI が「その他」の場合、このフィールドは目標の簡単な説明です。
クリエイティブ タイプ	○	文字列、リスト	○	使用する予定のクリエイティブ タイプのリスト。 ディスプレイ 動画 音声
キャンペーン予算	いいえ	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）を示す正の整数。
キャンペーン予算セグメント	いいえ	文字列、リストのリスト	○	キャンペーンの予算セグメントのセット。リスト形式 =（ID、名前、タイプ、金額、開始日、終了日、外部予算ソース、外部予算 ID、請求書グループ ID、Prisma クライアント コード、Prisma プロダクト コード、Prisma 見積もりコード、Prisma タイプ、サプライヤー）。 例: '(; 予算; インプレッション数; 234; 2020/01/01 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; クライアント; プロダクト; 見積もり; ディスプレイ; サプライヤー;)'（ID と終了日は指定しない）。 使用可能な値は次の表に示します。 列名 必須 説明 ID いいえ キャンペーン予算セグメントの一意の ID。これは、予算セグメントを編集するときに指定する必要があります。空白のままにすると、予算セグメントは新規として書き込まれます。 名前 ○ キャンペーンの予算セグメントの表示名。 タイプ ○ 予算額のタイプ。指定できる値は次のとおりです。 金額 表示回数 金額 ○ 予算タイプの正の予算額。単純な整数のインプレッション値や、金額を示す浮動小数点数などです。通貨は、広告主の通貨によって標準単位で表示されます（通貨単位の 1/1,000,000 ではありません）。 開始日 いいえ 予算セグメントの掲載期間開始日のタイムスタンプ（MM/DD/YYYY HH:mm 形式）。開始日が設定されていない場合は、空白のフィールド値で表されます。 終了日 いいえ 予算セグメントの掲載期間の終了日のタイムスタンプ（MM/DD/YYYY HH:mm 形式）。終了日が設定されていない場合は、空白のフィールド値で表されます。 外部予算ソース ○ 予算セグメントの参照元。指定できる値は次のとおりです。 なし Mediaocean 外部予算 ID Mediaocean の予算セグメントのみ 設定すると、顧客が予算セグメント単位の請求を有効にしている場合、この予算セグメントに対して配信されるすべてのインプレッションに、この ID が請求書に記載されます。 請求書グループ化 ID いいえ 設定すると、お客様が予算セグメント単位の請求を有効にしている場合、同じ外部予算 ID と請求書グループ ID を持つすべての予算セグメントが 1 つの請求書に集約されます。 Prisma クライアント コード Mediaocean の予算セグメントのみ Mediaocean の予算セグメントに対してのみ設定できます。Google お支払いセンターでは、このフィールドの検索とフィルタがサポートされています。 Prisma 商品コード Mediaocean の予算セグメントのみ Mediaocean の予算セグメントに対してのみ設定できます。Google お支払いセンターでは、このフィールドの検索とフィルタがサポートされています。 Prisma 見積もりコード Mediaocean の予算セグメントのみ Mediaocean の予算セグメントに対してのみ設定できます。Google お支払いセンターでは、このフィールドの検索とフィルタがサポートされています。 プリズム Mediaocean の予算セグメントのみ Mediaocean の予算セグメントに対してのみ設定できます。セグメントの Prisma タイプ。指定できる値は次のとおりです。 ディスプレイ 検索 動画 音声 ソーシャル 手数料 Prisma サプライヤー Mediaocean の予算セグメントのみ Mediaocean の予算セグメントに対してのみ設定できます。この予算に割り当てられた主体（DSP、サイトなど）
年齢や性別によるターゲティングの性別	いいえ	文字列、リスト	○	ターゲットとする性別のリストです。指定できる値を 1 つ以上選択します。 女性 男性 不明
年齢や性別によるターゲティング	いいえ	文字列、リスト	○	ユーザーの年齢層をターゲットに設定する。1 つの From 年齢と 1 つの To 年齢を選択し、不明な年齢の true / false を含めるかどうかを選択して、開始と終了の範囲を指定します。使用できる「開始年齢」と「終了年齢」のリストをご覧ください。 例 1: 18～55 歳のユーザーをターゲットにし、不明な年齢のユーザーも含めるには、{開始年齢; 終了年齢; 不明な年齢を含める（true または false）} の形式で指定します = 18;55;true; 例 2: 35 歳以上のユーザーのみをターゲットにし、不明な年齢のユーザーを除外するには、次のように指定します = 35;+;false;。 「開始年齢」に指定できる値: 18 25 35 45 55 65 To に指定できる値: 25 35 45 55 65 +
年齢や性別によるターゲティングでの世帯収入	いいえ	文字列、リスト	○	世帯収入の範囲をターゲットに設定する。Top_of_Range の収入の範囲と Bottom_of_Range の収入の範囲を 1 つ選択し、収入が不明の世帯を含めるかどうかを true または false に指定します。指定できる Top_of_Range/Bottom_of_Range 範囲のリストをご確認ください。 例 1: 世帯の上位 10% ～ 50% をターゲットに設定し、所得が不明な世帯を含めるには、{Top_of_Range;Bottom_of_Range;[不明な True/False] を含める} = 上位 10%;41 ～ 50%;true; 例 2: 世帯の下位 50% のみをターゲットに設定し、所得が不明な世帯を除外するには、{Top_of_Range;Bottom_of_Range;不明な True / False を含める} = 下限 50%;下限 50%;true; Top_of_Range または Bottom_of_Range に指定できる値: 上位 10% 11～20% 21～30% 31～40% 41～50% 下位 50%
年齢や性別によるターゲティングの子供の有無	○	文字列、リスト	○	ターゲットに設定する子供の有無のリストです。使用できる値を 1 つ以上選択します。 親 子供なし 不明
地域ターゲティング - 含める	いいえ	文字列、リスト	○	ターゲティングに含める地域のリスト。 この列にはディスプレイとVideo 360 API の TargetingOption リソース ID（ターゲティング タイプ TARGETING_TYPE_GEO_REGION 向け）。 リスト形式 =（TargetingOption.targetingOptionId、TargetingOption.targetingOptionId など）。このリストは、昇順で生成されます。
地域ターゲティング - 除外	いいえ	文字列、リスト	○	ターゲティングで除外する地域のリストです。 この列にはディスプレイとVideo 360 API の TargetingOption リソース ID（ターゲティング タイプ TARGETING_TYPE_GEO_REGION 向け）。 リスト形式 =（TargetingOption.targetingOptionId、TargetingOption.targetingOptionId など）。このリストは、昇順で生成されます。
ターゲット言語 - 含める	いいえ	文字列、リスト	○	ターゲティングに含める言語のリストです。 この列では、ターゲティング タイプ TARGETING_TYPE_LANGUAGE にディスプレイ＆ビデオ 360 API の TargetingOption リソース ID を使用します。 リストの形式は（TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など）です。このリストは数値の昇順で生成されます。
ターゲット言語 - 除外する	いいえ	文字列、リスト	○	ターゲティングで除外する言語のリストです。 この列にはディスプレイとVideo 360 API の TargetingOption リソース ID（ターゲティング タイプ TARGETING_TYPE_LANGUAGE 向け）。 リスト形式 =（TargetingOption.targetingOptionId、TargetingOption.targetingOptionId など）。このリストは、昇順で生成されます。
デジタル コンテンツ ラベル - 除外	いいえ	文字列、リスト	○	除外するデジタル コンテンツ ラベルのリスト。リストの形式 =（G、PG など）。 G PG T MA ?
ブランド保護の機密性設定	いいえ	文字列	○	感度の設定を選択して、周囲のコンテンツのテーマに基づいて広告枠をブロックします。 ブロックしない キャンペーン マネージャー 360 のベリフィケーションを使用する カスタムを使用する
ブランド保護のカスタム設定	[ブランド セーフティのカスタム設定] が [カスタムを使用する] の場合に必須	文字列、リスト	○	ブランド セーフティの機密性設定が [カスタムを使用する] の場合は、標準コンテンツ分類システムのリストを指定します。例: （性的、アルコール、タバコなど）。 性的 中傷 ダウンロードと共有 武器および兵器 ギャンブル 暴力 性的内容を示唆 冒とく アルコール 薬物 タバコ 政治 宗教 惨事 交通事故 デリケートな社会問題 衝撃的
第三者のベリフィケーション サービス	いいえ	文字列	○	第三者のベリフィケーション サービスのプロバイダ。 なし Integral Ad Science DoubleVerify Adloox
サードパーティの認証ラベル	いいえ	文字列、リスト	○	[サードパーティの認証サービス] が [なし] 以外の場合は、選択したプロバイダでサポートされているラベルのリストを指定します。
視認性ターゲティングのアクティブ ビュー	いいえ	文字列	○	予測される視認性の割合を目標値とします。パーセンテージは浮動小数点数で表されます。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} のいずれか
位置ターゲティング - 画面上のディスプレイ	いいえ	文字列、リスト	○	画面上のディスプレイ広告の位置ターゲティング。指定できる値を 1 つ以上選択します。 スクロールせずに見える範囲 スクロールしなければ見えない範囲 不明
位置ターゲティング - 画面上の動画	いいえ	文字列、リスト	○	画面上動画広告の位置ターゲティングです。指定できる値を 1 つ以上選択します。 スクロールせずに見える範囲 スクロールしなければ見えない範囲 不明
位置ターゲティング - コンテンツ内の位置を表示する	いいえ	文字列、リスト	○	ターゲットとするディスプレイ広告コンテンツの位置。指定できる値を 1 つ以上選択します。 記事内 インフィード インバナー インタースティシャル 不明
位置ターゲティング - コンテンツ内の動画位置	いいえ	文字列、リスト	○	ターゲットとする動画広告コンテンツの位置です。次のいずれかの値を選択します。 記事内 インフィード インバナー インタースティシャル 不明なアウトストリーム プレロールで取り込む ミッドロール ポストロール 不明なインストリーム
広告枠ソース ターゲティング - 認定販売者オプション	[Type] の場合は必須「ディスプレイ」または「動画」または [音声]	文字列	○	認定直接販売者、認定直接販売者と認定販売パートナー、認定販売者と不明をターゲットに設定する設定。「承認済みダイレクト」認定販売者のみが対象になります「認定直接販売者と認定販売パートナー」は、認定販売者と認定販売パートナーをターゲットにすることを意味します。「認定されたニュース メディアおよび未参加のニュース メディア」正規販売者、販売代理店、不明な販売者が対象となります。 認定直接販売者 認定直接販売者と認定販売パートナー 認定パブリッシャー様と未参加パブリッシャー
広告枠ソース ターゲティング - 含める	いいえ	文字列、リスト	○	ターゲティングに含める広告枠ソース、エクスチェンジ、サブエクスチェンジのリストです。 この列には、ディスプレイ＆ビデオ 360 API の InventorySource リソース ID、公開済みエクスチェンジ ID、ターゲティング タイプ TARGETING_TYPE_SUB_EXCHANGE のディスプレイ＆ビデオ 360 API TargetingOption リソース ID が使用されます。 リストの形式 =（InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; など）
広告枠ソース ターゲティング - 除外	いいえ	文字列、リスト	○	ターゲティングで除外する広告枠ソース、エクスチェンジ、サブエクスチェンジのリスト。 この列にはディスプレイとVideo 360 API の InventorySource リソース ID、公開エクスチェンジ ID、ディスプレイ &ビデオ 360Video 360 API TargetingOption（ターゲティング タイプ TARGETING_TYPE_SUB_EXCHANGE のリソース ID）。 リスト形式 = (InventorySource.inventorySourceId; ExchangeId; TargetOption.targetingOptionId; など)
広告枠ソース ターゲティング - 新しいエクスチェンジをターゲティングする	いいえ	文字列	○	新しいエクスチェンジをターゲットに設定します。 正しい False
環境ターゲティング	いいえ	文字列、リスト	○	ターゲットとする環境のリスト。使用可能な値を 1 つ以上選択します。「ウェブが最適化されていません」という警告が[ウェブ] を選択しないと選択できません。 ウェブ ウェブが最適化されていない アプリ