パブリックセグメントとプライベート (カスタム) セグメントの管理

[アーティクル]
02/27/2024

Data Marketplace では、パブリックセグメントとプライベートセグメントの両方がサポートされています。つまり、Data Marketplace を通じて使用されるセグメント (パブリックかプライベートかに関係なく) がクリアされ、Xandr によって報告されます。データプロバイダーとデータ購入者の両方が、クリアリングハウスの運用上の節約とデータ使用状況の詳細なレポートの恩恵を受けることができます。このページの目的は、マーケットプレースを通じて提供するデータの種類に応じてベストプラクティスを提供することです。

パブリックセグメント

パブリックセグメントは、Data Marketplace のすべてのデータ購入者がすぐに利用できるセグメントです。これらのセグメントは、通常、データプロバイダーの標準オファリングを表します。 Xandr は、このセグメントをすべての Data Marketplace 購入者と自動的に共有します。

重要

データプロバイダーが購入者に表示されるようにするには、少なくとも 1 つのセグメントが分類にパブリックにマップされている必要があります。

新しいパブリックセグメントを作成する

Segment Service API を使用して新しいセグメントオブジェクトを作成します。以下に例を示します。

"$ cat segment"{
   "segment":{
      "member_id":25,
      "short_name":"remarketing - netflix user",
      "code":"netflix08"
   }
}"$ curl -b cookies -c cookies -d @segment""https://api.adnxs.com/segment/958"

Batch Server 側のセグメント化を使用して、新しいセグメントにデータをアップロードします。

セグメントを "is_public = true" に設定し、セグメント課金カテゴリサービス API を使用して Data Marketplace でセグメントをアクティブ化します。以下に例を示します。

"$ cat create_segment_mapping"{
   "segment-billing-category":{
      "active":true,
      "data_provider_id":1,
      "data_category_id":1001,
      "segment_id":111111,
      "is_public":true
   }
}"$ curl -b cookies -c cookies -X POST -d @create_segment_mapping""https://api.appnexus.com/segment-billing-category?member_id=958"

プライベート (カスタム) セグメント

プライベートセグメントは、データプロバイダーによるデータ購入者への明示的な共有を必要とするセグメントです。プライベートセグメントは、通常、特定のデータ購入者向けに構築されたカスタムセグメントであり、他の購入者に表示されるものではありません。すべての Data Marketplace 購入者が利用できないセグメントは、プライベートセグメントとして設定する必要があります。

重要

プライベートセグメントを購入者と共有する前に、「データ購入者ワークフローの変更」の「データプロバイダーの追加」セクションで説明されているように、購入者が Data Marketplace で会社を追加したことを確認します。アクティブ化されていない購入者とセグメントを共有すると、追跡されていないデータと課金されないデータ使用量が発生します。「Data Buyer Provider Service」を参照してください。

ヒント

プライベートセグメントは、データ購入者に手動で共有する必要があります。「新しいプライベートセグメントを作成する」の手順 3 に示すように、メンバーデータ共有 API サービスを使用して、セグメント ID を特定の Xandrmembers に共有する必要があります。

新しいプライベートセグメントを作成する

Segment Service API を使用して新しいセグメントオブジェクトを作成します。以下に例を示します。

 "$ cat segment"{
   "segment":{
      "member_id":25,
      "short_name":"remarketing - netflix user",
      "code":"netflix08"
   }
}"$ curl -b cookies -c cookies -d @segment""https://api.adnxs.com/segment/958"

セグメントを "is_public = false" に設定し、セグメント課金カテゴリサービス API を使用して Data Marketplace でセグメントをアクティブ化します。以下に例を示します。

"$ cat create_segment_mapping"{
   "segment-billing-category":{
      "active":true,
      "data_provider_id":1,
      "data_category_id":1001,
      "segment_id":111111,
      "is_public":false
   }
}"$ curl -b cookies -c cookies -X POST -d @create_segment_mapping""https://api.&lt;ph keyref=\"legacy-product-lc\"/>.com/segment-billing-category?member_id=958"

セグメントを表示する必要がある購入者とプライベートセグメントを共有します。以下に例を示します。

"$ cat data_share_single"{
   "member_data_sharing":{
      "buyer_member_id":105,
      "segment_exposure":"list",
      "segments":[
         {
            "id":121175
         },
         {
            "id":121176
         },
         {
            "id":121177
         },
         {
            "id":121178
         }
      ]
   }
}"$ curl -b cookies -c cookies -X POST -d @data_share_single""https://api.&lt;ph keyref=\"legacy-product-bidders-lc\"/>.com/member-data-sharing?data_member_id=958"

パブリックセグメントをプライベートに変更する

セグメント課金カテゴリサービス API を使用して、セグメントを "プライベート" に変更します。以下に例を示します。
```
"$ cat create_segment_mapping"{
   "segment-billing-category":{
      "active":true,
      "data_provider_id":1,
      "data_category_id":1001,
      "segment_id":111111,
      "is_public":false
   }
}"$ curl -b cookies -c cookies -X PUT -d @create_segment_mapping""https://api.appnexus.com/segment-billing-category?member_id=958&amp;id=77777"
```
注:

Xandr は、すべての新しい Data Marketplace 購入者へのこのセグメントの共有を停止します。このセグメントに既にアクセスできる Data Marketplace 購入者は、引き続きセグメントにアクセスできます。
メンバーデータ共有サービス API を使用して既存の共有レコードの共有を解除します。

プライベートセグメントをパブリックに変更する

セグメント課金カテゴリサービス API を使用して、セグメントを "プライベート" に変更します。以下に例を示します。

"$ cat create_segment_mapping"{
   "segment-billing-category":{
      "active":true,
      "data_provider_id":1,
      "data_category_id":1001,
      "segment_id":111111,
      "is_public":true
   }
}"$ curl -b cookies -c cookies -X PUT -d @create_segment_mapping""https://api.appnexus.com/segment-billing-category?member_id=958&amp;id=77777"

注:

Xandr は、このセグメントをすべての Data Marketplace 購入者と自動的に共有します。

次の方法で共有

パブリックセグメントとプライベート (カスタム) セグメントの管理