プロファイル サービスの概要

プロファイルは、性別、年齢、地域、頻度などのターゲット パラメーターのセットです。 これはシステム内の複数のオブジェクトに適用できますが、そのほとんどを以下に示します。 プロファイルサービスの最も一般的な用途は、キャンペーンを実行することです。プロファイルを作成し、 それを Campaign Service に関連付けます。 キャンペーン オブジェクトには、フライト日や関連するクリエイティブなどのフィールドが含まれます。

  • セグメント ターゲティングを除き、パラメーターは絶対的です。 たとえば、地理的ターゲットが米国のみに設定されている場合、米国ベースのインプレッションのみが入札を受け取ります。
  • セグメント ターゲティングでの AND/OR ブール ロジックの使用。
  • 以下に示すシステム内の他の複数のオブジェクトと共に使用するには、プロファイルを広告主またはパブリッシャーのいずれかに関連付ける必要があります。

プロファイルは、システム内の他のいくつかのオブジェクト (以下に示す) と共に使用できます。 関連付けられたオブジェクトに適用されないプロファイル内のフィールドはすべて無視されます。

  • 広告主
  • ライン項目
  • クリエイティブ
  • キャンペーン
  • 支払ルール
  • 広告品質ルール

また、取引オブジェクト内でプロファイルを参照することもできますが、プロファイルを広告主またはパブリッシャーに関連付ける必要はありません。

REST API

HTTP メソッド エンドポイント 説明
POST https://api.appnexus.com/profile?advertiser_id=ADVERTISER_ID&member_id=MEMBER_ID
(profile JSON)		 新しいプロファイルを追加します。
POST https://api.appnexus.com/profile?advertiser_code=ADVERTISER_CODE
(profile JSON)		 新しいプロファイルを追加します。
PUT https://api.appnexus.com/profile?id=PROFILE_ID&advertiser_id=ADVERTISER_ID&member_id=MEMBER_ID
(profile JSON)		 既存のプロファイルを変更します。
PUT https://api.appnexus.com/profile?code=PROFILE_CODE&advertiser_code=ADVERTISER_CODE
(profile JSON)		 既存のプロファイルを変更します。
GET https://api.appnexus.com/profile?advertiser_id=ADVERTISER_ID&member_id=MEMBER_ID 広告主の 1 つのプロフィールをすべて表示します。
GET https://api.appnexus.com/profile?advertiser_code=ADVERTISER_CODE 広告主の 1 つのプロフィールをすべて表示します。
GET https://api.appnexus.com/profile?id=PROFILE_ID&advertiser_id=ADVERTISER_ID&member_id=MEMBER_ID 広告主の特定のプロフィールを表示します。
GET https://api.appnexus.com/profile?code=PROFILE_CODE&advertiser_code=ADVERTISER_CODE 広告主の特定のプロフィールを表示します。

注:

postal_code_action_include - パブリッシャー プロファイルにこのサービスを使用するには、 advertiser_id を publisher_id に置き換えます。

JSON フィールド

全般

フィールド 種類 説明
id int プロファイルの ID。
必須:PUT、クエリ文字列内。
code string プロファイルのカスタム コード。
description string オプションの説明。
is_template ブール型 trueの場合、プロファイルはターゲット テンプレートとして に保存されています。 テンプレートを対象とするプロファイルを取得するには、GET呼び出しのクエリ文字列に is_template=true を渡します。 ターゲティング テンプレートの詳細については、アプリのヘルプ システム内の「ターゲティング テンプレートの管理」を参照してください。
既定値:false
last_modified timestamp このプロファイルの最終変更時刻。
is_archived ブール値 読み取り専用です。 親品目が使用されていない (したがってアーカイブされた) ためにプロファイルが自動的にアーカイブされたかどうかを示します。 true に設定すると、値を変更することはできず、プロファイル オブジェクトで実行できる呼び出しは GET と DELETE のみです。

メモ: プロファイルの親が自動的にアーカイブされた場合、プロファイルもアーカイブされます。 さらに、アーカイブされたプロファイルは、どの広告申込情報やキャンペーンにも関連付けられなくなる可能性があります。
既定値:false
archived_on timestamp 読み取り専用です。 プロファイルがアーカイブされた日時 (つまり、 is_archived フィールドが true に設定された日時)。
既定値:null

Frequency

頻度と最新性のターゲット設定と以下のフィールドの詳細については、 こちらを参照してください。

フィールド 種類 説明
max_lifetime_imps int 1 ユーザーあたりの最大インプレッション数。 設定する場合、この値は 0 から 255 の間である必要があります。
既定値:null
min_session_imps int 1 ユーザー 1 セッションあたりの最小インプレッション数。 設定する場合、この値は 0 から 255 の間である必要があります。
既定値:null
max_session_imps int 1 ユーザー 1 セッションあたりの最大インプレッション数。 設定する場合、この値は 0 から 255 の間である必要があります。
既定値:null
max_day_imps int 1 ユーザーあたり 1 日あたりの最大インプレッション数。 設定する場合、この値は 0 から 255 の間である必要があります。
既定値:null
max_hour_imps int 1 ユーザーあたり 1 時間あたりの最大インプレッション数。 設定する場合、この値は 0 から 255 の間である必要があります。
既定値:null
max_week_imps int 1 人あたり 1 週間あたりの最大インプレッション数。 設定する場合、この値は 0 から 255 の間である必要があります。
既定値:null
max_month_imps int 1 ユーザーあたり 1 か月あたりの最大インプレッション数。 設定する場合、この値は 0 から 255 の間である必要があります。
既定値:null
min_minutes_per_imp int 1 ユーザーあたりのインプレッション間の最小分数。 このフィールドは 0 に設定できません。
既定値:null
max_page_imps int ページ読み込みあたりの最大インプレッション数 (販売者の広告要求)。

メモ: マルチタグ オークション (例: /(ss)vmap) にのみ関連します。
既定値:null
require_cookie_for_freq_cap ブール型 頻度の上限設定を維持するために、既知の識別子を持つユーザーにのみサービスを提供するかどうかを示します。 このフィールドを true に設定すると、既知の識別子を持つユーザーにのみ広告が配信されるため、フリークエンシー キャップの設定が維持されます。 このフィールドを false に設定すると、匿名ユーザーにもサービスを提供することを示します。 毎日発生する頻度上限を設定している場合、高度な頻度管理により、モデリングを通じて匿名ユーザーへのインプレッションが制御されます。 それ以外の場合、頻度の上限設定はこれらのユーザーに適用されません。 このフラグは頻度の上限が設定されている場合にのみ適用されるので、このフィールドを true に設定しても、アクティブな頻度の上限設定がないオブジェクトの識別子は必要ありません。

既定値: true
注: 高度な頻度管理は現在、Monetize ユーザーではサポートされていません。

ターゲティング

複数のターゲットを設定した場合、すべてのターゲット条件を満たすインベントリのみが対象となります。 たとえば、対象ユーザー general とインベントリー ソース x、y、z をターゲットにした場合、プロファイル general 対象ユーザー ソース x、y、z のみが対象になります。

注:

POST または PUT 呼び出しでは、segment_targets フィールドと segment_group_targets フィールドの両方を指定することはできません (指定できるのは 2 つのうちの 1 つだけです)。

  • ターゲットによっては、整数や文字列ではなく オブジェクト の配列を受け入れる場合があることに注意してください。 この形式は、このページの下部にある例で確認できます。
  • プログラマティック保証購入広告申込情報の場合:
    • ターゲットにできる取引ターゲットは 1 つのみ (以下の 「取引ターゲット 」を参照)、 allow_unaudited フィールドを true に設定する必要があります。
    • 他のターゲティング フィールドは設定しないでください。
  • 拡張広告申込情報の場合、地域ターゲティングとして少なくとも 1 つの国を設定する必要があります (下記の国ターゲットを参照)。
  • 2021 年 8 月 30 日より有効:

    • TapAd のグラフは、ヨーロッパを除くグローバルをカバーします。

    • Xandr のグラフは、ヨーロッパと米国をカバーします。

      それに応じてコードを調整します。

フィールド 種類 説明
graph_id int - Null 広告申込情報がメンバー シートの既定のグラフ選択をターゲットとしている場合。
- 0 広告申込情報がグラフなしをターゲットとしている場合。
- 3 ライン項目が TapAd Graph をターゲットとしている場合。
- 4 ライン項目が Xandr Graph をターゲットにしている場合。
注: 既定のクロスデバイス パイロットに含まれる一部の EMEA Invest メンバー シートについては、 graph_id フィールドの期待値が変更されます。
graph_id を Nullとして渡すと、メンバー シートの既定のグラフ選択に対応するようになります。 EMEA パイロットのメンバーの場合、これは graph_id = 4になります。 クロスデバイス ターゲティングを無効にするには、これらのメンバー シートが graph_id = 0 を渡す必要があります。
daypart_timezone string daypart_targetsで使用するタイムゾーン。 詳細については、「 API タイムゾーン」を参照してください。

注:null は、ユーザーのタイムゾーンに相当します。

既定値:null
daypart_targets オブジェクトの配列 キャンペーンを提供する日の部分。 詳細については、以下の デイパート ターゲット を参照してください。

メモ: 曜日パートのターゲットを設定しない場合、キャンペーンは曜日中いつでも配信されます。
segment_targets オブジェクトの配列 メモ:segment_targets を使用し、関連付けられているキャンペーンを UI で編集すると、セグメントはsegment_group_targets配列内のグループに変換されます。 そのため、API 経由で作業する場合は segment_group_targets を使用することをお勧めします。

ターゲットとするセグメント ID。それぞれにアクション (include または exclude) が関連付けられています。 配列外の segment_boolean_operator フィールドを使用して、セグメント間のブール論理を定義します。 詳細については、 セグメント ターゲット と以下の例を参照してください。
segment_group_targets オブジェクトの配列 ターゲットとするセグメント グループ。 segment_targets 配列を使用すると、個々のセグメント間のブール ロジックを定義できますが、この配列を使用すると、セグメントのグループを確立して、グループ間および各グループ内のセグメント間のブール ロジックを定義できます。 配列外の segment_boolean_operator フィールドを使用して、グループ間間のブール論理を定義します。グループ オブジェクト内の boolean_operator フィールドを使用して、グループ内のセグメント間のブール論理を定義します。 詳細については、「 セグメント グループ ターゲット 」と以下の例を参照してください。

メモ: Null セグメントを追加することはできません。
POST または PUT を使用して、この配列にnullセグメントを追加することはできません。
segment_boolean_operator 列挙 segment_targets を使用する場合、これは、指定されたセグメント間のブール論理を定義します。 segment_group_targets を使用する場合、これはセグメント グループ間のブール論理を定義します (グループ内のセグメント間のブール論理は、segment_group_targets 配列で直接定義されます)。
使用可能な値: and または or。
既定値:and
age_targets オブジェクトの配列 このプロファイルの対象とする年齢層のリスト。 allow_unknown フィールドは、ユーザーの年齢が指定できない広告呼び出しに対応するために、ブール値として使用できます。 詳しい説明と例については、以下の年齢 ターゲット のセクションをご覧ください。
gender_targets object プロフィールに使用される性別ターゲティング。 性別の有効な値は m または f です。 allow_unknown フィールドは、ユーザーの性別が不明な広告呼び出しを説明するために、ブール値として使用できます。 以下のジェン ダー ターゲット のセクションを参照してください。
country_targets オブジェクトの配列 [ country_action ] フィールドで定義されているように、プロファイルで除外または含める国 ID。 Country Service を使用すると、国 ID のリストを取得できます。 詳細と形式については、「 国ターゲット」を参照してください。
必須:POST/PUT、 country_action を含める場合。
country_action 列挙 country_targets リストで実行するアクション。 使用可能な値: include または exclude。
既定値:exclude
region_targets オブジェクトの配列 [ region_action ] フィールドで定義されているように、プロファイルで除外するか含める地域/州 ID。 リージョン サービスを使用して、リージョン ID の一覧を取得できます。 詳細と形式については、以下の 「リージョン ターゲット 」を参照してください。
必須日付:POST/PUT、region_action がincludeとき。
require_transparency_and_consent_framework_string ブール値 - trueの場合、有効な TCF 文字列が存在する場合にのみ、関連付けられたオブジェクトがインベントリを購入できるようにします。
- false場合は、関連付けられたオブジェクトが、事前定義されたターゲティング宣言に含まれるインベントリを購入できるようにします。
- 他のレベルでターゲティングを行うと未定義の動作が発生する可能性があるため、これは広告主レベルでのみサポートされます。

メモ: このパラメーターは、GDPR が適用される地域から送信されるトラフィックにのみ適用されます。

