Visibility Profile Service

在庫を再販する場合、Visibility Profile Service を使用すると、入札要求で購入者に渡す詳細レベルを制御できます。具体的には、パブリッシャー ID と名前、プレースメント ID と名前、パブリッシャーから提供された年齢と性別データ、インベントリのユニバーサル分類とカスタム分類、インベントリ URL、位置情報などを公開または非表示にすることができます。

プロフィールの既定の設定 ( expose_age_default、 expose_gender_default など) は、すべてのプラットフォーム購入者と外部入札者に適用されますが、 buyer_members 配列と bidders 配列を使用して、特定のプラットフォーム購入者と外部入札者の既定設定をオーバーライドできます。たとえば、既定で在庫データを非表示にし、特別なビジネス関係にある特定の購入メンバーにのみデータを公開することができます。または、在庫データを競合他社と見なされる特定の購入メンバーを除くすべてのユーザーに公開することもできます。

表示範囲設定は、購入者が入札要求で目にするデータだけでなく、購入したインプレッションについての購入についてレポートするときに購入者に表示されるデータにも影響します。たとえば、購入者に対して発行元 ID と名前を非表示にした場合、その購入者はレポートに発行元 ID と名前を表示しません。

注:

複数の表示範囲プロファイルを作成できますが、メンバーにアタッチできるのは 1 つだけです (メンバーサービスのvisibility_profile_id フィールドを参照してください)。パブリッシャーに直接表示範囲プロファイルを添付する場合は、アカウント担当者にお問い合わせください。

REST API

HTTP メソッド	エンドポイント	説明
`POST`	https://api.appnexus.com/visibility-profile (`visibility_profile` JSON)	可視性プロファイルを追加します。
`PUT`	https://api.appnexus.com/visibility-profile?id=VISIBILITY_PROFILE_ID (`visibility_profile` JSON)	可視性プロファイルを変更します。
`DELETE`	https://api.appnexus.com/visibility-profile?id=VISIBILITY_PROFILE_ID	表示プロファイルを削除します。
`GET`	https://api.appnexus.com/visibility-profile	すべての表示範囲プロファイルを表示します。
`GET`	https://api.appnexus.com/visibility-profile?id=VISIBILITY_PROFILE_ID	特定の可視性プロファイルを表示します。
`GET`	https://api.appnexus.com/visibility-profile?id=1,2,3	コンマ区切りのリストを使用して、ID 別に複数の表示範囲プロファイルを表示します。
`GET`	https://api.appnexus.com/visibility-profile/meta	フィルター処理と並べ替えの基準にされるフィールドを確認します。

JSON フィールド

