メンバーデータ共有サービス

メンバーデータ共有サービスを使用すると、セグメントを他のプラットフォームメンバーと共有できます。 次に、動作のしくみを示します。

  1. 購入者に、あなた (データ プロバイダー) が Microsoft Invest で有効にするように依頼します。 これを行うために使用する必要がある設定は、Microsoft Invest Segment Manager の [データ プロバイダーの管理] にあります。
  2. セグメントを共有するメンバーの共有レコードを作成します。
  3. 共有レコードで、すべてのセグメントを共有するか、セグメントの特定のリストを共有するかを指定します。
  4. セグメントを共有したメンバーは、キャンペーンでセグメントをターゲットにすることができます (または、入札者の場合は、入札要求ごとにセグメント データが送信されます)。

注:

共有レコードからセグメントを削除すると、メンバーは新規または既存のキャンペーンのターゲティング プロファイルにセグメントを追加できません。 ただし、メンバーが既に既存のキャンペーンのセグメントをターゲットとしている場合、メンバーがキャンペーンのターゲティング プロファイルから手動で削除するまで、キャンペーンはそのセグメントをターゲットとし続けます。 セグメントが削除されると、メンバーはキャンペーンのターゲティング プロファイルに再度そのセグメントを追加できなくなります。

  • 広告主レベルのセグメントは共有できません。 メンバー/ネットワーク レベルのセグメントのみを共有できます。 セグメントを広告主からネットワークレベルに移動するには、セグメントサービスを介してadvertiser_idをNULLに設定できます。
  • 外部統合 DSP に属するバイヤー メンバーとセグメントを共有することはできません。
  • メンバー データ共有サービスは、Xandr の API (api.appnexus.com) とインプレッション バス API (api.adnxs.com) の両方で動作するようになりました。 以下では api.adnxs.com のみが使用されますが、Xandr の API にアクセスできるクライアントの場合、api.appnexus.com に置き換えられる場合があります。 Xandr にいるメンバーのみが API にアクセスできます。 大多数のデータ プロバイダーは、インプレッション バス API にのみアクセスできます。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.adnxs.com/member-data-sharing 既存のすべての共有レコードを表示します。
GET https://api.adnxs.com/member-data-sharing?id=RECORD_ID 特定の共有レコードを表示します。
GET https://api.adnxs.com/member-data-sharing?data_member_id=MEMBER_ID&buyer_member_id=CLIENT_MEMBER_ID
ここで、 data_member_id = メンバー ID、 buyer_member_id = 受信者のメンバー ID		 メンバー ID を使用して共有レコード ID を取得します。
POST https://api.adnxs.com/member-data-sharing?data_member_id=MEMBER_ID
(JSON を共有)

メモ: member-data-sharing オブジェクトは、単数の場合、配列にすることはできません。		 1 つの共有レコードを作成して、1 人のメンバーとセグメントを共有します。
POST https://api.adnxs.com/member-data-sharings?data_member_id=MEMBER_ID
(JSON を共有)

メモ: member-data-sharings (複数形) オブジェクトは、複数形の場合は配列である必要があります。		 複数の共有レコードを作成して、複数のメンバーとセグメントを共有します。
PUT https://api.adnxs.com/member-data-sharing?id=RECORD_ID

注:
- この方法では、既存のセグメントがすべて削除され、セグメントが新しく指定されたリストのみに置き換えられます。
- リストから 1 つ以上のセグメントを削除するには、リスト全体を目的のセグメントに置き換える必要があります。		 共有レコード内で共有されているセグメントの一覧を置き換えます。
PUT https://api.adnxs.com/member-data-sharing?id=RECORD_ID&append=true

メモ: セグメントは、"append" フラグを使用してのみリストに追加でき、削除することはできません。		 共有レコード内の共有セグメント リストからのセグメントの追加。
DELETE https://api.adnxs.com/member-data-sharing?id=RECORD_ID 共有レコードを削除します。

ヒント

JSON 構造:

単一の共有レコードを追加または更新する場合は、JSON を "member_data_sharing" と呼ばれる単一のオブジェクトとして構成する必要があります。 複数の共有レコード POST を追加する場合は、JSON を "member_data_sharings" (複数形に注意してください) と呼ばれるオブジェクトの配列として構成し、共有データを配列に配置する必要があります。 複数の共有レコードを同時に更新 (PUT) することはできません。 正確な書式設定については、次の 例 を参照してください。

JSON フィールド

フィールド タイプ (長さ) 説明
id int 共有レコードの ID。
既定値: 自動生成された数値
Required On:PUT/DELETE, in query string
data_member_id int 読み取り専用です。 メンバー ID。
buyer_member_id int セグメントを共有しているメンバーの ID。
必須:POST
segment_exposure 列挙 すべてのセグメントまたは特定のセグメントのリストをメンバーと共有するかどうか。 使用可能な値: "all" または "list"。 "all"を選択した場合、新しく作成されたセグメントは自動的に購入者メンバーと共有されます。 特定の購入者だけがアクセスできるカスタム セグメントを作成する場合は、 "list" 露出を使用する必要があります。
必須:POST

メモ:Data Market Place のデータ プロバイダーは、値を "all" として選択して共有レコードを作成segment_exposureしないでください。 そのようなレコードが存在する場合は、値を "list" に更新し、適切なセグメント リストを含めます。
segments オブジェクトの配列 segment_exposureが"list"されている場合は、メンバーと共有しているセグメントのリスト。 書式設定については、最初の例を参照してください。
必須日付:POST/PUT ( segment_exposure が "list"の場合)。

例

