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

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

項目必須タイプ書き込み可能説明
キャンペーン ID既存のキャンペーンを編集する場合にのみ必須整数×キャンペーンの数値 ID 値。空白のままにすると、新しいキャンペーン ID が作成されて一意の ID が割り当てられます。必要に応じて、新しいキャンペーンを作成する際に、広告掲載オーダーを新しいキャンペーンに割り当てる目的でカスタム ID を使用できます。カスタム識別子の形式は「ext[カスタム識別子]」です(例: ext123)。ファイルがアップロードされて処理されると、すべてのカスタム識別子は DBM によって割り当てられた ID に置き換えられ、オブジェクトがそのカスタム識別子に基づいて関連付けられます(広告掲載オーダーとキャンペーンなど)。
広告主 IDはい整数×広告主の数値 ID 値。有効な既存の広告主 ID を指定してください
名前はいstringはいエントリの名前。
タイムスタンプ既存のエントリを編集する場合は必須整数×エントリのタイムスタンプ。ダウンロードからアップロードまでの間にエントリが変更されていないことをシステムが確認するために使用されます。
ステータスはいstringはいエントリのステータス設定。
  • 有効
  • 一時停止
  • アーカイブしました
キャンペーンの目標はいstringはい該当するキャンペーン目標を 1 つ選択します。
  • ブランドや商品の認知度を高める
  • オンラインのユーザー行動やアクセス数を伸ばす
  • オフラインや店舗での販売を促進する
  • アプリのインストールやエンゲージメントを増やす
キャンペーン目標 KPIはいstringはい該当するキャンペーン目標の KPI を 1 つ選択します。
  • CPM
  • 視認可能な割合(%)
  • CPIAVC
  • CPA
  • CPC
  • CTR(クリック率)
  • Other
キャンペーン目標の KPI 値はいfloatはいキャンペーン目標の KPI は正の数値です。キャンペーン目標の KPI である「視認範囲の割合」と「クリック率」については、このフィールドの値を割合で入力します。たとえば、「80%」は「80」と入力します。KPI が「その他」の場合、このフィールドは目標の簡単な説明です。
クリエイティブ タイプはい文字列、リストはい使用することが想定されるクリエイティブ タイプのリスト。
  • ディスプレイ
  • 動画
  • 音声
キャンペーンの予算×floatはい正の予算額。常に金額の予算であるため、通貨の金額については浮動小数点数になります。通貨は広告主の通貨で標準単位で表示されます(通貨単位の 1/1,000,000 では表示できません)。
キャンペーン開始日はいstringはいキャンペーンの開始日。MM/DD/YYYY HH:mm の形式で指定します。
キャンペーン終了日×stringはいキャンペーンの終了日。形式は MM/DD/YYYY HH:mm
フリークエンシー有効はいstringはいキャンペーンで、インプレッション ベースのフリークエンシー キャップを有効または無効にします。
  • TRUE
  • FALSE
頻度の露出[Frequency Enabled] が [TRUE] の場合は必須整数はい指定されたフリークエンシー金額でのインプレッション数(正の整数値)。つまり、[y の期間に x 件のインプレッションを表示] の x です。
フリークエンシーの期間[Frequency Enabled] が [TRUE] の場合は必須stringはいフリークエンシー キャップの期間の単位を指定します。
  • 時間
  • ライフタイム