既定値:false
region_action 列挙 region_targets リストで実行するアクション。
使用可能な値: include または exclude。
既定値:exclude
dma_targets オブジェクトの配列 [ dma_action ] フィールドで定義されているように、プロファイルで除外または含める指定された市場領域の ID。 DMA ID のリストを取得するには、 指定マーケット エリア サービス を使用できます。
dma_action 列挙 dma_targets リストで実行するアクション。
使用可能な値: include または exclude。
既定値:exclude
city_targets オブジェクトの配列 [ city_action ] フィールドで定義されているように、プロファイルに含めるか除外するかを決定する都市の ID。 City Service を使用して、都市 ID のリストを取得できます。 詳細と形式については、以下の 都市ターゲット を参照してください。
必須日付:POST/PUT、city_action がincludeとき。
city_action 列挙 city_targets リストで実行するアクション。 使用可能な値: include または exclude。
既定値:exclude
domain_targets オブジェクトの配列 domain_action フィールドで定義されているように、プロファイルに含めるか除外するかをドメインに含めるかを定義します。 書式については、次の例を参照してください。
domain_action 列挙 domain_targets リストで実行するアクション。 ドメインの詳細については、ドキュメントの「 ドメインまたはアプリ リストの作成 」を参照してください。
使用可能な値: include または exclude。
既定値:exclude
domain_list_targets オブジェクトの配列 domain_list_action フィールドで定義されているように、プロファイルに含めるか除外するドメインのリストの ID。 ドメイン リスト サービス を使用して、ドメイン リスト ID を取得できます。 フォーマットについては、以下の例を参照してください。

メモ: 1 つのプロファイルで使用できるドメイン リストは 100 個までです。
domain_list_action 列挙 domain_list_targets リストで実行するアクション。 ドメインの詳細については、ドキュメントの 「ターゲティング リストの操作 」を参照してください。 使用可能な値: include または exclude。
既定値:exclude
platform_placement_targets オブジェクトの配列 ターゲットにできる RTB またはその他のネットワークのインベントリ。 Inventory Resold または Reporting Services を使用して、プラットフォームの配置を検索できます。
size_targets オブジェクトの配列 プロファイルに含める資格のあるサイズの一覧。
サイズは配列サイズオブジェクト内にあり、各オブジェクトには各ターゲットサイズの幅と高さが含まれています。 以下の 例 を参照してください。

メモ: 保証された広告申込情報でブロッキングを有効にすると、この値が広告申込情報およびキャンペーンのクリエイティブ サイズと組み合わされて予測を生成します。 予測インプレッション数が最も少ないサイズが予測容量として返されます。
seller_member_group_targets オブジェクトの配列 プロフィールで除外または含める販売者メンバー グループ。 Xandr の直接供給を対象とするには、以下の 形式 を参照してください。
member_targets オブジェクトの配列 販売者メンバー ID を除外するか、プロファイルに含める。 特定の形式は、ページの下部にある例にあります。
member_default_action 列挙 非推奨です。
既定値:null
video_targets object プロファイルに含めるビデオ ターゲット ID。 特定の形式については、以下の 「ビデオ ターゲット 」を参照してください。
engagement_rate_targets オブジェクトの配列 過去のパフォーマンスに基づいて、特定のパフォーマンスの高い在庫をターゲットにします。 詳細については、以下の エンゲージメント率目標 を参照してください。
既定値:null
publisher_targets オブジェクトの配列 プロファイルで除外または含めるマネージド/ダイレクト パブリッシャー ID。
site_targets オブジェクトの配列 プロファイルで除外または含めるサイト ID。 除外または包含は、 publisher_targets フィールドから継承されます。
既定値: アクションを site_targets で指定しない場合、アクションは既定で NULL になり、 profile.inventory_action が使用されます。
placement_targets オブジェクトの配列 プロファイルで除外または含めるプレースメント ID。 除外または包含は、 publisher_targets フィールドから継承されます。

既定値: アクションに placement_targets を指定しない場合、アクションは既定で NULL に設定され、 profile.inventory_action が使用されます。
inventory_action 列挙 inventory_targets、publisher_targets、site_targets、placement_targets リストで実行するアクション。 使用可能な値: include または exclude。 アクションが includeの場合は、対象のパブリッシャー、サイト、またはプレースメントが含まれます。
既定値:exclude
content_category_targets 文字列と配列を持つオブジェクト このプロファイルの対象とするコンテンツ カテゴリ、および不明なカテゴリを許可するかどうか。 詳細と形式については、以下の 「コンテンツ カテゴリ ターゲット 」を参照してください。 コンテンツ カテゴリ ID を取得するには、 コンテンツ カテゴリ サービスを使用します。
deal_targets オブジェクトの配列 このプロファイルの対象となる取引 ID。 取引とは、買い手に優遇価格、独占在庫へのアクセス、在庫競争の減少、またはその他の機会を提供する可能性のある売り手と買い手の間の契約です。 詳細と形式については、以下の 取引ターゲット を参照してください。
このフィールドと deal_action_include フィールドの値がターゲット設定の結果に与える影響の詳細については、以下の「deal_action_include フィールドと deal_targets フィールドのターゲット設定結果」を参照してください。
deal_list_targets オブジェクトの配列 このプロファイルの対象となる取引リスト ID。 以下の 例 を参照してください。
取引リスト ID は、 取引リスト サービスを使用して取得できます。
platform_publisher_targets オブジェクトの配列 除外またはプロファイルに含めるサード パーティのパブリッシャー ID。 ID の一覧については、 在庫転売サービスをご覧ください。
platform_content_category_targets オブジェクトの配列 このプロファイルの対象とするネットワーク再販コンテンツ カテゴリの一覧。 ID のリストについては、 在庫転売サービスを参照してください。
use_inventory_attribute_targets ブール型 true場合、プロファイルはinventory_attribute_targetsに含まれる機密属性を含むインベントリを許可します。
既定値:false
trust 列挙 適格性を得るためにインベントリが満たす必要がある監査のレベルを示します。
使用可能な値: appnexus または "seller"。 このフィールドが "appnexus" に設定されている場合は、 allow_unaudited フィールドを false に設定する必要があります。
既定値:seller
allow_unaudited ブール型 true場合、このプロファイルにより、監査されていないインベントリがターゲティングを合格することができます。 trust フィールドが appnexus に設定されている場合は、false に設定する必要があります。

注:
- この設定は、メンバー サービスのinventory_trust オブジェクトの販売者の信頼設定を上書きします。
- プログラマティック保証購入品目の場合、 allow_unaudited を true に設定する必要があります。
既定値:false
session_freq_type 列挙 現在のブラウズ セッション中にユーザーが表示したインプレッション数のカウント方法を示します。 使用可能な値: platform (現在のセッションのすべてのパブリッシャー) または publisher (特定のパブリッシャー)。
既定値:platform
inventory_attribute_targets オブジェクトの配列 このプロファイルのターゲットとするインベントリ属性の ID。 インベントリ属性サービスを使用して、ID のリストを取得できます。
intended_audience_targets 文字列の配列 意図された対象ユーザー ターゲット。 指定可能な値: general、 children、 young_adult、または mature。

メモ: 意図したオーディエンス ターゲットを含める (除外しない) ことのみを選択できます。
例を参照してください。

メモ:意図したオーディエンス ターゲティングを使用するには、inventory_trust の下のdefault_trust (メンバーの下の属性) を seller に設定する必要があります。 この設定がないと、意図したオーディエンス ターゲティングは適用されません。
language_targets オブジェクトの配列 language_action フィールドで定義されている、プロファイルに含めるか除外するブラウザー言語の ID。 言語サービスを使用して、言語 ID を取得できます。
language_action 列挙 language_targetsで実行するアクション。 使用可能な値: include または exclude。
既定値:exclude
querystring_targets オブジェクトの配列 クエリ文字列は、querystring_action フィールドで定義されているように、プロファイル内のincludeまたはexcludeを対象とします。
querystring_action 列挙 querystring_targetsで実行するアクション。
使用可能な値: include または exclude。
既定値:exclude
querystring_boolean_operator 列挙 querystring_targetsに適用されるブール論理。
使用可能な値: and または or。
既定値:and
postal_code_targets オブジェクトの配列 対象とする郵便番号の ID。 例を参照してください。
ID は、 郵便番号サービスを使用して取得できます。
postal_code_list_targets オブジェクトの配列 対象とする郵便番号リストの ID。 例を参照してください。
ID は、 郵便番号リスト サービスを使用して取得できます。
postal_code_action_include ブール値 postal_code_targets で定義されている郵便番号、postal_code_list_targets で定義されている郵便番号リストをターゲティングに含めるかどうか、political_district_targets で定義された選挙区を含めるかどうか。
既定値:true
zip_targets オブジェクトの配列 非推奨。 代わりに postal_code_targets を使用してください。
supply_type_targets 文字列の配列 supply_type_action フィールドで定義されている、ターゲティングに含めるか除外する供給のタイプ。 可能な値: web、 mobile_web 、 mobile_app。

メモ:facebook_sidebar オプションは非推奨になりました。
supply_type_action 列挙 供給の種類は、 web、 mobile_web、および mobile_app です。 使用可能な値: include または exclude。 このフィールドが include に設定されている場合、 supply_type_targets に含まれる種類のインベントリのみがターゲットになります。 excludeの場合、supply_type_targetsにないインベントリのみがターゲットになります (非推奨になった facebook_sidebar を除く)。
既定値:exclude
user_group_targets object すべてのユーザーは 100 のユーザー グループのうちの 1 つにランダムに割り当てられ、どのグループも他のユーザー グループよりも優位に立つことはありません。 このフィールドを使用して、これらのユーザー グループの特定の範囲をターゲットにすることができます。 また、[ include_cookieless_users ] フィールドを使用して、Cookie を使用しないユーザーを追加または除外することもできます。 書式設定については、以下の プロフィールの表示 の例を参照してください。

メモ:ユーザー・グループ・パターン・サービスは、ユーザー・グループ・ターゲットの計算に役立ちます。
ユーザー グループ ターゲットの最も一般的な用途は、キャンペーン ターゲティング戦略の A/B テスト用のユーザー グループの定義です。 その手順は次のとおりです。1 つのプロファイルでテスト ユーザー グループ ターゲットを設定し、別のプロファイルで制御ユーザー グループ ターゲットを設定します。 次に、影響を受ける各キャンペーンにユーザーグループラベルを適用し、ラベルを使用してユーザーグループをテストまたはコントロールとして識別します(キャンペーンサービスのlabelsフィールドを参照)。 次に、 ネットワーク分析、 ネットワーク広告主分析、または 広告主分析 レポートを user_group_for_campaign ごとにグループ化して実行し、ユーザーグループ別にキャンペーンのパフォーマンスをランク付けします。
position_targets object ターゲットとする折りたたみ位置。 詳細については、以下の ポジション ターゲット を参照してください。
browser_targets オブジェクトの配列 [ browser_action ] フィールドで定義されている、ターゲティングに含めるか除外するブラウザーの ID。 ブラウザー サービスを使用して、ブラウザー ID のリストを取得できます。 フォーマットについては、以下の例を参照してください。
browser_action 列挙 browser_targetsで実行するアクション。 使用可能な値: include または exclude。
既定値:exclude
location_target_latitude double ユーザーの場所の緯度。 これは、-90 から 90 の間である必要があり、小数点以下 6 桁までで、南は負、北は正です。 モバイル デバイスから GPS データを利用できる場合は、プロファイルを特定の場所にターゲットすることができます。 緯度/経度のターゲット設定が設定されている場合、ユーザーは中心(location_target_latitude、 location_target_longitude)と半径 location_target_radiusで定義されたエリア内でのみターゲットになります。 GPS データをインプレッションに使用できない場合、ユーザーはターゲットになりません。
location_target_longitude double ユーザーの場所の経度。 これは、-180 から 180 の間である必要があり、小数点以下 6 桁までで、西は負、東は正です。 モバイル デバイスから GPS データを利用できる場合は、プロファイルを特定の場所にターゲットすることができます。 緯度/経度のターゲット設定が設定されている場合、ユーザーは中心(location_target_latitude、 location_target_longitude)と半径 location_target_radiusで定義されたエリア内でのみターゲットになります。 GPS データをインプレッションに使用できない場合、ユーザーはターゲットになりません。
location_target_radius 整数の長さ (メートル単位) 詳細については、location_target_latitudeを参照してください。
device_model_targets オブジェクトの配列 device_model_action フィールドで定義されているように、ターゲティングに含めるか除外するモバイル デバイス (iPhone など) のモデル。 システムに登録されているデバイス モデルの完全な一覧を取得するには、読み取り専用 のデバイス モデル サービスを使用してください。 詳細と形式については、以下の 「デバイス モデル ターゲット 」を参照してください。
device_model_action 列挙 device_model_targetsで実行するアクション。 使用可能な値: include または exclude。
既定値:exclude
device_type_targets 文字列の配列 [ device_type_action ] フィールドで定義されている、ターゲティングに含める、またはターゲティングから除外するデバイスのタイプ。
使用可能な値:
- phone
- tablet
- pc
- tv
- gameconsole
- stb
- mediaplayer