フィールド	種類	説明
`id`	int	読み取り専用です。可視性プロファイルの ID。既定値: 自動生成された数値 (例: 123)。 Required On:`PUT`, in query string.
`member_id`	int	読み取り専用です。可視性プロファイルを所有するメンバーの ID。
`name`	string	表示プロファイルの名前。必須:`POST`
`notes`	string	可視性プロファイルに関する追加情報。
`expose_publishers_default`	ブール型	使用しないでください。すべてのクライアントが利用できるわけではありません。 `true`の場合、パブリッシャー ID は入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_tags_default`	ブール型	使用しないでください。すべてのクライアントが利用できるわけではありません。 `true`の場合、プレースメント ID は入札リクエストで渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_age_default`	ブール型	`true`の場合、パブリッシャーから提供された年齢データが入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_gender_default`	ブール型	`true`の場合、パブリッシャーから提供された性別データが入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_universal_categories_default`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_custom_categories_default`	列挙	入札要求におけるカスタムコンテンツカテゴリの表示。使用可能な値: - `none`: 入札要求でカスタムカテゴリは渡されません。 - `all`: すべてのカスタムカテゴリが入札要求で渡されます。 - `list`: `custom_categories` 配列に一覧表示されているカスタムカテゴリが入札要求で渡されます。既定値:`none`
`url_exposure_default`	列挙	入札要求でのインベントリ URL の表示状態。使用可能な値: - `full`: 入札要求で完全な URL が渡されます。 - `domain`: 入札要求では URL のドメインのみが渡されます。 - `hidden`: URL は入札要求で渡されません。既定値:`full`
`expose_bid_requests_default`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_auction_id_default`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_locale_default`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_ecp_default`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_reserve_price_default`	ブール型	`true`の場合は、パブリッシャーが指定した予約価格が入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_user_id_default`	ブール型	`true`の場合は、パブリッシャーが指定したユーザー ID が入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_ip_default`	ブール型	`true`の場合、パブリッシャーが指定した IP アドレスが入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_venue_id_default`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_user_agent_default`	ブール型	`true`の場合、パブリッシャーが提供するユーザーエージェントが入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_city_default`	ブール型	`true`の場合、パブリッシャーが提供する都市は、Microsoft Invest を使用した購入者のターゲット設定とレポートに利用できます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべての Microsoft Invest メンバーと入札者に適用されます。 `true`とこの可視性プロファイルが販売者制限ターゲティングを使用している取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は都市をターゲットにできません。詳細については、ディールサービスを参照してください。外部 DSP の購入者は、この設定に関係なく、都市をターゲットにしてレポートできます。既定値:`true`
`expose_state_default`	ブール型	`true`の場合は、パブリッシャーが提供する状態を、Microsoft Invest を使用した購入者のターゲット設定とレポートに利用できます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべての Microsoft Invest メンバーと入札者に適用されます。 `true`とこの可視性プロファイルが販売者制限ターゲティングを使用している取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は州をターゲットにできません。詳細については、ディールサービスを参照してください。外部 DSP の購入者は、この設定に関係なく、状態をターゲットにしてレポートできます。既定値:`true`
`expose_dma_default`	ブール型	`true`の場合は、パブリッシャーが提供する DMA を、Microsoft Invest を使用した購入者のターゲット設定とレポートに利用できます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべての Microsoft Invest メンバーと入札者に適用されます。 `true`とこの可視性プロファイルが販売者制限ターゲティングを使用する取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は DMA をターゲットにできません。詳細については、ディールサービスを参照してください。外部 DSP の購入者は、この設定に関係なく、DMA をターゲットにしてレポートできます。既定値:`true`
`expose_postal_code_default`	ブール型	`true`の場合、パブリッシャーが指定した郵便番号は入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_geo_lat_lon_default`	ブール型	`true`の場合、パブリッシャーから提供された緯度と経度の情報が入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_device_id_default`	ブール型	`true`の場合は、パブリッシャーが指定したデバイス ID が入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_device_model_id_default`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_querystring_default`	ブール型	`true`の場合、パブリッシャー指定のクエリ文字列が入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_application_id_default`	ブール型	`true`の場合、パブリッシャーが指定した Android または iOS モバイルアプリケーション ID は、入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_site_id_default`	ブール型	`true`の場合、パブリッシャーが指定したプレースメントグループ (サイト) ID は、入札要求で渡されます。これは、以下の `buyer_members` および `bidders` 配列で個別に設定されていないすべてのプラットフォームメンバーと入札者に適用されます。既定値:`true`
`expose_datetime_default`	ブール型	使用しないでください。このフィールドは無視されます。
`expose_multiformat_banner_default`	ブール型	true の場合、バナー `media_type`が入札要求の一部である場合、マルチフォーマットの oRTB 入札リクエストでバナー `media_type`が購入者に公開されます。このフィールドを適用するには、マルチフォーマット入札要求が有効になっている必要があることに注意してください。ただし、マルチフォーマットの有効化をリクエストする前に、販売者のベストプラクティスを確認し、アカウントマネージャーと話し合ってください。これはすべてのプラットフォームメンバーに適用されます。入札者は以下の `buyer_members` および `bidders` 配列で個別に設定されていません。既定値:`true`
`expose_multiformat_video_default`	ブール型	true の場合、ビデオ `media_type`が入札要求の一部である場合、マルチフォーマットの oRTB 入札要求はビデオ `media_type`を購入者に公開します。このフィールドを適用するには、マルチフォーマット入札要求が有効になっている必要があることに注意してください。ただし、マルチフォーマットの有効化をリクエストする前に、販売者のベストプラクティスを確認し、アカウントマネージャーと話し合ってください)。これはすべてのプラットフォームメンバーに適用されます。入札者は以下の `buyer_members` および `bidders` 配列で個別に設定されていません。既定値:`true`
`expose_multiformat_audio_default`	ブール型	true の場合、ネイティブ `media_type`が入札要求の一部である場合、マルチフォーマットの oRTB 入札要求は音声`media_type`を購入者に公開します。このフィールドを適用するには、マルチフォーマット入札要求が有効になっている必要があることに注意してください。ただし、マルチフォーマットの有効化をリクエストする前に、販売者のベストプラクティスを確認し、アカウントマネージャーと話し合ってください)。これはすべてのプラットフォームメンバーに適用されます。入札者は以下の `buyer_members` および `bidders` 配列で個別に設定されていません。既定値:`true`
`expose_multiformat_native_default`	ブール型	true の場合、ネイティブ `media_type`が入札要求の一部である場合、マルチフォーマットの oRTB 入札リクエストは購入者にネイティブ `media_type`を公開します。このフィールドを適用するには、マルチフォーマット入札要求が有効になっている必要があることに注意してください。ただし、マルチフォーマットの有効化をリクエストする前に、販売者のベストプラクティスを確認し、アカウントマネージャーと話し合ってください)。これはすべてのプラットフォームメンバーに適用されます。入札者は以下の `buyer_members` および `bidders` 配列で個別に設定されていません。既定値:`true`
`buyer_members`	オブジェクトの配列	特定の Xandr プラットフォームメンバーの可視性ルール。詳細については、以下のバイヤーメンバーを参照してください。既定値:`true`
`bidders`	オブジェクトの配列	特定の外部入札者やコンテキストデータプロバイダーの表示範囲ルール。詳細については、以下の「入札者」を参照してください。
`custom_categories`	オブジェクトの配列	入札要求で渡されるカスタムコンテンツカテゴリ。詳細については、以下のカスタムカテゴリを参照してください。必須日付:`POST`、 `expose_custom_categories_default` が `list`の場合。
`last_modified`	timestamp	読み取り専用です。表示プロファイルが最後に変更された日時。
`expose_device_type_targets`	ブール型	`true`とこの可視性プロファイルが販売者制限ターゲティングを使用している取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者はデバイスの種類をターゲットにできません。詳細については、ディールサービスを参照してください。
`expose_segment_groups_default`	ブール型	`true`とこの可視性プロファイルが販売者制限ターゲティングを使用している取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者はセグメントをターゲットにできません。詳細については、ディールサービスを参照してください。
`expose_video_context_default`	ブール型	`true`とこの可視性プロファイルが販売者制限ターゲティングを使用している取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は、ビデオコンテキスト (プレロールなど) をターゲットにすることはできません。詳細については、ディールサービスを参照してください。
`expose_video_content_genres_default`	ブール型	`true`とこの可視性プロファイルが販売者制限ターゲティングを使用する取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は、ビデオコンテンツのジャンル (コメディなど) をターゲットにすることはできません。詳細については、ディールサービスを参照してください。
`expose_video_program_types_default`	ブール型	`true`とこの可視性プロファイルが販売者制限付きターゲティングを使用している取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は、ビデオ番組の種類 (シリーズなど) をターゲットにすることはできません。詳細については、ディールサービスを参照してください。
`expose_video_content_ratings_default`	ブール型	`true`とこの可視性プロファイルが販売者制限ターゲティングを使用している取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は、ビデオコンテンツレーティングをターゲットにすることはできません。詳細については、ディールサービスを参照してください。
`expose_video_content_duration_default`	ブール型	`true`とこの可視性プロファイルが販売者制限付きターゲティングを使用する取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は、ビデオコンテンツの期間 (短編など) をターゲットにすることはできません。詳細については、ディールサービスを参照してください。
`expose_video_content_networks_default`	ブール型	`true`とこの可視性プロファイルが販売者制限ターゲティングを使用している取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は、ビデオコンテンツネットワークをターゲットにすることはできません。詳細については、ディールサービスを参照してください。
`expose_video_delivery_types_default`	ブール型	`true`とこの可視性プロファイルが販売者制限付きターゲティングを使用する取引に関連付けられている場合、取引をターゲットとする Microsoft Invest の購入者は、ビデオ配信の種類 (VOD など) をターゲットにすることはできません。詳細については、ディールサービスを参照してください。