フリークエンシーの値[Frequency Enabled] が [TRUE] の場合は必須整数はいフリークエンシー期間タイプの期間、つまり [y の期間に x 件のインプレッションを表示] の y を表す正の整数です。
キャンペーンの予算セグメント×文字列、リストのリストはいキャンペーンの予算セグメントのセット。リスト形式 = (ID; 名前; タイプ; 金額; 開始日; 終了日; 外部予算ソース; 外部予算 ID; 請求書グループ ID; Prisma クライアントコード; Prisma プロダクトコード; Prisma 予想コード; Prisma タイプ; サプライヤー;)

    例 '(; My Budget; IMPRESSIONS; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; Client; Product; Estimate; DISPLAY; MySupplier;)' ID と終了日が指定されていません。
    使用可能な値は、次の表に記載されています。

    列名必須説明
    ID×キャンペーン予算セグメントの一意の ID。予算セグメントの編集時に指定する必要があります。空白のままにすると、予算セグメントは新規として書き込まれます。
    名前はいキャンペーンの予算セグメントの表示名。
    タイプはい予算額のタイプ。指定できる値は次のとおりです。
    • 金額
    • インプレッション数
    金額はい予算タイプの予算額です。単純な整数のインプレッション値か、通貨の金額を表す浮動小数点数になります。通貨は広告主の通貨(通貨単位の 1/1,000,000 単位ではなく)で標準単位で表示されます。
    開始日×予算セグメントの掲載期間の開始日のタイムスタンプ(MM/DD/YYYY HH:mm 形式)。開始日が設定されていない場合は、フィールド値が空白になります。
    終了日×予算セグメントの掲載期間の終了日のタイムスタンプ(MM/DD/YYYY HH:mm 形式)。終了日が設定されていない場合は、空白のフィールド値で表されます。
    外部予算ソースはい予算セグメントの参照元。指定できる値は次のとおりです。
    • なし
    • メディアオーシャン
    外部予算 IDMediaocean 予算セグメントのみ設定すると、顧客が予算セグメント レベルの課金を有効にしている場合、この予算セグメントに対して配信されるすべてのインプレッションの請求書に、この ID が含まれます。
    請求書グループ ID×設定すると、顧客が予算セグメント レベルの課金を有効にしている場合、同じ外部予算 ID と請求グループ ID を持つすべての予算セグメントが 1 つの請求書に集約されます。
    Prisma クライアント コードMediaocean 予算セグメントのみMediaocean 予算セグメントに対してのみ設定できます。Google お支払いセンターでは、このフィールドの検索とフィルタがサポートされています。
    Prisma 商品コードMediaocean 予算セグメントのみMediaocean 予算セグメントに対してのみ設定できます。Google お支払いセンターでは、このフィールドの検索とフィルタがサポートされています。
    Prisma 見積もりコードMediaocean 予算セグメントのみMediaocean 予算セグメントに対してのみ設定できます。Google お支払いセンターでは、このフィールドの検索とフィルタがサポートされています。
    プリズマの種類Mediaocean 予算セグメントのみMediaocean 予算セグメントに対してのみ設定できます。セグメントのプリズマタイプ。指定できる値は次のとおりです。
    • ディスプレイ
    • 検索
    • 動画
    • 音声
    • ソーシャル
    • 手数料
    プリズマ製造業者Mediaocean 予算セグメントのみMediaocean 予算セグメントに対してのみ設定できます。この予算に割り当てられているエンティティ(DSP、サイトなど)
年齢や性別によるターゲティング: 性別×文字列、リストはいターゲットとする性別のリストです。使用可能な値を 1 つ以上選択します。
  • 女性
  • 男性
  • 不明
年齢や性別によるターゲティング: 年齢×文字列、リストはいユーザーの年齢層をターゲットに設定する。単一の [開始年齢] と [終了年齢] を 1 つ選択し、不明な年齢を true または false を含めるかどうかを 1 つ選択し、開始と終了の範囲を指定します。使用可能な開始および終了年齢のリストを参照してください。
例 1: 18 ~ 55 歳をターゲットに設定し、不明な年齢を含めるには、{From; To ; include 不明な True/False} = 18;55;true; の形式を指定します。
例 2: 35 歳以上のユーザーのみをターゲットに設定し、不明な年齢を除外するには、次の値を指定します。

  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