形式については、以下の デバイス タイプ ターゲット を参照してください。
device_type_action 列挙 device_type_targetsで実行するアクション。 使用可能な値: include または exclude。
既定値:exclude
carrier_targets オブジェクトの配列 carrier_action フィールドで定義されているように、ターゲティングに含めるか除外する携帯電話会社。 当社システムに登録されている携帯電話会社の完全なリストを取得するには、読み取り専用の キャリア サービスをご利用ください。 詳細と形式については、以下の 通信事業者ターゲット を参照してください。
carrier_action 列挙 carrier_targetsで実行するアクション。 使用可能な値: include または exclude。
既定値:exclude
inventory_url_list_targets オブジェクトの配列 インベントリ リスト ID (許可リストまたはブロックリスト) のリストが含まれます。 1 つの許可リストまたは 1 つ以上のブロックリストをプロファイルに添付するために使用します。
- 許可リストには、プロファイルを使用する明細行項目の対象となるドメインまたはアプリのリストが含まれています。 許可リストが含まれている場合、許可リストに含まれていないドメインとアプリは対象になりません。
- 各ブロックリストには、プロファイルを使用するライン アイテムによるターゲティングから除外するドメインまたはアプリのリストが含まれています。

詳細については、以下の インベントリ リスト を参照してください。
operating_system_family_targets オブジェクトの配列 operating_system_family_action フィールドで定義されているように、オペレーティング システム全体 (Android、Apple iOS、Windows 7 など) をターゲティングに含めるか除外するか。

メモ: このフィールドはオペレーティング システムのすべてのバージョンをターゲットにするために使用されますが、 operating_system_extended_targets はオペレーティング システムの特定のバージョンをターゲットにするために使用されます。 詳細と形式については、以下の 「オペレーティング システム ファミリ ターゲット 」を参照してください。
operating_system_family_action 列挙 operating_system_family_targetsで実行するアクション。 使用可能な値: include または exclude。
既定値:exclude
use_operating_system_extended_targeting ブール型 読み取り専用です。 true場合は、operating_system_extended_targets フィールドが優先されます。
既定では、新しいプロファイルでは、このフィールドは true に設定されています。 ただし、古いプロファイル (およびそれらを複製して作成された "新しい" プロファイル) では、このフィールドは既定で false に設定されます。
古いプロファイル (またはその複製) を更新して、このフィールドを true に設定する方法はありません。 これらの古いプロファイル (またはその複製) に OS 拡張ターゲティングを追加する場合は、新しいプロファイルを作成し、新しいプロファイルにターゲティング設定を追加する必要があります。
既定値:true
operating_system_extended_targets オブジェクトの配列 ターゲティングに含める、またはターゲティングから除外する特定のオペレーティング システムの一覧。

メモ: この配列は特定のオペレーティング システム バージョンをターゲットにするために使用されますが、 operating_system_family_targets はオペレーティング システムのすべてのバージョンをターゲットにするために使用されます。 詳細と形式については、以下の 「オペレーティング システム拡張ターゲット 」を参照してください。

メモ: このフィールドは、 use_operating_system_extended_targeting が true場合にのみ考慮されます。
operating_system_action 列挙 非推奨。 代わりに operating_system_extended_targets を使用してください。
既定値:exclude
operating_system_targets オブジェクトの配列 非推奨。 代わりに operating_system_extended_targets を使用してください。
mobile_app_instance_targets オブジェクトの配列 ターゲットに含めるかターゲットから除外するモバイル アプリ インスタンスのリスト。 フィールド定義については、後述の 「モバイル アプリ インスタンス ターゲット 」を参照してください。 モバイル アプリ インスタンスの詳細と動作については、「 モバイル アプリ インスタンス サービス」を参照してください。
mobile_app_instance_action_include ブール型 mobile_app_instance_targets で定義されているモバイル アプリ インスタンスをキャンペーンのターゲット設定に含めるかどうか。
既定値:false
mobile_app_instance_list_targets オブジェクトの配列 この一覧には、モバイル アプリ インスタンスのリストが含まれています (つまり、リストのリストです)。 フィールド定義については、以下の 「モバイル アプリ インスタンス リスト ターゲット 」を参照してください。 モバイル アプリ インスタンス リストの詳細とその機能については、 モバイル アプリ インスタンス リスト サービスを参照してください。
mobile_app_instance_list_action_include ブール型 mobile_app_instance_list_targets で定義されているモバイル アプリ インスタンスのリストをキャンペーン ターゲティングに含めるかどうか。
既定値:false
deal_action_include ブール型 キャンペーンや広告申込情報のターゲティングで定義されている deal_targets や、 deal_list_targets で定義されている取引リストを含めるか除外するか。 [ true] に設定すると、取引と取引リストが含まれます。

メモ: 取引や取引リストをターゲットまたは除外するには、このフィールドを true または false に設定するだけでなく、次の操作も行う必要があります。
- deal_targets と deal_list_targets の配列に含めるか除外する取引と取引リストのリストを指定します。 空のリストは、取引/取引リストなし ( deal_action_include が true に設定されている場合) またはすべての取引/取引リスト ( deal_action_include が false に設定されている場合) をターゲットにします。
- (ALIを使用する場合のみ)dealsフィールドをラインアイテムサービスのsupply_strategies配列内のtrueに設定します。

このフィールドと deal_targets フィールドの値がターゲティング結果に与える影響の詳細については、「 deal_action_include フィールドと deal_targets フィールドのターゲティング結果」を参照してください。
既定値:true
ip_range_list_targets オブジェクトの配列 キャンペーンのターゲット設定に含める、または除外する IP アドレス範囲のリスト。 詳細については、以下の 「IP 範囲リスト ターゲット 」と、 IP 範囲リスト サービスのドキュメントを参照してください。
key_value_targets オブジェクトの配列 カスタム キー/値ターゲットの一覧。 詳細と例については、以下の 「キー値ターゲット 」を参照してください。
ad_slot_position_action_include ブール型 広告ポッド内の特定のスロットをターゲットにする意図。 広告スロットまたは広告バンパーをターゲットにすることはできますが、両方をターゲットにすることはできません。
既定値:false
ad_slot_position_targets 整数の配列 購入者がサービスを提供したい広告スロットの位置。 -1 は最後の位置を表し、 0 は最初の位置を表します。 既定では、 ad_slot_position_action_include が false に設定されている場合、空の配列は、任意の位置で支出が発生する可能性があることを意味します。 ad_slot_position_targets を使用してターゲット位置を指定する場合は、最初に ad_slot_position_action_include を true に設定します。
既定値:empty row
ad_slot_intro_bumper_action_include ブール型 この設定は、クリエイティブが VAST 動画オークションの動画イントロ位置をターゲットにするかどうかを制御します。 既定値は true です。 クリエイティブがイントロ adpod の位置をターゲットとしないようにするには、このフィールドを false に設定します。

メモ: 広告スロットまたは広告バンパーをターゲットにすることはできますが、両方をターゲットにすることはできません。

既定値:true
ad_slot_outro_bumper_action_include ブール型 この設定は、クリエイティブが VAST 動画オークションのアウトロ位置をターゲットにするかどうかを制御します。 既定値は true です。 クリエイティブがアウトロ adpod の位置をターゲットとしないようにするには、このフィールドを false に設定します。

メモ: 広告スロットまたは広告バンパーをターゲットにすることはできますが、両方をターゲットにすることはできません。

既定値:true
screen_size_action string 非推奨です。
既定値:exclude
screen_size_targets オブジェクトの配列 非推奨です。
optimization_zone_action string 現在サポートされていません。
既定値:exclude
optimization_zone_targets オブジェクトの配列 現在サポートされていません。
created_on timestamp 読み取り専用です。 プロファイルが作成された日時。
is_expired ブール型 読み取り専用です。 trueの場合、プロファイルに関連付けられているオブジェクトの有効期限が切れています。 このパラメーターは、内部目的でのみサポートされます。
既定値:false
inventory_network_resold_targets オブジェクトの配列 非推奨です。
exelate_targets オブジェクトの配列 非推奨です。
inventory_url_allowlist_settings object このオブジェクトには、品目の購入に許可リストを適用する方法を決定するために使用されるフィールドが含まれています。 Curate内のユーザーは、オープンエクスチェンジ & セラー取引が供給戦略として選択されている場合、セラー取引に対する許可リストが有効になっていないことを確認し、オープンエクスチェンジに許可リストが具体的に適用されるようにすることができます。 イン ベントリ URL の許可リストの設定を参照してください。
ads_txt_authorized_only ブール型 trueする場合、この広告申込情報は、ads.txt ファイルを持つドメインの認定販売者の Web インベントリのみをターゲットにします。

メモ:ads_txt_authorized_only ターゲティング パラメーターは、Open Exchange インベントリにのみ適用されます。 取引インベントリのターゲット設定には影響しません。 また、アプリ インベントリにも適用されません (アプリ インベントリに ads.txt ファイルの使用はまだ業界で採用されていないため)。 詳細については、 購入者向けの FAQAds.txt を参照してください。
既定値:false
political_district_targets オブジェクトの配列 対象とする政治選挙区 ID。
例を参照してください。
ID は、 選挙区サービスを使用して取得できます。
ad_type_targets 配列 さまざまなメディアの種類を表す ID を含むオブジェクトの配列。 以下の例の構造体を参照してください。
1 = バナー
2 = ビデオ
3 = ネイティブ
4 = オーディオ

dma_targets 例文

{
   "dma_targets":[
      {
         "dma":612
      },
      {
         "dma":622
      }
   ]
}

domain_targets 例文

{
   "domain_targets":[
      {
         "profile_id":128350561,
         "domain":"telenet.be"
      },
      {
         "profile_id":99898705,
         "domain":"cnn.us"
      }
   ]
}

size_targets 例文

{
   "size_targets":[
      {
         "width":190,
         "height":213
      },
      {
         "width":728,
         "height":90
      }
   ]
}

seller_member_group_targets format

{
   "seller_member_group_targets":[
      {
         "id":1,
         "action_include":"true/false"
      }
   ]
}

deal_list_targets 例文

{
   "profile":{
      "id":1367515,
      "deal_list_targets":[
         {
            "id":"0101"
         },
         {
            "id":"0102"
         }
      ]
   }
}

intended_audience_targets 例文

{
   "intended_audience_targets":[
      "children",
      "general"
   ]
}

postal_code_targets 例文

{
   "profile":{
      "id":1367515,
      "postal_code_targets":[
         {
            "id":"00135"
         },
         {
            "id":"00136"
         }
      ]
   }
}

postal_code_list_targets 例文

{
   "profile":{
      "id":1367515,
      "postal_code_list_targets":[
         {
            "id":"0099"
         },
         {
            "id":"0100"
         }
      ]
   }
}

political_district_targets 例文

{
   "profile":{
      "id":130465799,
      "political_district_targets":[
         {
            "id":"139897"
         }
      ]
   }
}

ad_type_targets 例文

{
    "profile": {
        "ad_type_targets": [
            {
                "id": 1
            },
            {
                "id": 2
            }
        ]
    }
}

deal_action_include フィールドと deal_targets フィールドのターゲティング結果

ターゲット設定の結果は、 deal_action_include フィールドと deal_targets フィールドのこれらの値に対して行われます。

deal_action_include deal_targets ターゲティングの結果
true null ターゲットの取引なし
false null すべての取引をターゲットにする
true 取引ターゲットを含みます ターゲティングにこれらの取引を含める
false 取引ターゲットを含みます ターゲティングでこれらの取引を除外する

モバイル アプリ インスタンス ターゲット

プロファイルへの追加手順など、モバイル アプリ インスタンスの詳細については、「 モバイル アプリ インスタンス サービス」を参照してください。

フィールド 種類 説明
id int モバイル アプリ インスタンスの一意の ID。
bundle_id string このモバイル アプリ インスタンスのバンドル ID。
os_family_id int このモバイル アプリ インスタンスに関連付けられている OS ファミリ ID。

モバイル アプリ インスタンス リスト ターゲット

