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