カスタムカテゴリ

expose_custom_categories_default が list に設定されている場合は、この配列を使用して、入札要求で渡したいカスタムカテゴリを指定します。配列内の各オブジェクトは 1 つのカスタムカテゴリを表し、次のフィールドが含まれます。書式設定については、次の例を参照してください。

ヒント

コンテンツカテゴリサービスを使用して、カスタムコンテンツカテゴリの ID を取得できます。

フィールド	種類	説明
`id`	int	入札要求で渡されるカスタムコンテンツカテゴリの ID。
`name`	string	読み取り専用です。カスタムコンテンツカテゴリの名前。

購入者メンバー

この配列を使用して、特定の Xandr プラットフォームメンバーの可視性ルールを定義します。配列内の各オブジェクトは 1 つのメンバーを表し、次のフィールドが含まれます。書式設定については、次の例を参照してください。

ヒント

プラットフォームメンバーサービスを使用すると、Xandr プラットフォームメンバーの ID を取得できます。

フィールド	種類	説明
`id`	int	特定の可視性ルールを適用する Xandr プラットフォームメンバーの ID。必須:`POST`
`name`	string	読み取り専用です。 Xandr プラットフォームメンバーの名前。
`expose_publishers`	ブール型	使用しないでください。このフィールドは無視されます。一部の顧客向け: `true`の場合、パブリッシャー ID は入札要求でメンバーに渡されます。既定値:`true`
`expose_tags`	ブール型	使用しないでください。このフィールドは無視されます。一部の顧客向け: `true`の場合、プレースメント ID は入札リクエストでメンバーに渡されます。既定値:`true`
`expose_age`	ブール型	`true`の場合、入札要求でメンバーへの年齢データが渡されます。既定値:`true`
`expose_gender`	ブール型	`true`の場合、メンバーへの入札要求で性別データが渡されます。既定値:`true`
`expose_universal_categories`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_custom_categories`	列挙	メンバーに対する入札要求におけるカスタムコンテンツカテゴリの表示。使用可能な値: - `none`: 入札要求でカスタムカテゴリは渡されません。 - `all`: すべてのカスタムカテゴリが入札要求で渡されます。 - `list`: `custom_categories` 配列に一覧表示されているカスタムカテゴリが入札要求で渡されます。既定値:`none`
`custom_categories`	オブジェクトの配列	入札要求でメンバーに渡されるカスタムコンテンツカテゴリ。この配列のフィールドについては、上記のカスタムカテゴリを参照してください。必須日付:`POST`、 `expose_custom_categories_default` が `list`の場合。
`url_exposure`	列挙	メンバーに対する入札要求のインベントリ URL の表示。使用可能な値: - `full`: 入札要求で完全な URL が渡されます。 - `domain`: 入札要求では URL のドメインのみが渡されます。 - `hidden`: URL は入札要求で渡されません。既定値:`full`
`expose_bid_requests`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_auction_id`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_locale`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_ecp`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_reserve_price`	ブール型	`true`の場合、予約価格は所有メンバーに表示されます。既定値:`true`
`expose_user_id`	ブール型	`true`の場合、ユーザー ID は所有メンバーに公開されます。既定値:`true`
`expose_ip`	ブール型	`true`する場合、IP アドレスが所有メンバーに公開されます。既定値:`true`
`expose_venue_id`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_user_agent`	ブール型	`true`の場合、ユーザーエージェントは所有メンバーに公開されます。既定値:`true`
`expose_city`	ブール型	`true`場合、都市は Microsoft Invest 購入者のターゲット設定とレポートに使用できます。既定値:`true`
`expose_state`	ブール型	`true`場合は、Microsoft Invest 購入者のターゲットとレポートに状態を使用できます。既定値:`true`
`expose_dma`	ブール型	`true`場合、DMA は Microsoft Invest 購入者のターゲット設定とレポートに使用できます。既定値:`true`
`expose_postal_code`	ブール型	`true`の場合、所有メンバーに郵便番号が公開されます。既定値:`true`
`expose_geo_lat_lon`	ブール型	`true` の場合、緯度と経度の情報が所有メンバーに公開されます。既定値:`true`
`expose_device_id`	ブール型	`true`の場合、デバイス ID は所有メンバーに公開されます。既定値:`true`
`expose_device_model_id`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_querystring`	ブール型	`true`の場合、クエリ文字列は所有メンバーに公開されます。既定値:`true`
`expose_application_id`	ブール型	`true`の場合、Android または iOS モバイルアプリケーション ID が所有メンバーに公開されます。既定値:`true`
`expose_site_id`	ブール型	`true`の場合、配置グループ (サイト) ID が所有メンバーに公開されます。既定値:`true`
`expose_datetime`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`