プロファイルへの追加手順など、モバイル アプリ インスタンス リストの詳細については、 モバイル アプリ インスタンス リスト サービスを参照してください。

フィールド 種類 説明
id int モバイル アプリ インスタンス リストの一意の ID。
name string このモバイル アプリ インスタンス リストの名前。
description string リストの目的または内容のオプションの説明。

デイパート ターゲット

daypart_targets 配列の各オブジェクトには、次のフィールドが含まれます。 書式設定については、以下の プロフィールの表示 の例を参照してください。

フィールド 種類 説明
day 列挙 曜日。
可能な値: sunday、 monday、 tuesday、 wednesday、 thursday、 friday、 saturday、または all。

メモ: これらの文字列は小文字にする必要があります。
start_hour int 日割りの開始時間。 これは 0 から 23 までの整数にする必要があります。 キャンペーンは、1 時間の初めに配信を開始します (6 は午前 "6:00" に相当します)。
end_hour int デイパートの終了時間。 これは 0 から 23 までの整数にする必要があります。 キャンペーンは 1 時間の終わりにサービスを停止します (23 は "23:59" に相当します)。

セグメント ターゲット

配列外のフィールドを使用してセグメント間のブール論理 segment_boolean_operator 定義します。 segment_boolean_operatorがANDの場合、プロファイルは、すべてのセグメント ターゲットを満たすユーザーのみをターゲットとします。 segment_boolean_operatorがORの場合、プロファイルは、指定されたセグメントのいずれかを満たすユーザーをターゲットにします。 セグメントターゲティングのブール論理の詳細については、「 セグメントターゲティング」を参照してください。

フィールド 種類 説明
id int セグメントの ID。
必須:POST
code string セグメントのカスタム コード。
action 列挙 使用可能な値: include または exclude。
既定値:include
start_minutes int ユーザーがセグメントに追加されてからの時間の下限。
既定値:0
expire_minutes int ユーザーがセグメントに追加されてからの時間の上限。
既定値:-1
other_equals int ターゲットとする正確なセグメント値。

メモ:other_in_list を使用する場合、このフィールドは使用できません。
既定値:null
other_less int セグメント値ターゲティングの非包括的上限。
既定値:null
other_greater int セグメント値ターゲティングの非包括的下限。
既定値:null
other_in_list 配列 ターゲットとするセグメント値のリスト。 other_equals を使用する場合、このフィールドは使用できません。
既定値:null

注:

other_equals、other_less、other_greater、other_in_list の場合、セグメント値は、セグメント ピクセルによって渡される "その他" の値にすることも、セグメント クエリ文字列値に関連付けることもできます (セグメント サービスの"querystring_mapped" フィールドを参照)。 セグメント内のクエリ文字列値をターゲットにする方法の例については、以下の他の例を参照してください。

セグメントのターゲティングでは、ブール値ロジックの設定を一貫性のある状態に保つ必要があります。そうしないと、Microsoft Invest UI でセグメントを編集できません。 一貫性のあるブール ロジック設定を行うには、次のことを確認する必要があります。

  • segment_boolean_operator フィールドは "and" または "or" として設定されます。
  • segment_group_targets配列の各オブジェクトの boolean_operator フィールド(セグメントグループターゲットを参照)は、「and」または「or」のいずれかに設定されます。 ただし、この値は上記の segment_boolean_operator で設定されている値とは逆にする必要があります。 たとえば、segment_boolean_operator に設定した値が "or" の場合、オブジェクトの boolean_operator の値は "and" になります。
  • segment_group_targets 配列のすべてのオブジェクトのフィールド boolean_operator 値が同じである必要があります。 つまり、同じプロファイルで、1 つのオブジェクトを "and" としてboolean_operatorし、もう 1 つのオブジェクトを "or" として持つことはできません。 一貫性のある JSON と一貫性のない JSON の例については、以下を参照してください。

一貫性のある JSON

{
   "segment_boolean_operator":"and",
   "segment_group_targets":[
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"1094797",
               "deleted":false,
               "expire_minutes":null,
               "id":19285936,
               "name":"Travel Intender",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3119772",
               "deleted":false,
               "expire_minutes":null,
               "id":19378950,
               "name":"XAS - US HH Demographic - Online Shopping - Travel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"6502105",
               "deleted":false,
               "expire_minutes":null,
               "id":19378951,
               "name":"XAS - US HH Demographic - Online Shopping - Electronics and Gadgets",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3734388",
               "deleted":false,
               "expire_minutes":null,
               "id":19378952,
               "name":"XAS - US HH Demographic - Online Shopping - Apparel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"2137013",
               "deleted":false,
               "expire_minutes":null,
               "id":19378954,
               "name":"XAS - US HH Demographic - Online Shopping - Buy Online",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2272811",
               "deleted":false,
               "expire_minutes":null,
               "id":19378955,
               "name":"XAS - US HH Demographic - Online Shopping - Personal Health",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"4608982",
               "deleted":false,
               "expire_minutes":null,
               "id":21015599,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Attorneys",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2420395",
               "deleted":false,
               "expire_minutes":null,
               "id":21015602,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Accountants/CPA",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      }
   ]
}

一貫性のない JSON

