形式の説明については、概要をご覧ください。
| フィールド | 必須 | タイプ | 書き込み可能 | 説明 |
|---|---|---|---|---|
| 製品 ID | いいえ | integer | いいえ | メディア プロダクトの数値 ID 値。 |
| プラン ID | いいえ | integer | いいえ | メディア プロポーザルの数値 ID 値。 |
| キャンペーン ID | いいえ | integer | いいえ | |
| 名前 | はい | 文字列 | はい | エントリの名前。 |
| タイプ | いいえ | 文字列 | いいえ | メディア プロダクトのタイプ。
|
| 開始日 | いいえ | 文字列 | いいえ | メディア プロダクトの開始日(MM/DD/YYYY HH:mm 形式) |
| 終了日 | いいえ | 文字列 | いいえ | メディア プロダクトの終了日(MM/DD/YYYY HH:mm 形式) |
| 予算 | いいえ | float | いいえ | メディア プロダクトの正の予算額。常に金額の予算となるため、通貨額は常に float になります。通貨は、広告主の通貨で標準単位(通貨単位の 1/1,000,000 ではなく)で表示されます。 |
| フリークエンシーが有効 | はい | 文字列 | はい | |
| フリークエンシーの表示回数 | [フリークエンシーが有効] が [TRUE] の場合は必須 | integer | はい | 指定されたフリークエンシーの期間内のインプレッション数の正の整数値(「y 期間に x 回のインプレッションを表示する」の x)。 |
| フリークエンシーの期間 | [フリークエンシーが有効] が [TRUE] の場合は必須 | 文字列 | はい |
|
| フリークエンシーの量 | [フリークエンシーが有効] が [TRUE] の場合は必須 | integer | はい | |
| 地域ターゲティング - 含める | いいえ | 文字列、リスト | はい | ターゲティングに含める地域のリスト。 この列では、ターゲティング タイプ リストの形式 =(TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値の昇順で生成されます。 |
| ターゲット言語 - 含める | いいえ | 文字列、リスト | はい | ターゲティングに含める言語のリスト。 この列では、ターゲティング タイプ リストの形式 =(TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値の昇順で生成されます。 |
| ターゲット言語 - 除外する | いいえ | 文字列、リスト | はい | ターゲティングから除外する言語のリスト。 この列では、ターゲティング タイプ リストの形式 =(TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値の昇順で生成されます。 |
| チャンネル ターゲティング - 含める | いいえ | 文字列、リスト | はい | ターゲティングに含めるチャンネルのリスト。 この列では、Display & Video 360 API リストの形式 =(Channel.channelId; Channel.channelId; など)。 |
| チャンネル ターゲティング - 除外する | いいえ | 文字列、リスト | はい | ターゲティングから除外するチャンネルのリスト。 この列では、Display & Video 360 API リストの形式 =(Channel.channelId; Channel.channelId; など)。 |
| カテゴリ ターゲティング - 含める | いいえ | 文字列、リスト | はい | ターゲティングに含めるカテゴリのリスト。この列では、ターゲティング タイプ リストの形式 =(TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値の昇順で生成されます。 |
| カテゴリ ターゲティング - 除外する | いいえ | 文字列、リスト | はい | ターゲティングから除外するカテゴリのリスト。この列では、ターゲティング タイプ TARGETING_TYPE_CATEGORY に Display & Video 360 API の TargetingOption リソース ID を使用します。リストの形式 =(TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値の昇順で生成されます。 |
| オーディエンス ターゲティング - 含める | いいえ | 文字列、ペアのリストのリスト | はい | ターゲティングに含めるオーディエンス リストのリスト。 この列では、Display & Video 360 API ファーストパーティ オーディエンス リストの場合、各オーディエンスは FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId と有効期間の設定のペアとして表示されます。ペアは(1;1d;)です。1d は 1 日のリピート間隔を表すリピート間隔のサンプルです。サードパーティ オーディエンスではリピート間隔を使用できないため、リストの形式は(3;);(4;); となります。オーディエンスのグループを「AND」と「OR」で組み合わせるには、次の例のようにします。リピート間隔ありのペアとリピート間隔なしのペアを組み合わせる場合: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。これは、(有効期間が 1 日のリスト 1 OR 有効期間が 365 日のリスト 2)AND(有効期間が指定されていないリスト 3 OR 有効期間が 5 分のリスト 4 OR すべてのユーザーを含むリスト 5)を意味します。 有効なリピート間隔の値は次のとおりです。
|
| オーディエンス ターゲティング - 除外する | いいえ | 文字列、ペアのリストのリスト | はい | ターゲティングから除外するオーディエンス リストのリスト。 この列では、Display & Video 360 API オーディエンス リストが 1P オーディエンス リストの場合、各オーディエンスは FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId と有効期間の設定のペアとして表示されます。ペアは(1;1d;)です。1d は 1 日のリピート間隔を表すリピート間隔のサンプルです。ただし、3P オーディエンスでは有効期間を使用できないため、リストの形式は(3;);(4;); となります。 リストの形式 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; リピート間隔(省略可);); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; リピート間隔(省略可););) 有効なリピート間隔の値は次のとおりです。
|
| アフィニティと購買意向の強いオーディエンス ターゲティング - 含める | いいえ | 文字列、リスト | はい | |
| アフィニティと購買意向の強いオーディエンス ターゲティング - 除外する | いいえ | 文字列、リスト | はい | |
| 年齢や性別によるターゲティング - 性別 | いいえ | 文字列、リスト | はい | ターゲットにする性別のリスト。次のいずれかの値を選択します。
|
| 年齢や性別によるターゲティング - 年齢 | いいえ | 文字列、リスト | はい | ユーザーの年齢層をターゲットにします。開始年齢と終了年齢を 1 つずつ選択し、不明な年齢を含めるかどうか(true / false)を指定して、範囲を指定します。指定できる開始年齢と終了年齢のリストをご覧ください。 例 1: 18 ~ 55 歳をターゲットにし、不明な年齢を含める場合は、{開始; 終了; 不明な年齢を含める(True / False)} = 18;55;true; の形式で指定します。 例 2: 35 歳以上のユーザーのみをターゲットにし、不明な年齢を除外する場合は、35;+;false; と指定します。 指定できる開始年齢の値:
指定できる終了年齢の値:
|
| 年齢や性別によるターゲティング - 子供の有無 | はい | 文字列、リスト | はい | ターゲットにする子供の有無のリスト。 次のいずれかの値を選択します。
|
| デバイス ターゲティング - 含める | いいえ | 文字列、リスト | はい | ターゲティングに含めるデバイスのリスト。 この列では、次のターゲティング タイプに Display & Video 360 API
リストの形式 =(TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値の昇順で生成されます。 |
| 動画プレーヤーのサイズ ターゲティング | いいえ | 文字列、リスト | はい | ターゲットにする動画広告プレーヤーのサイズのリスト。次のいずれかの値を選択します。
|
| 非公開 - 販売者名 | いいえ | 文字列 | いいえ | 取引におけるパブリッシャーの名前。このフィールドは、非公開のメディア プロダクトにのみ適用されます。 |
| 非公開 - 注文 ID | いいえ | 文字列 | いいえ | 保証型取引の注文 ID。このフィールドは、非公開のメディア プロダクトにのみ適用されます。 |
| 非公開 - 広告枠ソース ID | いいえ | 文字列 | いいえ | 広告在庫ソースの DBM ID。このフィールドは、非公開のメディア プロダクトにのみ適用されます。 |