入札者

この配列を使用して、特定の外部入札者やコンテキストデータプロバイダーの表示範囲ルールを定義します。配列内の各オブジェクトは 1 つの入札者を表し、次のフィールドが含まれます。書式設定については、次の例を参照してください。

ヒント

外部の入札者 ID を直接取得するサービスはありません。ただし、プラットフォームメンバーサービスでは、使用している入札者を含む、プラットフォームメンバーに関する情報を取得します。

フィールド	種類	説明
`id`	int	特定の表示範囲ルールを適用する外部入札者の ID。必須:`POST`
`name`	string	読み取り専用です。外部入札者の名前。
`expose_publishers`	ブール型	使用しないでください。このフィールドは無視されます。一部の顧客向け: `true`の場合、発行元 ID は入札要求で入札者に渡されます。既定値:`true`
`expose_tags`	ブール型	使用しないでください。このフィールドは無視されます。一部の顧客向け: `true`の場合、プレースメント ID は入札要求で入札者に渡されます。既定値:`true`
`expose_age`	ブール型	`true`の場合、入札要求で入札者に年齢データが渡されます。既定値:`true`
`expose_gender`	ブール型	`true`の場合、性別データは入札要求で入札者に渡されます。既定値:`true`
`expose_universal_categories`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_custom_categories`	列挙	入札者に対する入札要求におけるカスタムコンテンツカテゴリの表示。使用可能な値: - `none`: 入札要求でカスタムカテゴリは渡されません。 - `all`: すべてのカスタムカテゴリが入札要求で渡されます。 - `list`: `custom_categories` 配列に一覧表示されているカスタムカテゴリが入札要求で渡されます。既定値:`none`
`custom_categories`	オブジェクトの配列	入札要求で入札者に渡されるカスタムコンテンツカテゴリ。この配列のフィールドについては、上記のカスタムカテゴリを参照してください。必須日付:`POST`、 `expose_custom_categories_default` が `list`の場合。
`url_exposure`	列挙	入札者に対する入札要求のインベントリ URL の表示。使用可能な値: - `full`: 入札要求で完全な URL が渡されます。 - `domain`: 入札要求では URL のドメインのみが渡されます。 - `hidden`: URL は入札要求で渡されません。既定値:`full`
`expose_bid_requests`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_auction_id`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_locale`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_ecp`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_reserve_price`	ブール型	`true`の場合、予約価格は入札要求で入札者に渡されます。既定値:`true`
`expose_user_id`	ブール型	`true`の場合、ユーザー ID は入札要求で入札者に渡されます。既定値:`true`
`expose_ip`	ブール型	`true`の場合、IP アドレスは入札要求で入札者に渡されます。既定値:`true`
`expose_venue_id`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_user_agent`	ブール型	`true`の場合、ユーザーエージェントは入札者に入札要求を渡しました。既定値:`true`
`expose_city`	ブール型	`true`する場合、都市は Microsoft Invest の入札者のターゲット設定とレポートに使用できます。既定値:`true`
`expose_state`	ブール型	`true`場合は、Microsoft Invest の入札者のターゲット設定とレポートに状態を使用できます。既定値:`true`
`expose_dma`	ブール型	`true`場合、DMA は Microsoft Invest の入札者のターゲット設定とレポートに使用できます。既定値:`true`
`expose_postal_code`	ブール型	`true`の場合、郵便番号は入札要求で入札者に渡されます。既定値:`true`
`expose_geo_lat_lon`	ブール型	`true`の場合、緯度と経度の情報は入札要求で入札者に渡されます。既定値:`true`
`expose_device_id`	ブール型	`true`の場合、デバイス ID は入札要求で入札者に渡されます。既定値:`true`
`expose_device_model_id`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`
`expose_querystring`	ブール型	`true`の場合、クエリ文字列は入札要求で入札者に渡されます。既定値:`true`
`expose_application_id`	ブール型	`true`の場合、Android または iOS モバイルアプリケーション ID が入札要求で入札者に渡されます。既定値:`true`
`expose_site_id`	ブール型	`true`の場合、プレースメントグループ (サイト) ID は入札要求で入札者に渡されます。既定値:`true`
`expose_datetime`	ブール型	使用しないでください。このフィールドは無視されます。既定値:`true`

例

可視性プロファイルの追加 - メンバー 9 を除くすべての購入者にインベントリデータを表示する

この例では、 POST 要求によって、すべての Xandr プラットフォームメンバーとメンバー 9 を除く外部入札者が、入札要求のパブリッシャー、配置、年齢、性別、カテゴリ、URL 情報を表示できる表示プロファイルが作成されます。

$ cat visibility_profile

{
    "visibility-profile": {
        "name": "Test Visibility Profile",
        "expose_age_default": true,
        "expose_gender_default": true,
        "expose_custom_categories_default": "all",
        "url_exposure_default": "full",
        "expose_reserve_price_default": true,
        "expose_user_id_default": true,
        "expose_ip_default": true,
        "expose_user_agent_default": true,
        "expose_postal_code_default": true,
        "expose_geo_lat_lon_default": true,
        "expose_device_id_default": true,
        "expose_querystring_default": true,
        "expose_application_id_default": true,
        "expose_site_id_default": true,
        "buyer_members": [
            {
                "id": 9,
                "expose_age": false,
                "expose_gender": false,
                "expose_custom_categories": "none",
                "url_exposure": "hidden"
            }
        ]
    }
}

$ curl -b cookies -X POST -d @visibility_profile 'https://api.appnexus.com/visibility-profile'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1818,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1818,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": true,
            "expose_gender_default": true,
            "expose_custom_categories_default": "all",
            "url_exposure_default": "full",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:18:54",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": false,
                    "expose_gender": false,
                    "expose_custom_categories": "none",
                    "url_exposure": "hidden",
                    "expose_bid_requests": true,
                    "expose_reserve_price": true,
                    "expose_user_id": true,
                    "expose_ip": true,
                    "expose_user_agent": true,
                    "expose_postal_code": true,
                    "expose_geo_lat_lon": true,
                    "expose_device_id": true,
                    "expose_querystring": true,
                    "expose_application_id": true,
                    "expose_site_id": true,
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": null
        }
    }
}

可視性プロファイルの追加 - メンバー 9 を除くすべての購入者からインベントリデータを非表示にする

この例では、 POST 要求は、メンバー 9 を除くすべての Xandr プラットフォームメンバーと外部入札者が、入札要求でパブリッシャー、配置、年齢、性別、カテゴリ、URL 情報を表示できないようにする可視性プロファイルを作成します。

$ cat visibility_profile

{
    "visibility-profile": {
        "name": "Test Visibility Profile",
        "expose_age_default": false,
        "expose_gender_default": false,
        "expose_custom_categories_default": "none",
        "url_exposure_default": "hidden",
        "expose_reserve_price_default": true,
        "expose_user_id_default": true,
        "expose_ip_default": true,
        "expose_user_agent_default": true,
        "expose_postal_code_default": true,
        "expose_geo_lat_lon_default": true,
        "expose_device_id_default": true,
        "expose_querystring_default": true,
        "expose_application_id_default": true,
        "expose_site_id_default": true,
        "buyer_members": [
            {
                "id": 9,
                "expose_age": true,
                "expose_gender": true,
                "expose_custom_categories": "all",
                "url_exposure": "full",
                "expose_bid_requests": true,
                "expose_reserve_price": true,
                "expose_user_id": true,
                "expose_ip": true,
                "expose_user_agent": true,
                "expose_postal_code": true,
                "expose_geo_lat_lon": true,
                "expose_device_id": true,
                "expose_querystring": true,
                "expose_application_id": true,
                "expose_site_id": true,
            }
        ]
    }

$ curl -b cookies -X POST -d @visibility_profile 'https://api.appnexus.com/visibility-profile'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1819,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1819,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": false,
            "expose_gender_default": false,
            "expose_custom_categories_default": "none",
            "url_exposure_default": "hidden",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:57:13",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_custom_categories": "all",
                    "url_exposure": "full",
                    "expose_reserve_price": true,
                    "expose_user_id": true,
                    "expose_ip": true,
                    "expose_user_agent": true,
                    "expose_postal_code": true,
                    "expose_geo_lat_lon": true,
                    "expose_device_id": true,
                    "expose_querystring": true,
                    "expose_application_id": true,
                    "expose_site_id": true,
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": null
        }
    }
}

可視性プロファイルの変更 1818

この例では、 PUT 要求によって可視性プロファイル 1818 が更新され、カスタムコンテンツカテゴリ 24214 のみが入札要求で渡されるようになります。これは、可視性が個別に定義されているプラットフォームメンバー 9 を除くすべての Xandr プラットフォームメンバーと外部入札者 {{buyer_members}} 適用されます (応答の配列を参照)。

$ cat visibility_profile_update

{
    "visibility-profile": {
        "expose_custom_categories_default": "list",
        "custom_categories": [
            {
                "id": 24214
            }
        ]
    }
}

$ curl -b cookies -X PUT -d @visibility_profile_update 'https://api.appnexus.com/visibility-profile?id=1818'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "1818",
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1818,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": true,
            "expose_gender_default": true,
            "expose_custom_categories_default": "list",
            "url_exposure_default": "full",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:24:43",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": false,
                    "expose_gender": false,
                    "expose_custom_categories": "none",
                    "url_exposure": "hidden",
                    "expose_reserve_price": true,
                    "expose_user_id": true,
                    "expose_ip": true,
                    "expose_user_agent": true,
                    "expose_postal_code": true,
                    "expose_geo_lat_lon": true,
                    "expose_device_id": true,
                    "expose_querystring": true,
                    "expose_application_id": true,
                    "expose_site_id": true,
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": [
                {
                    "id": 24214,
                    "name": "TEST"
                }
            ]
        }
    }
}

すべての表示範囲プロファイルを表示する

$ curl -b cookies 'https://api.appnexus.com/visibility-profile'

{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profiles": [
            {
                "id": 1816,
                "member_id": 1066,
                "name": "Test Visibility Profile",
                "notes": null,
                "expose_age_default": true,
                "expose_gender_default": true,
                "expose_custom_categories_default": "list",
                "url_exposure_default": "full",
                "expose_reserve_price_default": true,
                "expose_user_id_default": true,
                "expose_ip_default": true,
                "expose_user_agent_default": true,
                "expose_postal_code_default": true,
                "expose_geo_lat_lon_default": true,
                "expose_device_id_default": true,
                "expose_querystring_default": true,
                "expose_application_id_default": true,
                "expose_site_id_default": true,
                "last_modified": "2015-08-31 18:14:45",
                "buyer_members": [
                    {
                        "id": 9,
                        "expose_age": true,
                        "expose_gender": true,
                        "expose_custom_categories": "none",
                        "url_exposure": "full",
                        "expose_reserve_price": true,
                        "expose_user_id": true,
                        "expose_ip": true,
                        "expose_user_agent": true,
                        "expose_postal_code": true,
                        "expose_geo_lat_lon": true,
                        "expose_device_id": true,
                        "expose_querystring": true,
                        "expose_application_id": true,
                        "expose_site_id": true,
                        "name": "DisplayWords Bidder - member 9",
                        "custom_categories": null
                    }
                ],
                "bidders": [
                    {
                        "id": 6,
                        "expose_age": true,
                        "expose_gender": true,
                        "expose_custom_categories": "none",
                        "url_exposure": "full",
                        "expose_reserve_price": true,
                        "expose_user_id": true,
                        "expose_ip": true,
                        "expose_user_agent": true,
                        "expose_postal_code": true,
                        "expose_geo_lat_lon": true,
                        "expose_device_id": true,
                        "expose_querystring": true,
                        "expose_application_id": true,
                        "expose_site_id": true,
                        "name": "Dilling HBF Test New",
                        "custom_categories": null
                    }
                ],
                "custom_categories": [
                    {
                        "id": 24214,
                        "name": "TEST"
                    }
                ]
            },
            {
                "id": 1818,
                "member_id": 1066,
                "name": "Test Visibility Profile",
                "notes": null,
                "expose_age_default": true,
                "expose_gender_default": true,
                "expose_custom_categories_default": "list",
                "url_exposure_default": "full",
                "expose_reserve_price_default": true,
                "expose_user_id_default": true,
                "expose_ip_default": true,
                "expose_user_agent_default": true,
                "expose_postal_code_default": true,
                "expose_geo_lat_lon_default": true,
                "expose_device_id_default": true,
                "expose_querystring_default": true,
                "expose_application_id_default": true,
                "expose_site_id_default": true,
                "last_modified": "2015-08-31 21:24:43",
                "buyer_members": [
                    {
                        "id": 9,
                        "expose_age": false,
                        "expose_gender": false,
                        "expose_custom_categories": "none",
                        "url_exposure": "hidden",
                        "expose_reserve_price": true,
                        "expose_user_id": true,
                        "expose_ip": true,
                        "expose_user_agent": true,
                        "expose_postal_code": true,
                        "expose_geo_lat_lon": true,
                        "expose_device_id": true,
                        "expose_querystring": true,
                        "expose_application_id": true,
                        "expose_site_id": true,
                        "name": "DisplayWords Bidder - member 9",
                        "custom_categories": null
                    }
                ],
                "bidders": null,
                "custom_categories": [
                    {
                        "id": 24214,
                        "name": "TEST"
                    }
                ]
            }
        ]
    }
}

表示プロファイル 1818

$ curl -b cookies 'https://api.appnexus.com/visibility-profile?id=1818'

{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1818,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": true,
            "expose_gender_default": true,
            "expose_custom_categories_default": "list",
            "url_exposure_default": "full",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:24:43",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": false,
                    "expose_gender": false,
                    "expose_custom_categories": "none",
                    "url_exposure": "hidden",
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": [
                {
                    "id": 24214,
                    "name": "TEST"
                }
            ]
        }
    }
}

Last updated on 2026-08-18