{
   "segment_boolean_operator":"and",
   "segment_group_targets":[
      {
         "boolean_operator":[
            "and",
            "- - same as segment_boolean_operator + also all other boolean_operators in the rest of the object is set to",
            "or",
            "therefore this is inconsistent behavior"
         ],
         "segments":[
            {
               "action":"include",
               "code":"1094797",
               "deleted":false,
               "expire_minutes":null,
               "id":19285936,
               "name":"Travel Intender",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3119772",
               "deleted":false,
               "expire_minutes":null,
               "id":19378950,
               "name":"XAS - US HH Demographic - Online Shopping - Travel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"6502105",
               "deleted":false,
               "expire_minutes":null,
               "id":19378951,
               "name":"XAS - US HH Demographic - Online Shopping - Electronics and Gadgets",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3734388",
               "deleted":false,
               "expire_minutes":null,
               "id":19378952,
               "name":"XAS - US HH Demographic - Online Shopping - Apparel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"2137013",
               "deleted":false,
               "expire_minutes":null,
               "id":19378954,
               "name":"XAS - US HH Demographic - Online Shopping - Buy Online",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2272811",
               "deleted":false,
               "expire_minutes":null,
               "id":19378955,
               "name":"XAS - US HH Demographic - Online Shopping - Personal Health",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"4608982",
               "deleted":false,
               "expire_minutes":null,
               "id":21015599,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Attorneys",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2420395",
               "deleted":false,
               "expire_minutes":null,
               "id":21015602,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Accountants/CPA",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      }
   ]
}

セグメント ターゲットの例

この例では、 segment_boolean_operator が ANDであるため、プロファイルは、セグメント 86 とセグメント 202 の両方に適合するユーザーのみをターゲットとします。

{
   "profile":{
      "segment_boolean_operator":"and",
      "segment_targets":[
         {
            "id":86,
            "code":null,
            "name":"Network segment 1",
            "action":"include",
            "start_minutes":0,
            "expire_minutes":-1,
            "other_less":null,
            "other_greater":null,
            "other_equals":null
         },
         {
            "id":202,
            "code":null,
            "name":"Credit Score segment",
            "action":"include",
            "start_minutes":0,
            "expire_minutes":-1,
            "other_less":null,
            "other_greater":null,
            "other_equals":null
         }
      ]
   }
}

セグメント グループ ターゲット

各セグメント グループ オブジェクトには、次のフィールドが含まれています。

注:

配列外の segment_boolean_operator フィールドを使用してグループ間のブール論理を定義し、グループ オブジェクト内の boolean_operator フィールドを使用してグループ内のセグメント間のブール論理を定義します。 書式設定と、 segment_boolean_operator と boolean_operatorの組み合わせのロジックの例については、次の例を参照してください。 セグメントターゲティングのブール論理の詳細については、「 セグメントターゲティング」を参照してください。

Null セグメントを追加することはできません。

POST または PUT を使用して、この配列にnullセグメントを追加することはできません。

フィールド 種類 説明
boolean_operator 列挙 セグメント グループ内のセグメント間のブール論理。 使用可能な値: and または or。
segment_group_targets 配列のすべてのオブジェクトのフィールドboolean_operator値が同じである必要があります。
つまり、1つのオブジェクトを"and"としてboolean_operatorし、別のオブジェクトを"or"として同じプロファイルにすることはできません。
既定値:or
必須:POST
id int セグメントの ID。
必須:POST
code string セグメントのカスタム コード。
action 列挙 使用可能な値: include または exclude。
既定値:include
start_minutes int ユーザーがセグメントに追加されてからの時間の下限。
既定値:0
expire_minutes int ユーザーがセグメントに追加されてからの時間の上限。
既定値:-1
other_equals string ターゲットとする正確なセグメント値。

メモ:other_in_list を使用する場合、このフィールドは使用できません。
既定値:null
other_less int セグメント値ターゲティングの非包括的上限。
既定値:null
other_greater int セグメント値ターゲティングの非包括的下限。
既定値:null
other_in_list 配列 ターゲットとするセグメント値のリスト。

メモ:other_equals を使用する場合、このフィールドは使用できません。
既定値:null

注:

other_equals、other_less、other_greater、other_in_list の場合、セグメント値は、セグメント ピクセルによって渡される"other"値にすることも、セグメント クエリ文字列値に関連付けることもできます (セグメント サービスの"querystring_mapped" フィールドを参照)。 セグメント内のクエリ文字列値をターゲットにする方法の例については、以下の他の例を参照してください。

セグメント グループ ターゲットの例

この例では、 segment_boolean_operator は OR で、各グループの boolean_operator は AND であるため、プロファイルは、セグメント 11 とセグメント 22 の両方、またはセグメント 33 とセグメント 44 の両方に適合するユーザーのみを対象とします。

{
   "profile":{
      "segment_boolean_operator":"or",
      "segment_group_targets":[
         {
            "boolean_operator":"and",
            "segments":[
               {
                  "id":11,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               },
               {
                  "id":22,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               }
            ]
         },
         {
            "boolean_operator":"and",
            "segments":[
               {
                  "id":33,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               },
               {
                  "id":44,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               }
            ]
         }
      ]
   }
}

年齢ターゲット

フィールド 種類 説明
allow_unknown ブール型 年齢が不明なターゲットを含めるかどうかを決定します。
既定値:false
ages オブジェクトの配列 このプロファイルの対象となる年齢層。

ages オブジェクト

フィールド 種類 説明
low int 年齢範囲の下限 (最小 13)。
high int 年齢範囲の上限 (最大 100)。

年齢ターゲットの例

{
   "profile":{
      "age_targets":{
         "allow_unknown":false,
         "ages":[
            {
               "low":20,
               "high":35
            }
         ]
      }
   }
}

性別ターゲット

gender_targets オブジェクトには以下のフィールドがあります。

フィールド 種類 説明
gender 列挙 ユーザーの性別。 使用可能な値: m (男性)、または f (女性)。
既定値:null
必須:POST
allow_unknown ブール型 trueの場合は、ユーザーの性別がわからない広告呼び出しをターゲットにします。
既定値:false

国のターゲット

country_targets 配列の各オブジェクトには、次のフィールドが含まれています。

フィールド 種類 説明
id int 国の ID。 Country Service を使用すると、国 ID の完全な一覧を取得できます。
name string 読み取り専用です。 国名。
code string 読み取り専用です。 国のコード。

国ターゲットの例

{
   "profile":{
      "country_action":"include",
      "country_targets":[
         {
            "id":233,
            "name":"United States",
            "code":"US"
         }
      ]
   }
}

リージョン ターゲット

region_targets 配列の各オブジェクトには、次のフィールドが含まれています。

フィールド 種類 説明
id int リージョンの ID。 リージョン サービスを使用して、リージョン ID の一覧を取得できます。
name string 読み取り専用です。 リージョンの名前。
code string 読み取り専用です。 リージョンのコード。
country_name string 読み取り専用です。 地域が属する国の名前。
country_code string 読み取り専用です。 地域が属する国のコード。

リージョン ターゲットの例

{
   "profile":{
      "region_action":"include",
      "region_targets":[
         {
            "id":3950,
            "name":"New York",
            "code":"NY",
            "country_name":"United States",
            "country_code":"US"
         }
      ]
   }
}
フィールド 種類 説明
require_transparency_and_consent_framework_string ブール値 - trueの場合、有効な TCF 文字列が存在する場合にのみ、関連付けられたオブジェクトがインベントリを購入できるようにします
- false場合は、関連付けられたオブジェクトが、事前定義されたターゲティング宣言に含まれるインベントリを購入できるようにします。

注:

このパラメーターは、GDPR が適用される地域から送信されるトラフィックにのみ適用されます。

例

{
   "profile":{
      "require_transparency_and_consent_framework_string":"false"
   }
}

都市ターゲット

city_targets 配列の各オブジェクトには、次のフィールドが含まれています。

フィールド 種類 説明
id int ターゲットとする都市の ID。 City Service を使用して、都市 ID のリストを取得できます。
name int 読み取り専用です。 ターゲットとする都市の名前。
region_name string 読み取り専用です。 市が属する地域の名前。
region_code string 読み取り専用です。 その都市が属する地域のコード。
country_name 列挙 読み取り専用です。 地域が属する国の名前。
country_code 列挙 読み取り専用です。 地域が属する国のコード。

都市ターゲットの例

{
   "profile":{
      "city_action":"include",
      "city_targets":[
         {
            "id":200942,
            "name":"Portland",
            "region_name":"Oregon",
            "region_code":"OR",
            "country_code":"US",
            "country_name":"United States"
         }
      ]
   }
}

インベントリ リスト

inventory_url_list_targets 配列の各オブジェクトには、次のフィールドが含まれます。

フィールド 種類 説明
deleted Boolean 読み取り専用です。 インベントリ リストが削除されたかどうかを示します。
id int 適用する許可リストまたはブロックリストの ID。
- 許可リストには、プロファイルを使用する明細行項目の対象となるドメインとアプリのリストが含まれています。
- 各ブロックリストには、プロファイルを使用するラインアイテムによるターゲティングから除外するドメインとアプリのリストが含まれています。
必須:POST、 PUT
list_type string 読み取り専用です。 リストがブロックリストか許可リストかを示します。 有効な値は allowlist または blocklist です。

メモ:インベントリ リスト サービスによって使用されるlist_typeフィールドは、インベントリ リストがターゲティングに含まれない (blocklist) か含まれる (allowlist) かどうかを判断するためにプロファイル サービスによって使用されません。 ターゲティングでインベントリ リストを除外または含める方法については、この表 exclude フィールドを参照してください。
name string 読み取り専用です。 許可リストまたはブロック リストの名前。
exclude ブール型 読み取り専用です。 true場合、インベントリ リストはターゲットから除外されます (つまり、ブロックリストとして扱われます)。 false場合、インベントリ リストはターゲティングに含まれます (つまり、許可リストとして扱われます)。 このフィールドは、上記の [インベントリ list_type ] フィールドにのみ依存します。

インベントリ リストの例

{
   "profile":{
      "id":145,
      "inventory_url_list_targets":[
         {
            "deleted":false,
            "id":51,
            "list_type":"blocklist",
            "name":"Blocklist to exclude medical sites",
            "exclude":true
         },
         {
            "deleted":false,
            "id":53,
            "list_type":"blocklist",
            "name":"Blocklist to exclude military sites",
            "exclude":true
         },
         {
            "deleted":false,
            "id":54,
            "list_type":"blocklist",
            "name":"Line Item - Blocklist - 2017-08-23T21:44:42Z",
            "exclude":true
         },
         {
            "deleted":false,
            "id":66,
            "list_type":"allowlist",
            "name":"Test Allowlist for Targeting",
            "exclude":false
         }
      ]
   }
}

コンテンツ カテゴリ ターゲット

content_category_targets オブジェクトには、ブール値である allow_unknown フィールドと content_category 配列が含まれます。 content_category 配列の各オブジェクトには、次のフィールドが含まれています。

フィールド 種類 説明
id int 対象とするコンテンツ カテゴリの ID。
既定値:null
必須:POST
action num このコンテンツ カテゴリに対して実行するアクション。
使用可能な値: include または exclude。
includeの場合、カテゴリがターゲットに設定されます。exclude場合、カテゴリは明示的にターゲットされません。
既定値:exclude

コンテンツ カテゴリ ターゲットの例

{
   "profile":{
      "content_category_targets":{
         "allow_unknown":false,
         "content_categories":[
            {
               "id":3,
               "action":"include"
            }
         ]
      }
   }
}

ビデオ ターゲット

video_targets オブジェクトには、allow_unknown_playback_method、allow_unknown_context、allow_unknown_player_size フィールドと playback_methods、contexts、player_sizes 配列が含まれます。 取引の場合、 deal_creative_duration フィールドと video_frameworks 配列も含まれます。

フィールド 種類 説明
allow_unknown_playback_method ブール型 再生方法が不明なインベントリをターゲットにするには、このフィールドを使用します。 playback_method 配列のフィールドを使用して特定の再生方法をターゲットにする場合、および再生方法情報が指定されていないインベントリを含める場合は、このフィールドを true に設定します。
特定の再生方法をターゲットにしていない場合、このフィールドはターゲット設定に影響しません。
既定値:false
allow_unknown_context ブール型 コンテキストが不明なインベントリをターゲットにするには、このフィールドを使用します。 contexts 配列のフィールドを使用して特定のコンテキストをターゲットにする場合、およびコンテキスト情報が指定されていないインベントリを含める場合は、このフィールドを true に設定します。
特定のコンテキストをターゲットにしていない場合、このフィールドはターゲティングに影響しません。
既定値:false
allow_unknown_player_size ブール型 このフィールドは、プレイヤー サイズが不明なインベントリをターゲットにするために使用します。 player_sizes 配列のフィールドを使用して特定のプレイヤー サイズをターゲットにする場合や、プレイヤー サイズ情報が指定されていないインベントリを含める場合は、このフィールドを true に設定します。
特定のプレイヤー サイズをターゲットにしていない場合、このフィールドはターゲット設定に影響しません。
既定値:false

注:

  • 特定の動画ターゲティング オプションを設定しない場合は、未定義のインベントリを含むすべてのインベントリがターゲットになります。
  • イントロとアウトロのクリエイティブを [ ad_slot_intro_bumper_action_include ] フィールドと [ ad_slot_outro_bumper_action_include ] フィールドに設定して、それらを含めるか除外するかを選択していることを確認します。

コンテキスト

既定値は空の配列であり、任意のロール位置を対象とします。 contexts 配列には、次のフィールドを持つオブジェクトが含まれています。

フィールド 種類 説明
id int コンテキストの ID。 使用可能な値:
- 1: position-pre-roll
- 2: position-mid-roll
- 3: position-post-roll
- 4: 記事内
- 5: バナー内
- 6: インフィード
- 7: インタースティシャル
- 8: accompanying-content-pre-roll
- 9: accompanying-content-mid-roll
- 10: accompanying-content-post-roll
name string 読み取り専用です。 指定可能な値: pre-roll、 mid-roll、 post-roll、または in-article。

再生方法

既定値は空の配列で、任意の再生メソッドを対象とします。 playback_methods 配列には以下のフィールドが含まれています。

フィールド 種類 説明
id int 再生メソッドの ID。 使用可能な値:
- 1: playback-method-auto-play-sound-on
- 2: playback-method-auto-play-sound-off
- 3: playback-method-click-to-play
- 4: playback-method-mouse-over
- 5: playback-method-auto-play-sound-unknown
name string 読み取り専用です。 使用可能な値: auto_play_sound_on、 auto_play_sound_off、 click_to_play、 mouse_over、または auto_play_sound_unknown。

プレイヤーのサイズ

既定値は空の配列で、任意のプレイヤー サイズを対象とします。 player_sizes 配列には、次のフィールドを持つオブジェクトが含まれています。

フィールド 種類 説明
id int プレイヤーのサイズの ID。 使用可能な値:
- 1: player-size-sm
- 2: player-size-med
- 3: player-size-lg
name string 読み取り専用です。 指定可能な値: small、 medium、または large。
min_width int 読み取り専用です。 プレイヤーの最小幅 (ピクセル単位)。
max_width int 読み取り専用です。 プレイヤーの最大幅 (ピクセル単位)。

クリエイティブ期間

deal_creative_duration設定は、動画取引品目でのみ使用されます。 これにより、取引は、少なくとも特定のクリエイティブ期間を許可するインプレッションをターゲットにできるため、定義された長さのクリエイティブがエラーなく取引を通じて正常に配信できます。 指定の設定が既に設定されているインプレッションのみが集計されます。

フィールド 種類 説明
deal_creative_duration int ビデオ クリエイティブの長さ (秒単位)。

ビデオ フレームワーク

video_frameworks 配列は、ビデオ取引品目でのみ使用されます。 これにより、特定の動画フレームワーク (VPAID など) が許可されているインプレッションをターゲットとする取引が可能になり、この種類のクリエイティブはエラーなく取引を通じてサービスを提供できます。 この設定によって、既存の配置設定は上書きされません。指定の設定が既に設定されているインプレッションのみが集計されます。

フィールド 種類 説明
id int ビデオ フレームワークの ID。 ID には、次のものが含まれます。
- VPAID 1.0
- VPAID 2.0
- MRAID-1
- ORMMA
- MRAID-2
name string ビデオ フレームワークの名前。
使用可能な値:
- vpaid_1_0
- vpaid_2_0
- mraid_1
- ormma
- mraid_2

ビデオ フレームワークの例

{
   "profile":{
      "video_targets":{
         "allow_unknown_playback_method":true,
         "allow_unknown_context":true,
         "allow_unknown_player_size":true,
         "contexts":[
            {
               "id":1,
               "name":"pre-roll"
            },
            {
               "id":2,
               "name":"mid-roll"
            },
            {
               "id":4,
               "name":"in-article"
            }
         ],
         "playback_methods":[
            {
               "id":2,
               "name":"auto_play_sound_off"
            },
            {
               "id":3,
               "name":"click_to_play"
            }
         ],
         "player_sizes":[
            {
               "id":1,
               "name":"small",
               "min_width":0,
               "max_width":300
            }
         ],
         "deal_creative_duration":60,
         "video_frameworks":[
            {
               "id":1,
               "name":"vpaid_1_0"
            },
            {
               "id":2,
               "name":"vpaid_2_0"
            }
         ]
      }
   }
}

エンゲージメント率目標

オブジェクトの engagement_rate_targets 配列は、過去のパフォーマンスに基づいて特定の高パフォーマンス インベントリを対象とするために使用されます。 ターゲティング条件を活用すると、希望する視聴完了率または視聴可能性率を指定することで、視聴完了率の高い動画インベントリと視認性の高いインベントリのどちらかを購入できます。

フィールド 種類 説明
engagement_rate_type 列挙 ターゲティング条件。
使用可能な値:
- 1: video_completion - 動画の視聴完了率。 動画のインプレッションが完全に再生される可能性 (動画の完了数/総インプレッション数) の予測。
- 2: view - 予測 IAB ビューアビリティ率(以前は「推定 IAB ビュースルー率」と呼ばれていました)。 IAB 標準によって判断される、Web ディスプレイのインプレッションが表示可能になる可能性 (閲覧/測定されたインプレッション) の予測。
- 3: view_over_total - 合計に対する予測 IAB ビューアビリティ率。 IAB 標準によって判断される、Web ディスプレイのインプレッションが表示可能になる可能性 (閲覧/総インプレッション数) の予測。
- 4: predicted_iab_video_view_rate - 予測されるIAB動画の視認性率。 IAB 標準によって判断される、Web ビデオのインプレッションが視聴可能になる可能性 (視聴/測定されたインプレッション) の予測。
- 5: predicted_iab_video_view_rate_over_total - 予測されるIAB動画の視認性率 IAB標準によって判断された、Web動画のインプレッションが視聴可能になる可能性(視聴/総インプレッション数)の予測。
- 6: predicted_100pv50pd_video_view_rate - 予測される動画の視聴率 (視聴 100%、持続時間 50%、サウンドオン)。 このカスタム基準 (視認可能 100%、再生時間 50%、サウンド オン) によって判断される、Web ビデオのインプレッションが視聴可能になる可能性の予測 (視聴/測定されたインプレッション)。
- 7: predicted_100pv50pd_video_view_rate_over_total - 合計に対する予測動画の視聴率 (視聴 100%、再生時間 50%、サウンドオン)。 このカスタム基準 (視聴可能 100%、長さ 50%、サウンドオン) によって判断される、Web 動画のインプレッションが視聴可能になる可能性の予測 (視聴/総インプレッション数)。
- 8: predicted_100pv1s_display_view_rate - 予測される視認性率 (100% 視聴)。 このカスタム基準 (100% 視認可能、1 秒) によって判断される、Web ディスプレイのインプレッションが視認可能である可能性の予測 (閲覧/測定されたインプレッション)。
- 9: predicted_100pv1s_display_view_rate_over_total - 合計に対する予測ビューアビリティ率(100%ビュー)。 このカスタム基準 (100% 視認可能、1 秒) によって判断される、Web ディスプレイのインプレッションが視認可能である可能性の予測 (閲覧/総インプレッション数)。
engagement_rate_pct int 使用可能な値は 1 - 100 です。

取引ターゲット

deal_targets 配列の各オブジェクトには、次のフィールドが含まれています。

注:

取引をターゲットまたは除外するには、必要に応じてこの配列内のフィールドを設定するだけでなく、次の操作も行う必要があります:

  • [ deal_action_include ] フィールドを [ true ] または [ false ] に設定します (包含または除外に応じて)。
  • ALI を使用する場合は、deals フィールドを Line Item Service のsupply_strategies配列内にtrueするように設定します。
  • プログラマティック保証購入ライン項目の deal_targets 配列内の取引ターゲットは 1 つのみです。
フィールド 種類 説明
id int 取引の ID。 取引の ID を取得するには、 Deal Buyer Access Service を使用します。
name string 読み取り専用です。 取引の名前。
code string 読み取り専用です。 取引のカスタム コード。 外部供給パートナーとの取引の場合、これは通常、取引を識別するために使用する文字列です。

取引ターゲットの例

{
   "profile":{
      "deal_targets":[
         {
            "id":44,
            "name":"Deal with external supply partner",
            "code":"APN-1234-2200f"
         },
         {
            "id":45,
            "name":"Deal with UI seller",
            "code":null
         }
      ]
   }
}

位置ターゲット

position_targets オブジェクトには以下のフィールドがあります。

フィールド 種類 説明
allow_unknown ブール型 trueの場合、プロファイルはフォールド位置が不明な配置をターゲットにします。
既定値:false
positions オブジェクトの配列 ターゲットとする折りたたみ位置。 使用可能な値: "above" または "below"。

ポジション ターゲットの例

{
   "profile":{
      "position_targets":{
         "allow_unknown":false,
         "positions":[
            {
               "position":"above"
            }
         ]
      }
   }
}

デバイス モデル ターゲット

device_model_targets 配列の各オブジェクトには、次のフィールドが含まれています。

ヒント

当社システムに登録されているデバイスモデルのIDを取得するには、 デバイスモデルサービスをご利用ください。

フィールド 種類 説明
id int デバイス モデルの ID。
name string 読み取り専用です。 デバイス モデルの名前 ( Onetab XST2、 PAD7、 A101 など)。

デバイス モデル ターゲットの例

{
   "profile":{
      "device_model_action":"include",
      "device_model_targets":[
         {
            "id":1,
            "name":"Onetab XST2"
         },
         {
            "id":2,
            "name":"PAD7"
         },
         {
            "id":3,
            "name":"A101"
         }
      ]
   }
}

デバイスの種類ターゲット

device_type_targets 配列には、次の文字列を 1 つ以上含めることができます。

  • phone
  • tablet
  • pc
  • tv
  • gameconsole
  • stb
  • mediaplayer

デバイスの種類ターゲットの例

{
   "profile":{
      "device_type_action":"include",
      "device_type_targets":[
         "phone",
         "tablet"
      ]
   }
}

通信事業者ターゲット

carrier_targets 配列の各オブジェクトには、次のフィールドが含まれています。

注:

  • 当社システムに登録されている携帯電話会社のIDを取得するには、 キャリアサービスをご利用ください。

  • 通信事業者によるターゲット機能とは、その通信事業者のネットワークを現在使用しているデバイスをターゲットにできるという事実を指します。 ネットワークのサブスクライバーをターゲットにすることはできません。

    たとえば、4G ネットワークを使用している Verizon iPhone は、4G 接続時は Verizon としてターゲットにすることができますが、ユーザーが自宅の Wi-Fi に接続している場合はターゲットにはなりません。

フィールド 種類 説明
id int 携帯電話会社の ID。
name string 読み取り専用です。 携帯電話会社の名前。
country 列挙 読み取り専用です。 運送業者が運航する国の ISO コード。

通信事業者ターゲットの例

{
   "profile":{
      "carrier_action":"include",
      "carrier_targets":[
         {
            "id":14,
            "name":"Verizon - US",
            "country":"US"
         },
         {
            "id":26,
            "name":"Sprint - US",
            "country":"US"
         },
         {
            "id":32,
            "name":"Orange - US",
            "country":"US"
         }
      ]
   }
}

IP 範囲リストのターゲット

IP 範囲リストの詳細については、 IP 範囲リスト サービスを参照してください。

プロファイルごとに、最大 10 個の "include" IP 範囲リスト (include IP 範囲リストで true に設定されている) と、1 個以下の "exclude" IP 範囲リスト (include IP 範囲リストで false に設定されている) をターゲットにすることができます。 除外される IP 範囲は、含まれる IP 範囲のサブセットである必要があります。

フィールド 種類 説明
id int この IP 範囲リストの一意の ID。
name string 読み取り専用です。 この IP 範囲リストの名前。
include ブール型 読み取り専用です。 IP 範囲の一覧に IP 範囲を含めるか除外するか。 これは、プロファイルではなく、IP 範囲リスト自体で定義されます
description string 読み取り専用です。 リストの目的または内容のオプションの説明。

オペレーティング システムの拡張ターゲット

operating_system_extended_targets 配列は、ターゲティングに含める、またはターゲティングから除外するオペレーティング システムのバージョン (Android 3.x、Apple iOS 6 など) を指定します。

注:

operating_system_extended_targets 配列は特定のオペレーティング システム バージョンをターゲットにするために使用されますが、 operating_system_family_targets はオペレーティング システムのすべてのバージョンをターゲットにするために使用されます。

  • OS ファミリ ターゲットと OS 拡張ターゲットは連携

    OS ファミリと OS 拡張ターゲットは、一緒に使用すると最も効果的です。 これらの組み合わせたターゲット設定機能の使用例については、以下の「 OS ファミリ ターゲットと OS 拡張ターゲットを一緒に使用する 」の例を参照してください。

  • operating_system_extended_targetsを使用するには、use_operating_system_extended_targeting を true に設定する必要があります。 operating_system_extended_targetsを使用してプロファイルが作成されると、PUT のoperating_system_targetsフィールドをfalseまたは設定するようにuse_operating_system_extended_targetingを設定することはできません。

operating_system_extended_targets 配列の各オブジェクトには、次のフィールドが含まれています。

フィールド 種類 説明
id int オペレーティング システム バージョンの ID。 システムに登録されているオペレーティング システム バージョンの ID を取得するには、 オペレーティング システム拡張サービスを使用してください。
name string 読み取り専用です。 オペレーティング システムのバージョン名 ( Android 3.x、 Apple iOS 5 など)。
action 列挙 idで実行するアクション。
使用可能な値: include または exclude。

オペレーティング システム拡張ターゲットの例

{
   "profile":{
      "use_operating_system_extended_targeting":true,
      "operating_system_extended_targets":[
         {
            "id":2,
            "name":"Android 2.1",
            "action":"exclude"
         },
         {
            "id":3,
            "name":"Android 2.2",
            "action":"include"
         }
      ]
   }
}

オペレーティング システム ファミリのターゲット

operating_system_family_targets 配列は、operating_system_family_action フィールドで定義されているように、ターゲティングに含める、またはターゲティングから除外するオペレーティング システム全体 (Android、Apple iOS、Windows 7、Windows 11 など) を指定します。

注:

operating_system_family_action フィールドはオペレーティング システムのすべてのバージョンをターゲットにするために使用されますが、 operating_system_targets はオペレーティング システムの特定のバージョンをターゲットにするために使用されます。

OS ファミリ ターゲットと OS 拡張ターゲットは連携して動作します

OS ファミリと OS 拡張ターゲットは、一緒に使用すると最も効果的です。 これらの組み合わせたターゲット設定機能の使用例については、以下の「 OS ファミリ ターゲットと OS 拡張ターゲットを一緒に使用する 」の例を参照してください。

operating_system_family_targets 配列の各オブジェクトには、次のフィールドが含まれています。

フィールド 種類 説明
id int オペレーティング システム ファミリの ID。 システムに登録されているオペレーティング システム ファミリの ID を取得するには、 オペレーティング システム ファミリ サービスを使用します。
name string 読み取り専用です。 オペレーティング システム ファミリの名前 ( Microsoft Windows、 Android、 Apple iOS など)。

オペレーティング システム ファミリ ターゲットの例

{
   "profile":{
      "operating_system_family_action":"exclude",
      "operating_system_family_targets":[
         {
            "id":2,
            "name":"Android"
         },
         {
            "id":3,
            "name":"Apple iOS"
         }
      ]
   }
}

キー値ターゲット

key_value_targets フィールドは、このプロファイルの対象となるカスタム キーと値の組み合わせを定義します。 フィールドは論理式の解析バージョンです。

キー値のターゲティングの仕組みと、プロファイル サービスの式を解析する方法の詳細については、「 カスタム キー値のターゲティング」を参照してください。

key_value_targets オブジェクト

フィールド 種類 説明
kv_expression object これは、 header オブジェクトと exp オブジェクトを含むすべてのキー/値ターゲット オブジェクトを含むラッパー オブジェクトです。
フィールド 種類 説明
header object 式を評価するために使用されるバージョン情報。
exp object キーと値の組み合わせを定義する正規表現。

header オブジェクト

フィールド 種類 値 説明
an_version string 1.0 式を評価するバックエンド エンジンのバージョン。
現在のバージョンは 1.0 です。 このフィールドは、 PUT と POST で必須です。
client_version string 1.0 式のクライアント向け実装のバージョン (次の例に示す形式)。 現在のバージョンは 1.0 です。 このフィールドは、 PUT と POST で必須です。

exp オブジェクト

フィールド 種類 説明
typ string 式で使用される演算子。 次の値を指定できます。
- and
- or
- not
- in
- eq (等しい)
- gt (より大きい)
- lt (より小さい)
- gte (以上)
- lte (以下)
- neq (等しくない)

演算子 and、 or、 not は、サブ式でのみ使用できます。
演算子 gt、 lt、 gte 、 lte は数値でのみ使用できます。
すべての演算子は小文字にする必要があります。
sbe exp オブジェクト サブ式 (式の要素) を含むオブジェクト。
key string ターゲティング キーの名前。
vtp type このフィールドは、式の値のデータ型を識別します。 このフィールドに入力する値は、対応する値フィールドのフィールドと型と一致する必要があります。 次の値が有効です。
- num: numeric; vnm フィールドに値を指定する必要があります。
- str: string; vst フィールドに値を指定する必要があります。
- nma: 数値配列; vna フィールドに値を指定する必要があります。
- sta: 文字列配列; vsa フィールドに値を指定する必要があります。
vnm 数値 32 ビット符号付き浮動小数点 (25.3 など) としての値。 数値は最大 13 桁で指定できます (小数点の右側には最大 6 桁)。
vst string 文字列としての値。
vna 数値の配列 浮動小数点数の配列としての値のセット。
vsa 文字列の配列 文字列の配列としての値のセット。

キー値ターゲットの例

{
   "profile":{
      "key_value_targets":{
         "kv_expression":{
            "header":{
               "an_version":"1.0",
               "client_version":"1.0"
            },
            "exp":{
               "typ":"and",
               "sbe":[
                  {
                     "exp":{
                        "typ":"eq",
                        "key":"fruit",
                        "vtp":"str",
                        "vst":"apple"
                     }
                  },
                  {
                     "exp":{
                        "typ":"eq",
                        "key":"city",
                        "vtp":"str",
                        "vst":"NY"
                     }
                  }
               ]
            }
         }
      }
   }
}

インベントリ URL の許可リストの設定

このオブジェクトのフィールドは、明細行品目に添付された許可リストを適用する方法を設定するために使用されます。 既定では、すべての許可リストが RTB 購入に適用されます。 さらに、管理された購入にも許可リストを適用することを選択できます。

フィールド 種類 説明
apply_to_managed ブール値 許可リストを Managed Buying に適用するかどうかを指定します。 true に設定すると、品目に関連付けられているすべての許可リストが Managed Buying に適用されます。

メモ:このプロファイルに関連付けられている明細行品目のinventory_typeフィールドが direct に設定されている場合は、このフィールドを true に設定します。
既定値:false
apply_to_rtb ブール値 読み取り専用です。 ライン アイテムに関連付けられているすべての許可リストが RTB 購入に適用されます。
既定値:false

インベントリ URL の許可リスト設定の例

{
   "inventory_url_allowlist_settings":{
      "apply_to_managed":true,
      "apply_to_rtb":true
   }
}

例

プロフィールを表示する

次に示すのは、プロファイル サービスの例です。

注:

例のために、このプロファイルには非現実的なターゲット戦略が含まれています。

$ curl -b cookies -c cookies 'https://api.appnexus.com/profile?id=439&advertiser_id=8&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "start_element":0,
      "num_elements":100,
      "profile":{
         "id":37291837,
         "code":null,
         "description":null,
         "country_action":"include",
         "region_action":"exclude",
         "city_action":"exclude",
         "browser_action":"exclude",
         "ads_txt_authorized_only":false,
         "use_inventory_attribute_targets":true,
         "last_modified":"2015-07-17 20:01:56",
         "daypart_timezone":null,
         "dma_action":"exclude",
         "domain_action":"exclude",
         "domain_list_action":"include",
         "inventory_action":"exclude",
         "language_action":"include",
         "segment_boolean_operator":"or",
         "min_session_imps":null,
         "session_freq_type":"platform",
         "carrier_action":"exclude",
         "supply_type_action":"exclude",
         "device_type_action":"exclude",
         "screen_size_action":"exclude",
         "device_model_action":"exclude",
         "location_target_radius":null,
         "location_target_latitude":null,
         "location_target_longitude":null,
         "querystring_action":"exclude",
         "querystring_boolean_operator":"and",
         "is_expired":false,
         "non_audited_url_action":"include",
         "daypart_bitmap":"000000000000000000000000111111111111111111111000111111111111111111111000111111111111111111111000111111111111111111111000111111111111111111111000000000000000000000000000",
         "optimization_zone_action":"exclude",
         "advertiser_id":16401,
         "publisher_id":null,
         "max_session_imps":null,
         "max_day_imps":null,
         "max_lifetime_imps":100,
         "max_page_imps":null,
         "min_minutes_per_imp":30,
         "venue_action":"exclude",
         "operating_system_action":"exclude",
         "require_cookie_for_freq_cap":true,
         "trust":"seller",
         "allow_unaudited":false,
         "is_template":false,
         "created_on":"2015-07-17 20:01:56",
         "operating_system_family_action":"exclude",
         "use_operating_system_extended_targeting":true,
         "mobile_app_instance_action_include":false,
         "mobile_app_instance_list_action_include":true,
         "user_group_targets":{
            "include_cookieless_users":false,
            "groups":[
               {
                  "low":0,
                  "high":49
               }
            ]
         },
         "country_targets":[
            {
               "id":233,
               "name":"United States",
               "code":"US"
            }
         ],
         "region_targets":[
            {
               "id":3950,
               "name":"New York",
               "code":"NY",
               "country_name":"United States",
               "country_code":"US"
            }
         ],
         "city_targets":null,
         "inv_class_targets":null,
         "inventory_attribute_targets":[
            {
               "id":2,
               "name":"Political",
               "deleted":false
            },
            {
               "id":4,
               "name":"Social media",
               "deleted":false
            },
            {
               "id":6,
               "name":"Photo and video sharing",
               "deleted":false
            },
            {
               "id":8,
               "name":"Forums (moderated)",
               "deleted":false
            },
            {
               "id":10,
               "name":"Forums (unmoderated)",
               "deleted":false
            },
            {
               "id":12,
               "name":"Incentivized clicks",
               "deleted":false
            },
            {
               "id":14,
               "name":"Non-english languages",
               "deleted":false
            },
            {
               "id":16,
               "name":"Streaming media",
               "deleted":false
            },
            {
               "id":17,
               "name":"Toolbars, plugins, or extensions",
               "deleted":false
            },
            {
               "id":29,
               "name":"Contextual Nudity",
               "deleted":false
            }
         ],
         "age_targets":{
            "allow_unknown":false,
            "ages":[
               {
                  "low":18,
                  "high":24
               },
               {
                  "low":25,
                  "high":34
               },
               {
                  "low":35,
                  "high":44
               }
            ]
         },
         "daypart_targets":[
            {
               "day":"monday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"tuesday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"wednesday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"thursday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"friday",
               "start_hour":0,
               "end_hour":20
            }
         ],
         "browser_targets":[
            {
               "id":4,
               "name":"Internet Explorer (other versions)",
               "deleted":false
            },
            {
               "id":11,
               "name":"Opera (all versions)",
               "deleted":false
            }
         ],
         "dma_targets":null,
         "domain_targets":[
            {
               "profile_id":37291837,
               "domain":"test.com"
            }
         ],
         "domain_list_targets":[
            {
               "id":3905,
               "name":"Test Domain List 1",
               "description":"",
               "type":"white",
               "deleted":false
            }
         ],
         "language_targets":[
            {
               "id":1,
               "name":"English",
               "code":"EN",
               "deleted":false
            }
         ],
         "size_targets":null,
         "zip_targets":null,
         "member_targets":[
            {
               "id":1185,
               "action":"include",
               "third_party_auditor_id":null,
               "billing_name":"AppNexus Demo"
            }
         ],
         "video_targets":null,
         "segment_group_targets":[
            {
               "boolean_operator":"and",
               "segments":[
                  {
                     "id":465381,
                     "action":"include",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  },
                  {
                     "id":465382,
                     "action":"include",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  }
               ]
            },
            {
               "boolean_operator":"and",
               "segments":[
                  {
                     "id":514839,
                     "action":"exclude",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  },
                  {
                     "id":523129,
                     "action":"include",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  }
               ]
            }
         ],
         "carrier_targets":null,
         "supply_type_targets":null,
         "device_type_targets":null,
         "screen_size_targets":null,
         "device_model_targets":null,
         "querystring_targets":null,
         "gender_targets":null,
         "intended_audience_targets":[
            "general",
            "children",
            "young_adult"
         ],
         "inventory_network_resold_targets":null,
         "operating_system_targets":null,
         "operating_system_family_targets":[
            {
               "id":6,
               "name":"BlackBerry OS"
            },
            {
               "id":8,
               "name":"Linux"
            }
         ],
         "position_targets":{
            "allow_unknown":true,
            "positions":null
         },
         "site_targets":null,
         "venue_targets":null,
         "operating_system_extended_targets":null,
         "mobile_app_instance_targets":null,
         "mobile_app_instance_list_targets":[
            {
               "id":3,
               "name":"Mopub iOS Apps 1-100",
               "description":"",
               "deleted":false
            }
         ],
         "optimization_zone_targets":null,
         "content_category_targets":{
            "allow_unknown":false,
            "content_categories":[
               {
                  "id":7,
                  "action":"exclude",
                  "name":"Beauty and Personal Care",
                  "is_system":true,
                  "deleted":false
               },
               {
                  "id":10,
                  "action":"include",
                  "name":"Arts and Entertainment",
                  "is_system":true,
                  "deleted":false
               },
               {
                  "id":20344,
                  "action":"exclude",
                  "name":"",
                  "is_system":false,
                  "deleted":false
               },
               {
                  "id":22224,
                  "action":"include",
                  "name":"",
                  "is_system":false,
                  "deleted":false
               }
            ]
         },
         "deal_targets":null,
         "placement_targets":null,
         "platform_content_category_targets":null,
         "platform_placement_targets":null,
         "platform_publisher_targets":[
            {
               "id":500070,
               "action":"exclude",
               "name":"Mediaset",
               "deleted":false
            }
         ],
         "publisher_targets":null,
         "segment_targets":null,
         "exelate_targets":null,
         "ip_range_list_targets":null
      }
   }
}

クエリ文字列値の範囲をターゲットにする

シナリオ: 2 つの自動パブリッシャーから、配置のクエリ文字列に "car year" データが含まれると言われました。 1 つ目は "car_year" パラメーターを使用して年を渡し、2 つ目は "car_YYYY" パラメーターを使用して年を渡します。 キャンペーンでこの情報をターゲットとするために、 "car_year" パラメーターをセグメント 25 に追加し、 "car_YYYY" パラメーターをセグメント 26 に追加しました。 ここで、パラメーターが "car_year=2009" 年から "car_year=2012" の間にいずれかの年を渡すときに、いずれかのパラメーターを含む配置をターゲットとするようにキャンペーンのプロファイルを更新したいので、次の JSON を作成し、 PUT 呼び出しを実行してプロファイルを更新します。

$ cat profile_update

{
   "profile":{
      "segment_group_targets":[
         {
            "boolean_operator":"or",
            "segments":[
               {
                  "id":25,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_less":2012,
                  "other_greater":2009
               },
               {
                  "id":26,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_less":2012,
                  "other_greater":2009
               }
            ]
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api.appnexus.com/profile?id=9&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":9
   }
}

クエリ文字列値のリストをターゲットにする

シナリオ: 自動パブリッシャーから、配置のクエリ文字列に "car_make=ford"、 "car_make=honda"、 "car_make=toyota" のいずれかのキーと値が含まれることが求められました。 このような情報をターゲットにするために、パラメータと値をセグメント 12 に追加しました。 ここで、これらの値をターゲットとするようにキャンペーンのプロファイルを更新したいので、次の JSON を作成し、 PUT 呼び出しを実行してプロファイルを更新します。

$ cat profile_update

{
   "profile":{
      "segment_group_targets":[
         {
            "segments":[
               {
                  "id":12,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_in_list":[
                     "ford",
                     "honda",
                     "toyota"
                  ]
               }
            ]
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

正確なクエリ文字列値をターゲットにする

シナリオ: 自動パブリッシャーから、配置のクエリ文字列に car_color=red、 car_color=blue、 car_color=black のキーと値が表示されることが予想されます。 このような情報をターゲットにするために、パラメータと値をセグメント 15 に追加しました。 ここで、特定のクエリ文字列値 black をターゲットとするようにキャンペーンのプロファイルを更新したいので、次の JSON を作成し、 PUT 呼び出しを実行してプロファイルを更新します。

$ cat profile_update

{
   "profile":{
      "segment_group_targets":[
         {
            "segments":[
               {
                  "id":15,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":"black"
               }
            ]
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

特定の国をターゲットにする

シナリオ: プロファイルのターゲットを米国とカナダにしたい。 これには、 country_action を include に設定し、 country_targets を US と CA に設定する必要があるため、次の JSON を作成し、 PUT 呼び出しを実行してプロファイルを更新します。

$ cat profile_update

{
   "profile":{
      "country_action":"include",
      "country_targets":[
         {
            "id":233
         },
         {
            "id":39
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

特定の状態を対象とするが、DMA は除外する

シナリオ: プロファイルのターゲットをニューヨーク州 (ニューヨーク市エリアを除く) にしたい。 これには、 region_action を include、 region_targets を US:NY、 dma_action を exclude、 dma_targets を 501 (ニューヨーク市の DMA コード) に設定する必要があります。 そのため、次の JSON を作成し、 PUT 呼び出しを実行してプロファイルを更新します。

$ cat profile_update

{
   "profile":{
      "region_action":"include",
      "region_targets":[
         {
            "id":1
         }
      ],
      "dma_action":"exclude",
      "dma_targets":[
         {
            "dma":501
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

取引をターゲットとする

シナリオ: 他の買い手が利用できない在庫 (プライベート オークションなど) へのアクセスを許可する販売者と契約を交渉しました。 この取引を利用するには、Deal Buyer Access Service を使用して取引 ID を検索し、その ID をターゲットにするようにプロファイルの deal_targets 配列を更新する必要があります。

  1. 取引の ID を見つけるには、Deal Buyer Access Service をGET呼び出して、適切な取引を特定します。 または、販売者のメンバー ID がわかっている場合は、次に示すように、クエリ文字列に渡して、その販売者との取引のみを取得できます。

    $ curl -b cookies -c cookies 'https://api.appnexus.com/deal-buyer-access?seller_member_id=814'

{
   "response":{
      "status":"OK",
      "count":1,
      "start_element":0,
      "num_elements":100,
      "deals":[
         {
            "id":65,
            "code":null,
            "name":"Private deal for buyer 1085 with floor of 2.5",
            "description":null,
            "active":true,
            "seller_member_id":814,
            "start_date":"2013-12-01 00:00:00",
            "end_date":"2013-12-31 23:59:59",
            "profile_id":null,
            "floor_price":2.5,
            "currency":"USD",
            "use_deal_floor":true,
            "last_modified":"2013-12-04 22:37:49",
            "buyer":{
               "id":1085,
               "bidder_id":2
            },
            "type":{
               "id":2,
               "name":"Private Auction"
            },
            "brands":[
               {
                  "id":1
               }
            ]
         }
      ]
   }
}

  2. 次に、 deal_targets 取引の ID に設定した JSON ファイルを作成します。

    $ cat profile_update

{
   "profile":{
      "deal_targets":[
         {
            "id":65
         }
      ]
   }
}

  3. 最後に、 PUT 呼び出しを行ってプロファイルを更新します。

    $ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api.appnexus.com/profile?id=22&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":22
   }
}

OS ファミリ ターゲットと OS 拡張ターゲットを一緒に使用する

拡張 OS と OS ファミリのターゲットは連携して動作し、特定のオペレーティング システム ファミリに対して異なるターゲット シナリオを可能にします。 この機能は、使用例によって最もよく表されています。 このセクションには、次の例が含まれています (下にスクロールするか検索して表示します)。

  • iOS 7.0 デバイスを対象とする。他のすべての OS ファミリと他の iOS バージョンは利用できません。
  • バージョンに関係なくすべての iOS デバイスを対象にします。他のすべての OS ファミリは機能しません。
  • 不明、Linux、または Symbian ではないすべての OS をターゲットにします。
  • iOS 7.0 に加えて、すべての Android デバイスを対象とします。
  • 対象: すべての Android、すべての iOS、およびすべての Windows Mobile 対象。
  • 対象: Mac OS 10.8 (Mountain Lion) および MS Windows 8.0。
  • 対象: Mac OS X 10.8 (Mountain Lion)、および XP および 2000 を除くすべての Windows デスクトップ。
  • 2.0 および 2.1 を除くすべての iOS オペレーティング システムを対象とします。
  • 無効な構成: OS ファミリを含めて、そのメンバーを除外することはできません。
  • 無効な構成: 同じ OS ファミリのメンバーを含めたり除外したりすることはできません。
  • 無効な構成: 除外された OS ファミリのメンバーを含めることはできません。

iOS 7.0 デバイスを対象とする。他のすべての OS ファミリと他の iOS バージョンは利用できません

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":{
         "id":80,
         "name":"iOS 7.0",
         "action":"include"
      }
   }
}

バージョンに関係なくすべての iOS デバイスを対象にします。他のすべての OS ファミリは機能しません

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         "id":3,
         "name":"Apple iOS"
      }
   },
   "operating_system_extended_targets":{
      
   }
}

不明、Linux、Symbian 以外のすべての OS をターゲットにする

つまり、Android、iOS、MacOS、Windows、Blackberry、Windows Mobile デバイスでサービスを提供します。

{
   "profile":{
      "operating_system_family_action":"exclude",
      "operating_system_family_targets":[
         {
            "id":0,
            "name":"Unknown"
         },
         {
            "id":8,
            "name":"Linux"
         },
         {
            "id":9,
            "name":"Symbian OS"
         }
      ]
   }
}

対象: iOS 7.0 のすべての Android デバイス

他のすべての iOS バージョンは利用できず、Android 以外のすべてのデバイスは利用できません。

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         "id":2,
         "name":"Android"
      }
   },
   "operating_system_extended_targets":[
      {
         "id":80,
         "name":"iOS 7.0",
         "action":"include"
      }
   ]
}

対象: すべての Android、すべての iOS、すべての Windows モバイル

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":2,
            "name":"Android"
         },
         {
            "id":3,
            "name":"Apple iOS"
         },
         {
            "id":7,
            "name":"Microsoft Mobile"
         }
      ],
      "operating_system_extended_targets":{
         
      }
   }
}

対象: Mac OS 10.8 (Mountain Lion) および MS Windows 8.0

この例では、異なる OS ファミリの OS 拡張ターゲットを組み合わせます。

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":[
         {
            "id":81,
            "name":"10.8 Mountain Lion",
            "action":"include"
         },
         {
            "id":93,
            "name":"Windows 8",
            "action":"include"
         }
      ]
   }
}