To に指定できる値:
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
ユーザー属性ターゲティングの世帯収入×文字列、リストはい世帯収入の範囲をターゲットに設定する。収入の範囲の Top_of_Range を 1 つ、収入の範囲を Bottom_of_Range を 1 つ選択し、収入が不明な世帯を含めるかどうかを true または false にして、開始と終了の範囲を指定します。使用可能な Top_of_Range/Bottom_of_Range の範囲のリスト
    (Top_of_Range/Bottom_of_Range の場合) Bottom_of Bottom_0 lower_of Range; Bottom_of Range; Bottom_of Range または Bottom_of Range が、ユーザーの上位 10% から 50% の世帯を対象にターゲティングするには、{Top_of_Range; Bottom_of_Range; Bottom_of_Range; Bottom_of_Range} = Top 10%;41-50%;true;
    例 2: 下位の世帯のみを対象に指定します。
    例 1: 上位 10% から 50% の世帯を対象にする場合は、形式を指定します。
  • 上位 10%
  • 11~20%
  • 21~30%
  • 31~40%
  • 41~50%
  • 下位 50%

年齢や性別によるターゲティング: 子供の有無はい文字列、リストはいターゲットとする子供の有無のリストです。使用可能な値を 1 つ以上選択します。
  • 子供あり
  • 子供なし
  • 不明
地域ターゲティング - 一致×文字列、リストはい

ターゲティングに含める地域のリスト。

この列では、ターゲティング タイプ TARGETING_TYPE_GEO_REGION の Display & Video 360 API の TargetingOption リソース ID を使用しています。

リスト形式 = (ターゲティングオプション.ターゲティングオプション ID; ターゲティングオプション.ターゲティングオプション ID; など)。このリストは昇順で生成されます。

地域ターゲティング - 除外×文字列、リストはい

ターゲティングで除外する地域のリスト。

この列では、ターゲティング タイプ TARGETING_TYPE_GEO_REGION の Display & Video 360 API の TargetingOption リソース ID を使用しています。

リスト形式 = (ターゲティングオプション.ターゲティングオプション ID; ターゲティングオプション.ターゲティングオプション ID; など)。このリストは昇順で生成されます。

ターゲット言語 - 一致×文字列、リストはい

ターゲティングに含める言語のリストです。

この列では、ターゲティング タイプ TARGETING_TYPE_LANGUAGE の Display & Video 360 API の TargetingOption リソース ID を使用しています。

リスト形式 = (ターゲティングオプション.ターゲティングオプション ID; ターゲティングオプション.ターゲティングオプション ID; など)。このリストは昇順で生成されます。

ターゲット言語 - 除外×文字列、リストはい

ターゲティングで除外する言語のリスト。

この列では、ターゲティング タイプ TARGETING_TYPE_LANGUAGE の Display & Video 360 API の TargetingOption リソース ID を使用しています。

リスト形式 = (ターゲティングオプション.ターゲティングオプション ID; ターゲティングオプション.ターゲティングオプション ID; など)。このリストは昇順で生成されます。

デジタル コンテンツ ラベル - 除外×文字列、リストはい除外するデジタル コンテンツ ラベルのリスト。リスト形式 = (G;PG; など)。
  • G
  • PG
  • T
  • MA
  • ?
ブランド保護の感度設定×stringはい感度の設定を選択すると、周囲のコンテンツのテーマに基づいて広告枠がブロックされます。
  • ブロックしない
  • キャンペーン マネージャー 360 のベリフィケーションを使用する
  • カスタムを使用
ブランド保護のカスタム設定[ブランド保護のカスタム設定] が [カスタムを使用] の場合は必須文字列、リストはいブランド保護の感度設定が [カスタムを使用] の場合は、標準のコンテンツ分類のリストを指定します。例: (性的、アルコール、タバコ)
  • 性的
  • 中傷
  • ダウンロードと共有
  • 武器および兵器
  • ギャンブル
  • 暴力
  • 性的内容を示唆
  • 冒とく
  • アルコール
  • 治療薬
  • タバコ
  • 政治
  • 宗教
  • 悲劇
  • 交通事故
  • デリケートな社会問題
  • 衝撃的
