このページの概要
Bing(Microsoft Advertising)で取得した MSCLKID をサブスクライン経由で Bing の「ApplyOfflineConversions」API にポストバックすることで、LINE 内の購入・登録イベントを 広告キャンペーンの CV として即時帰属 できます。
実装はサブスクラインの汎用エンドポイント /postback/post
を利用します。Bing 側では オフライン コンバージョン ゴール を 1 つ作成し、自動タグ付けを有効化するだけで準備完了です。
1. 対象読者・前提
-
サブスクライン導入済みで、自動応答シナリオの編集権限があるマーケター
-
Microsoft Advertising の管理画面にログインでき、開発者トークン・OAuth 2.0 クライアントを保有していること
-
広告ランディング URL で
?msclkid={msclkid}
が自動付与される設定(Auto-Tagging)が有効であること Microsoft Learn
2. Bing 広告のコンバージョン API とは
要素 | 説明 |
---|---|
MicrosoftClickId (MSCLKID) | 広告クリック毎に発行される一意 ID。オフライン CV 帰属のキーになる Microsoft Learn |
ApplyOfflineConversions | REST/SOAP 両方で提供される公式エンドポイント。1 リクエスト最大 1,000 件までアップロード可 Microsoft Learn |
必須パラメータ |
MicrosoftClickId ConversionName ConversionTime ConversionCurrencyCode (任意で ConversionValue ) Microsoft Learn
|
計測可能期間 | クリック後 1 分〜90 日以内(ゴール設定の「コンバージョン ウィンドウ」で変更可) Microsoft LearnMicrosoft Answers |
ポイント
オフライン ゴールを作成後、最初のアップロードまでは 2 時間待機 が推奨されています Microsoft Learn。
3. Bing 広告側の設定手順
3-1. MSCLKID の自動タグ付けを ON
-
Microsoft Advertising > 「すべてのキャンペーン」> 左メニュー [アカウントの設定]
-
「自動タグ付け」>「Microsoft Click ID(MSCLKID)」を有効 にする
-
これによりクリック URL へ
msclkid={msclkid}
が自動付与されます Microsoft Learn
-
3-2. オフライン コンバージョン ゴールを新規作成
-
[ツール] > [コンバージョン追跡]
-
「+目標を作成」> [オフライン] を選択
-
ゴール名(例:
Subscline_Lead
)と計測期間を指定し保存
後で URL テンプレートの
##BING_CONVERSION_NAME##
に使用します。
3-3. 開発者トークン & OAuth 資格情報の取得
-
開発者トークン: Microsoft Advertising API 申請画面で発行
-
OAuth クライアント ID / Secret: Azure ポータル > アプリ登録
-
トークン取得フローは既存の Meta 連携と同様に
client_credentials
で OK
3-4. アカウント識別子の確認
-
CustomerId / AccountId は管理画面右上の「アカウント概要」>「アカウント番号」で確認
4. サブスクラインでの自動応答設定
-
自動応答シナリオで成果条件(例: 決済完了)を設定
-
「ポストバック通知 URL」 に下記テンプレートを登録
-
文字列全体を URL エンコードして保存(改行不要)
https://api.subscline.jp/api/v1/client/##CLIENT_ID##/postback/post
?header={
"Authorization":"Bearer+##MICROSOFT_ACCESS_TOKEN##",
"DeveloperToken":"##DEVELOPER_TOKEN##",
"CustomerId":"##CUSTOMER_ID##",
"CustomerAccountId":"##ACCOUNT_ID##",
"Content-Type":"application/json"
}
&body={
"OfflineConversions":[
{
"MicrosoftClickId":"{referer.msclkid}",
"ConversionName":"##BING_CONVERSION_NAME##",
"ConversionTime":"{{now}}",
"ConversionValue":0,
"ConversionCurrencyCode":"JPY"
}
]
}
&url=https://campaign.api.bingads.microsoft.com/Api/Advertiser/CampaignManagement/v13/CampaignManagementService.svc/ApplyOfflineConversions
変数 | 説明 |
---|---|
##CLIENT_ID## |
サブスクラインのクライアント ID |
##MICROSOFT_ACCESS_TOKEN## |
OAuth で発行したアクセス トークン |
##DEVELOPER_TOKEN## |
Microsoft Advertising 開発者トークン |
##CUSTOMER_ID## / ##ACCOUNT_ID## |
広告アカウント識別子 |
##BING_CONVERSION_NAME## |
3-2 で作成したゴール名 |
5. トラブルシューティング
症状 | 原因と対処 |
---|---|
400 InvalidAuthenticationToken | アクセストークンの期限切れ。再発行し header を更新 |
Conversion goal not found |
ConversionName の綴り違い。UI 上の正式名称を確認 |
msclkid が空 | ランディング URL に msclkid パラメータが付与されていない → 自動タグ付け設定を再確認 Microsoft Learn
|
反映が遅い | 6 時間待機 & API 送信直後は「保留」ステータスになる仕様 excelinppc.com |
6. よくある質問
Q1. コンバージョン値を可変で送信できますか
A. ConversionValue
を動的に置換することで可能です。
Q2. クリックから 90 日を超えた売上は登録できますか
A. いいえ。90 日を超えると API 側で受理されません Microsoft Answers。
Q3. 1 リクエスト当たり複数 CV を送信したい
A. OfflineConversions
配列に最大 1,000 件まで追加可能です Microsoft Learn。