対象: Mac OS X 10.8 (Mountain Lion)、および XP および 2000 を除くすべての Windows デスクトップ

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":[
         {
            "id":80,
            "name":"10.8 Mountain Lion",
            "action":"include"
         },
         {
            "id":89,
            "name":"Windows 2000",
            "action":"exclude"
         },
         {
            "id":90,
            "name":"Windows XP",
            "action":"exclude"
         }
      ]
   }
}

2.0 および 2.1 を除くすべての iOS オペレーティング システムをターゲットとする

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":3,
            "name":"Apple iOS"
         }
      ],
      "operating_system_extended_targets":[
         {
            "id":47,
            "action":"include",
            "name":"iOS 2.0"
         },
         {
            "id":48,
            "action":"include",
            "name":"iOS 2.1"
         }
      ]
   }
}

次のプロファイル ターゲット設定構成は無効であり、予期しない動作が発生する可能性があります。

無効な構成: OS ファミリを含めて、そのメンバーを除外することはできません

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":3,
            "name":"Apple iOS"
         }
      ],
      "operating_system_extended_targets":[
         {
            "id":47,
            "action":"include",
            "name":"iOS 2.0"
         },
         {
            "id":48,
            "action":"include",
            "name":"iOS 2.1"
         }
      ]
   }
}