メンバー 103 および 104 とセグメントを共有する

$ cat data_share_multiple
{
    "member_data_sharings": [
        {
            "buyer_member_id": 103,
            "segment_exposure": "all"
        },
        {
            "buyer_member_id": 104,
            "segment_exposure": "list",
            "segments": [
                {
                    "id": 121175
                },
                {
                    "id": 121176
                },
                {
                    "id": 121177
                },
                {
                    "id": 121178
                }
            ]
        }
    ]
}
$ curl -b cookies -c cookies -X POST -d @data_share_multiple 'https://api.adnxs.com/member-data-sharing?data_member_id=1432'
{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": null,
        "num_elements": null,
        "id": [
            54,
            55
        ],
        "member_data_sharings": {
            "54": {
                "id": 54,
                "data_member_id": 1432,
                "buyer_member_id": 103,
                "segment_exposure": "all",
                "segments": null
            },
            "55": {
                "id": 55,
                "data_member_id": 1432,
                "buyer_member_id": 104,
                "segment_exposure": "list",
                "segments": [
                    {
                        "id": 121175,
                        "name": "Segment share 1"
                    },
                    {
                        "id": 121176,
                        "name": "Segment share 2"
                    },
                    {
                        "id": 121177,
                        "name": "Segment share 3"
                    },
                    {
                        "id": 121178,
                        "name": "Segment share 4"
                    }
                ]
            }
        },
        "dbg": {
        ...
        }
    }
}

メンバー 105 とセグメントを共有する

$ cat data_share_single
{
    "member_data_sharing": {
        "buyer_member_id": 105,
        "segment_exposure": "all"
    }
}
$ curl -b cookies -c cookies -X POST -d @data_share_single 'https://api.adnxs.com/member-data-sharing?data_member_id=1432'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "id": "56",
        "member_data_sharing": {
            "id": 56,
            "data_member_id": 1432,
            "buyer_member_id": 105,
            "segment_exposure": "all",
            "segments": null
        },
        "dbg": {
            ...
        }
    }
    }

メンバー 104 の共有レコードを更新する

この例では、 PUT 要求は、共有レコード55(メンバー104の共有レコード)にセグメント121179を追加します。

$ cat data_share_update
{
    "member_data_sharing": {
        "segments": [
            {
                "id": 121175
            },
            {
                "id": 121176
            },
            {
                "id": 121177
            },
            {
                "id": 121178
            },
            {
                "id": 121179
            }
        ]
    }
}
$ curl -b cookies -c cookies -X PUT -d @data_share_update 'https://api.adnxs.com/member-data-sharing?id=55'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "id": 55,
        "member_data_sharing": {
            "id": 55,
            "data_member_id": 1432,
            "buyer_member_id": 104,
            "segment_exposure": "list",
            "segments": [
                {
                    "id": 121175,
                    "name": "test for sharing"
                },
                {
                    "id": 121176,
                    "name": "test for sharing2"
                },
                {
                    "id": 121177,
                    "name": "test for sharing3"
                },
                {
                    "id": 121178,
                    "name": "test for sharing4"
                },
                {
                    "id": 121179,
                    "name": "test for sharing4"
                }
            ]
        },
        "dbg": {
            ...
        }
    }
}

すべての共有記録を表示する

$ curl -b cookies -c cookies 'https://api.adnxs.com/member-data-sharing'
{
    "response": {
        "status": "OK",
        "count": 5,
        "start_element": null,
        "num_elements": null,
        "member_data_sharings": [
            {
                "id": 46,
                "data_member_id": 1432,
                "buyer_member_id": 100,
                "segment_exposure": "all",
                "segments": null
            },
            {
                "id": 52,
                "data_member_id": 1432,
                "buyer_member_id": 101,
                "segment_exposure": "all",
                "segments": null
            },
            {
                "id": 53,
                "data_member_id": 1432,
                "buyer_member_id": 102,
                "segment_exposure": "all",
                "segments": null
            },
            {
                "id": 54,
                "data_member_id": 1432,
                "buyer_member_id": 103,
                "segment_exposure": "all",
                "segments": null
            },
            {
                "id": 55,
                "data_member_id": 1432,
                "buyer_member_id": 104,
                "segment_exposure": "list",
                "segments": [
                    {
                        "id": 121175,
                        "name": "Segment share 1"
                    },
                    {
                        "id": 121176,
                        "name": "Segment share 2"
                    },
                    {
                        "id": 121177,
                        "name": "Segment share 3"
                    },
                    {
                        "id": 121178,
                        "name": "Segment share 4"
                    },
                    {
                        "id": 121179,
                        "name": "Segment share 5"
                    }
                ]
            },
            {
                "id": 56,
                "data_member_id": 1432,
                "buyer_member_id": 105,
                "segment_exposure": "all",
                "segments": null
            }
        ],
        "dbg": {
            ...
        }
    }
}

共有レコードの表示 55

$ curl -b cookies -c cookies 'https://api.adnxs.com/member-data-sharing?id=55'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "member_data_sharing": {
            "id": 55,
            "data_member_id": 1432,
            "buyer_member_id": 104,
            "segment_exposure": "list",
            "segments": [
                {
                    "id": 121175,
                    "name": "Segment share 1"
                },
                {
                    "id": 121176,
                    "name": "Segment share 2"
                },
                {
                    "id": 121177,
                    "name": "Segment share 3"
                },
                {
                    "id": 121178,
                    "name": "Segment share 4"
                },
                {
                    "id": 121179,
                    "name": "Segment share 5"
                }
            ]
        },
        "dbg": {
            ...
        }
    }
}
  • Last updated on