第三者認証サービス×stringはい第三者のベリフィケーション サービス プロバイダ。
  • なし
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三者認証ラベル×文字列、リストはい[第三者ベリフィケーション サービス] が [なし] でない場合は、選択したプロバイダでサポートされているラベルのリストを指定します。
視認性ターゲティングのアクティブ ビュー×stringはい視認性の予測値(%)をターゲットに設定します。パーセンテージは浮動小数点数で表されます。{0.1、0.2、0.3、0.4、0.5、0.6、0.7、0.8、0.9} のいずれか
位置ターゲティング - 画面上に表示×文字列、リストはい画面上のディスプレイ広告の位置ターゲティング。使用可能な値を 1 つ以上選択します。
  • スクロールせずに見える範囲
  • スクロールしなければ見えない範囲
  • 不明
位置ターゲティング - 画面上の動画×文字列、リストはい画面上の動画広告位置ターゲティング。使用可能な値を 1 つ以上選択します。
  • スクロールせずに見える範囲
  • スクロールしなければ見えない範囲
  • 不明
位置ターゲティング - コンテンツ内の位置の表示×文字列、リストはいターゲットとするディスプレイ広告コンテンツ内の位置。使用可能な値を 1 つ以上選択します。
  • 記事内
  • インフィード
  • インバナー
  • インタースティシャル
  • 不明
位置ターゲティング - コンテンツ内の動画内の位置×文字列、リストはいターゲットとする動画広告コンテンツの位置。使用可能な値を 1 つ以上選択します。
  • 記事内
  • インフィード
  • インバナー
  • インタースティシャル
  • 不明なアウトストリーム
  • プレロールで取り込む
  • ミッドロール
  • ポストロール
  • 不明なインストリーム
広告枠ソース ターゲティング - 認定販売者のオプション[タイプ] が [ディスプレイ]、[動画]、[オーディオ] の場合は必須stringはい認定直接販売者、認定直接販売者と認定販売パートナー、認定販売者(不明)をターゲットとする設定。「認定直接販売者」は、認定販売者のみがターゲティングされることを意味します。「認定直接販売者および認定販売パートナー」とは、認定販売者および認定販売パートナーをターゲットとすることを意味します。「認定販売者と未参加のパブリッシャー」とは、認定販売者、再販業者、不明な販売者を対象とします。
  • 認定直接販売者
  • 認定直接販売者と認定販売パートナー
  • 認定販売者と未参加のパブリッシャー
広告在庫ソース ターゲティング - 追加×文字列、リストはい

ターゲティングに含める広告枠ソース、エクスチェンジ、サブエクスチェンジのリスト。

この列では、ディスプレイ &ビデオ 360 API InventorySource のリソース ID、公開エクスチェンジ ID、ディスプレイ &ビデオ 360 API TargetingOption のターゲティング タイプ TARGETING_TYPE_SUB_EXCHANGE のリソース ID が使用されます。

リストの形式 = (InventorySource.inventorySourceId; exchangeId; TargetOption.薄型オプション ID; など)

広告在庫ソース ターゲティング - 除外×文字列、リストはい

ターゲティングで除外する広告在庫ソース、エクスチェンジ、サブエクスチェンジのリスト。

この列では、ディスプレイ &ビデオ 360 API InventorySource のリソース ID、公開エクスチェンジ ID、ディスプレイ &ビデオ 360 API TargetingOption のターゲティング タイプ TARGETING_TYPE_SUB_EXCHANGE のリソース ID が使用されます。

リストの形式 = (InventorySource.inventorySourceId; exchangeId; TargetOption.薄型オプション ID; など)

広告在庫ソースのターゲティング - 新しいエクスチェンジをターゲットに設定する×stringはい新しいエクスチェンジをターゲットに設定します。
  • 正しい
  • False
環境ターゲティング×文字列、リストはい対象とする環境のリスト。使用可能な値を 1 つ以上選択します。[ウェブが最適化されていません] を選択するには、[ウェブ] を選択する必要があります。
  • ウェブ
  • ウェブ最適化されていません
  • アプリ