無効な構成: 同じ OS ファミリのメンバーを含めたり除外したりすることはできません

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":[
         {
            "id":47,
            "name":"iOS 2.0",
            "action":"include"
         },
         {
            "id":48,
            "name":"iOS 2.1",
            "action":"exclude"
         }
      ]
   }
}

無効な構成: 除外された OS ファミリのメンバーを含めることができません

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":3,
            "name":"Apple iOS"
         }
      ],
      "operating_system_extended_targets":[
         {
            "id":47,
            "action":"include",
            "name":"iOS 2.0"
         },
         {
            "id":48,
            "action":"include",
            "name":"iOS 2.1"
         }
      ]
   }
}

広告ポッドの位置をターゲットとする

特定の広告スロットの位置 (最後、最初、3 番目) をターゲットにする

{
   "profile":{
      "ad_slot_intro_bumper_action_include":false,
      "ad_slot_outro_bumper_action_include":false,
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[
         -1,
         0,
         2
      ]
   }
}

バンパーの位置 (イントロとアウトロ) のみをターゲットにする

{
   "profile":{
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":true,
      "ad_slot_outro_bumper_action_include":true
   }
}

任意の広告ポッド スロットをターゲットにする

{
   "profile":{
      "ad_slot_position_action_include":false,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":false,
      "ad_slot_outro_bumper_action_include":false
   }
}

