Microsoft Customer Match 構成ガイド
この記事では、Microsoft Customer Match コネクタの構成方法について説明します。
API 情報
このコネクタは以下のベンダー API を使用します:
- API 名:Bulk API
- API バージョン:v13
- API エンドポイント:
https://bulk.api.bingads.microsoft.com/Api/Advertiser/CampaignManagement/V13/BulkService.svc
- ドキュメント:Bulk API
バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます:
- 最大リクエスト数:100000
- 最古のリクエストからの最大時間:60分
- リクエストの最大サイズ:100 MB
コネクタアクション
アクション名 | AudienceStream | EventStream |
---|---|---|
ユーザーをオーディエンスに追加 | ✓ | ✗ |
オーディエンスからユーザーを削除 | ✓ | ✗ |
構成の構成
コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタを追加する一般的な手順については、About Connectorsを参照してください。
コネクタを追加した後、以下の構成を構成します:
- アカウントID
(必須) リクエスト内のエンティティを所有または関連付けている広告アカウントの識別子です。
Microsoft Ads UIに広告主がログインしたときのURL(例:AID=
)で見つけることができます。 - 顧客ID
(必須) ユーザーがアクセスまたは操作しているマネージャーアカウント(顧客)の識別子です。
広告主がMicrosoft Ads UIにログインしたときのURL(例:CID=
)で見つけることができます。
アカウントID と 顧客ID を構成した後、接続を確立 をクリックして Microsoft のサーバーに接続します。
顧客マッチリストの作成
このオプションを使用して、広告対象の加入者を追加する顧客マッチリストを作成します。結果の リクエストID 値を使用して、リスト作成プロセスが完了したかどうかを判断できます。
作成 ボタンをクリックした後、確認メッセージを受け取るまでお待ちください。顧客リストが正常にアップロードされた場合、インターフェースはアップロードの リクエストID を表示します。リクエストID をコピーして、アップロード状況を確認するために使用できます。
フィールド | 説明 |
---|---|
名前 | (必須) 顧客リストの名前。このフィールドには最大128文字を含めることができます。 |
説明 | (任意) 顧客リストの説明。この顧客リストでターゲットにしているオーディエンスを覚えておくために説明を使用します。このフィールドには最大1,024文字を含めることができます。 |
親ID | (任意) 顧客リストを含む顧客のMicrosoft Advertising識別子。 |
クライアントID | (任意) バルクアップロードファイルのレコードを結果ファイルのレコードと関連付けるために使用されます。このフィールドには最大100文字の有効な文字列を使用できます。 |
メンバーシップ期間 | (任意) 顧客リストを作成するとき、Microsoft Advertisingにあなたの顧客リスト定義に一致するアクションを検索してリストに人々を追加するために遡る時間を指定できます。
|
アップロード状況の確認
このオプションを使用して、リスト作成とアップロード状況を確認します。これにより、顧客が適切なリストに登録されていることを確認できます。
アップロード状況が Completed
または CompletedWithErrors
の場合、結果ファイルのURLが表示されます。このURLを使用して結果ファイルをダウンロードします。URLは、アップロード状況を表示するCheck the Status操作から5分後に期限切れになります。この期間内にダウンロードを開始しない場合、新しいURLを取得するために再度状況を確認する必要があります。
フィールド | 説明 |
---|---|
リクエストID | アップロードリクエストの識別子。 |
アクション
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
オーディエンスにユーザーを追加
パラメータ
パラメータ | 説明 |
---|---|
顧客マッチリストID | 顧客マッチリストIDを入力してください。 顧客マッチリストIDを見つけるには:Microsoft Advertising UIにログインし、ツールを選択してからオーディエンスタブをクリックします。 注意:顧客リストデータをアップロードする前に、Microsoft Advertising UIで利用規約に同意する必要があります。 |
Email Address (already SHA256 hashed) | すでにSHA256ハッシュされたメールアドレスを提供してください。 |
Email Address (apply SHA256 hash) | プレーンテキストのメールアドレスを提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュします。 |
オーディエンスからユーザーを削除
パラメータ
パラメータ | 説明 |
---|---|
顧客マッチリストID | 顧客マッチリストIDを入力してください。 顧客マッチリストIDを見つけるには:Microsoft Advertising UIにログインし、ツールを選択してからオーディエンスタブをクリックします。 注意:顧客リストデータをアップロードする前に、Microsoft Advertising UIで利用規約に同意する必要があります。 |
Email Address (already SHA256 hashed) | すでにSHA256ハッシュされたメールアドレスを提供してください。 |
Email Address (apply SHA256 hash) | プレーンテキストのメールアドレスを提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュします。 |
最終更新日 :: 2023年March月22日