すべての広告ポッド スロットとバンパーを除外する

この動作は、再現したいものではありません。あなたは何にも仕えません。

{
   "profile":{
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":false,
      "ad_slot_outro_bumper_action_include":false
   }
}

イントロ バンパーのみをターゲットにする

{
   "profile":{
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":true,
      "ad_slot_outro_bumper_action_include":false
   }
}

次のプロファイル ターゲット設定構成は無効であり、予期しない動作が発生する可能性があります。

無効な構成: すべての広告スロットとすべてのバンパー位置をターゲットにすることはできません

{
   "profile":{
      "ad_slot_position_action_include":false,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":true,
      "ad_slot_outro_bumper_action_include":true
   }
}

プログラマティック保証取引をターゲットとする

シナリオ: 販売者とプログラマティック保証取引 (PG 取引) を交渉し、この取引を PG 購入品目でターゲットにしたいと考えています。 PG 取引 ID を使用して PG 取引プロファイルを作成する必要があります。 次に、このプロファイルを PG 購入品目に関連付けて、取引をターゲットにする必要があります ( 品目 ALI サービスの PG 購入品目の作成例を参照)。

  1. 取引ターゲット ID を含む PG 取引プロファイル JSON を作成します。

    注:

    PG 購入ライン アイテムの場合、 deal_targets 配列に指定できる取引ターゲットは 1 つだけです。

    $ cat pg_deal_profile

{
   "profile":{
      "deal_targets":[
         {
            "id":456
         }
      ],
      "allow_unaudited":true
   }
}

  2. この PG 取引プロファイル JSON と適切なadvertiser_idを使用して、https://api.appnexus.com/profile エンドポイントにPOST要求を行います。

    $ curl -b cookies -c cookies -X POST -d @pg_deal_profile 'https://api.appnexus.com/profile?advertiser_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":123456,
      "start_element":0,
      "num_elements":100,
      "profile":{
         "id":123456,
         "code":null,
         "description":null,
         "country_action":"exclude",
         "region_action":"exclude",
         "city_action":"exclude",
         "browser_action":"exclude",
         "use_inventory_attribute_targets":false,
         "last_modified":"2019-08-07 19:43:12",
         "daypart_timezone":null,
         "dma_action":"exclude",
         "domain_action":"exclude",
         "domain_list_action":"exclude",
         "inventory_action":"exclude",
         "language_action":"exclude",
         "segment_boolean_operator":"and",
         "min_session_imps":null,
         "session_freq_type":"platform",
         "carrier_action":"exclude",
         "supply_type_action":"exclude",
         "device_type_action":"exclude",
         "screen_size_action":"exclude",
         "device_model_action":"exclude",
         "location_target_radius":null,
         "location_target_latitude":null,
         "location_target_longitude":null,
         "querystring_action":"exclude",
         "querystring_boolean_operator":"and",
         "is_expired":false,
         "non_audited_url_action":"include",
         "daypart_bitmap":null,
         "is_archived":false,
         "archived_on":null,
         "advertiser_id":123,
         "publisher_id":null,
         "max_session_imps":null,
         "max_day_imps":null,
         "max_lifetime_imps":null,
         "max_page_imps":null,
         "min_minutes_per_imp":null,
         "venue_action":"exclude",
         "operating_system_action":"exclude",
         "require_cookie_for_freq_cap":true,
         "trust":"seller",
         "allow_unaudited":true,
         "is_template":false,
         "created_on":"2019-08-07 19:43:12",
         "operating_system_family_action":"exclude",
         "use_operating_system_extended_targeting":true,
         "mobile_app_instance_action_include":false,
         "mobile_app_instance_list_action_include":false,
         "inventory_prefer_direct":false,
         "deal_action_include":true,
         "exclude_unknown_seller_member_group":false,
         "ad_slot_position_action_include":false,
         "ad_slot_intro_bumper_action_include":true,
         "ad_slot_outro_bumper_action_include":true,
         "graph_id":null,
         "media_subtype_action_include":false,
         "ads_txt_authorized_only":false,
         "inventory_url_allowlist_settings":{
            "apply_to_rtb":true,
            "apply_to_managed":true
         },
         "user_group_targets":null,
         "country_targets":null,
         "region_targets":null,
         "city_targets":null,
         "inventory_attribute_targets":null,
         "placement_type_targets":null,
         "age_targets":null,
         "daypart_targets":null,
         "browser_targets":null,
         "dma_targets":null,
         "domain_targets":null,
         "domain_list_targets":null,
         "language_targets":null,
         "size_targets":null,
         "zip_targets":null,
         "member_targets":null,
         "video_targets":{
            "allow_unknown_playback_method":false,
            "allow_unknown_context":false,
            "allow_unknown_player_size":false
         },
         "engagement_rate_targets":null,
         "segment_group_targets":null,
         "carrier_targets":null,
         "supply_type_targets":null,
         "device_type_targets":null,
         "screen_size_targets":null,
         "device_model_targets":null,
         "querystring_targets":null,
         "gender_targets":null,
         "intended_audience_targets":null,
         "inventory_network_resold_targets":null,
         "operating_system_targets":null,
         "operating_system_family_targets":null,
         "position_targets":null,
         "site_targets":null,
         "venue_targets":null,
         "operating_system_extended_targets":null,
         "postal_code_targets":null,
         "seller_member_group_targets":null,
         "cross_device":null,
         "key_value_targets":null,
         "media_subtype_targets":null,
         "content_category_targets":null,
         "deal_targets":[
            {
               "id":456,
               "name":"PG Deal 123",
               "code":"PGD_123",
               "deleted":false
            }
         ],
         "placement_targets":null,
         "platform_content_category_targets":null,
         "platform_placement_targets":null,
         "platform_publisher_targets":null,
         "publisher_targets":null,
         "ip_range_list_targets":null,
         "mobile_app_instance_targets":null,
         "mobile_app_instance_list_targets":null,
         "ad_slot_position_targets":null,
         "inventory_url_list_targets":null,
         "max_hour_imps":null,
         "max_week_imps":null,
         "max_month_imps":null
      },
      "dbg_info":{
         "warnings":[

         ],
         "version":"1.18.1247",
         "output_term":"profile"
      }
   }
}

  3. PG 購入ライン アイテムを作成し、新しく作成された PG 取引プロファイルの ID に関連付けます ( ライン アイテム ALI サービスの「PG 購入ライン アイテムの作成例」を参照してください)。

    特定の選挙区をターゲットにする

    {
   "profile":{
      "political_district_targets":[
         {
            "id":"139897"
         }
      ]
   }
}
  • Last updated on