概要
X-log.aiにてYahoo広告経由アクセスを検知、集計、API連携することで対策までできるよう、設定します。
ディスプレイ広告（旧YDN）を出稿中の場合、別途設定が必要です。
・検知：Yahoo広告にて自動タグを設定します。X-log.aiにてYahoo広告経由アクセスであることが検知できます。
・集計：Yahoo広告のトラッキングURLにて専用パラメータを設定します。キーワードなど広告関連情報が取得できます。
・API連携：X-log.aiにてYahooアカウント（ディスプレイ広告のみ）を連携します。X-log.aiからYahoo広告の配信先除外が登録できます。X-logパラメータ設定も自動で行われます。
検索広告の場合
１．Yahoo広告の管理者画面より「自動タグ設定」の設定を行ってください。
１）「アカウント管理」をクリックします。
２）広告出稿中のアカウントの「確認」をクリックします。
３）「アカウント設定情報を変更」をクリックします。
４）自動タグ設定の「設定する」をチェックします。（※チェック済みの場合は、変更不要です。）
５）「変更内容の確認へ」をクリックします。
６）トラッキングの自動タグ設定が「設定する」に変わっていることを確認してください。
７）「決定」をクリックします。
２．キーワードなどが取得できるよう、トラッキングURLにパラメータを付与します。
【事前確認】
１）「トラッキングURL」が設定されている階層があるかを確認します。
※Yahoo管理画面「ダウンロード＞全キャンペーンのダウンロードファイルを作成（広告グループ・キーワード・広告含む）」のcsvファイルにて「トランキングURL」項目から設定状況が簡単に確認できます。
a）未設定の場合、アカウント単位でX-logパラメータを設定します。
b）設定中の場合、設定中の階層の後尾にX-logパラメータを追記します。
２）最終リンク先URL、または、トラッキングURLに既にパラメータが付与されているかを確認します。
a）パラメータ未付与の場合、X-logパラメータを「?」でつなげます。
{lpurl}?ysad={creative}&yskw={keyword}&ysti={targetid}&ysmt={matchtype}&ysfi={feeditemid}&ysdv={device}&yscp={campaignid}
b）パラメータ付与済みの場合、X-logパラメータを「&」でつなぎます。
{lpurl}&ysad={creative}&yskw={keyword}&ysti={targetid}&ysmt={matchtype}&ysfi={feeditemid}&ysdv={device}&yscp={campaignid}
{lpurl}?utm_source=yahoo&ysad={creative}&yskw={keyword}&ysti={targetid}&ysmt={matchtype}&ysfi={feeditemid}&ysdv={device}&yscp={campaignid}
【トラッキングURLへのパラメータ付与手順】
アカウント単位で専用パラメータを付与する方法を説明します。（１）-a）＆２）-a）の場合）
下層は数分の作業が必要です。（例）出稿中のキャンペーンが３つある場合、３つのキャンペーンにてパラメータを付与）
※１の自動タグ設定画面から付与できます。
１）「アカウント管理」をクリックします。
２）広告出稿中のアカウントの「確認」をクリックします。
３）「アカウント設定情報を変更」をクリックします。
４）URLオプションの「オプション設定（URLオプション）」をクリックし入力欄を表示します。
５）トラッキング URLの入力欄に下記パラメータを入力します。
・パラメータ未使用の場合
{lpurl}?ysad={creative}&yskw={keyword}&ysti={targetid}&ysmt={matchtype}&ysfi={feeditemid}&ysdv={device}&yscp={campaignid}
・パラメータ使用中の場合、「&」で追記
{lpurl}?utm_source=yahoo&ysad={creative}&yskw={keyword}&ysti={targetid}&ysmt={matchtype}&ysfi={feeditemid}&ysdv={device}&yscp={campaignid}
６）「変更内容の確認へ」をクリックします。
７）URLオプションに設定したパラメータが付与されていることを確認します。
８）「決定」をクリックします。
【パラメータについて】
パラメータ設定によりX-log.aiにて下記データが取得できます。
・{creative}：出稿中の広告のトラッキング用IDが取得できます。
・{keyword}：出稿中のキーワードが解析できます。
・{targetid}：広告表示につながったキーワードID、サイトリターゲティング のターゲットリストID、動的検索連動型広告のターゲット設定IDが取得できます。
・{matchtype}：表示されたキーワードのマッチタイプが取得できます。
・{feeditemid}：広告クリックされた広告表示オプショのIDが取得できます。（広告表示オプションを使用する場合のみ）
・{device}：広告クリックされたデバイスが取得できます。
・{campaignid}：出稿中のキャンペーンの「キャンペーントラッキングID」が取得できます。
※必要に応じてvaluetrackパラメータを追加することも可能です。
・{adgroupid}：出稿中の広告グループの「広告グループトラッキングID」が取得できます。
※注意：「広告トラッキングID、広告グループトラッキングID、キャンペーントラッキングID」は、トラッキング専用のIDとなっており、「広告ID、広告グループID、キャンペーンID」とは異なります。
ディスプレイ広告（旧YDN）の場合
１．X-log.aiにてYahoo広告アカウントを連携させます。
Yahoo広告のアカウントをX-log.aiと連動させます。
aiが不要と判断した配信先を配信先除外リスト（プレイスメントリスト管理）へ登録し、広告自体が表示されないよう、対策します。
１）「各種設定＞広告関連＞アカウント設定」をクリックします。
※「広告アカウント連携前の確認事項」を確認し、チェックしてください。
※すべての項目に確認した場合のみ、API連携をご利用いただけますこと、ご了承ください。
２）Yahoo広告アカウントへログインします。
３）「承認」をクリックし、X-log.aiからYahooへのアクセスを許可します。
４）Yahoo広告アカウントとX-log.ai連携登録完了を確認します。
５）「各種設定＞広告関連」画面にてF5を押して、画面を更新します。
※アカウントIDが複数ある場合、連携するアカウントIDを１つ選択します。
６）YahooアカウントIDとプレースメントリストを確認します。
※登録中のプレースメントリストが９９リスト以下の場合、X-log.ai専用リストが追加されるだけのため、配信先リストは表示されません。
７）必要なデータをcsvファイルよりダウンロードします。
８）プレースメントリストを既に１００リスト使用中の場合、リストからX-log.ai専用リストに変更したいものを１つ選択し、「選択したリストを使用」をクリックします。
９）「Yahooディスプレイ広告＞ツール＞プレイスメントリスト管理」画面より「x_log_ai_placement」リストができていることを確認します。
※検索型とディスプレイ型のアカウントが異なります。
ご確認の上で、設定をお願いいたします。
２．Yahooディスプレイ広告の管理画面より「自動タグ設定」の設定を行ってください。
１）「すべてのキャンペーン＞アカウント設定」をクリックします。
２）アカウント編集の「編集」をクリックします。
３）自動タグ設定の「設定する」をチェックします。（※チェック済みの場合は、変更不要です。）
４）「保存」をクリックします。
３．配信中の広告のリンク先URLの「形式」とパラメータ付与有無を確認し、付与先にパラメータを付与します。
１）「すべてのキャンペーン＞広告」画面を開きます。
２）「表示項目＞表示項目を編集」をクリックします。
３）下記２つの項目が入っているか確認します。
・最終リンク先URL、リンク先URL
チェックされていない場合、チェックして「適用」をクリックします。
チェック済みの場合、「キャンセル」をクリックします。
４）「ダウンロード＞一覧情報CSVファイル」をクリックします。
５）csvファイルから配信中の広告の飛び先URLが設定された形式とパラメータ付与有無を確認します。
下記例の場合、配信中の広告が「最終リンク先URL」形式のみ、パラメータ未付与となっています。
・「最終リンク先URL」形式が存在する場合、「トラッキングURL」にてパラメータを付与します。
・「リンク先URL」形式が存在する場合、変更及び保存ができないため、「最終リンク先URL」形式に変更する必要があります。
a）パラメータが存在する場合、「?」でX-logパラメータを付与します。
?ydad={creative}&ydap={isApp}&ydcp={campaignid}&ydmd={media}
b）パラメータが存在しない場合「&」でX-logパラメータを付与します。
&ydad={creative}&ydap={isApp}&ydcp={campaignid}&ydmd={media}
【事前確認】
１）「リンク先URL」に他のパラメータが付与されているかを確認します。
a）未設定の場合、リンクURLの最後尾に「?」でX-logパラメータを追記します。
?ydad={creative}&ydap={isApp}&ydcp={campaignid}&ydmd={media}
b）設定中の場合、リンクURLの最後尾に「&」でX-logパラメータを追記します。
&ydad={creative}&ydap={isApp}&ydcp={campaignid}&ydmd={media}
【トラッキングURLへのパラメータ付与手順】
アカウント単位で専用パラメータを付与する方法を説明します。（下層は数分作業が必要）
※１の自動タグ設定画面から付与できます。
１）「すべてのキャンペーン＞アカウント設定」をクリックします。
２）アカウント編集の「編集」をクリックします。
３）URLオプションを「指定する」に変更します。
４）トラッキング URLの入力欄にパラメータを入力します。
・パラメータ未使用の場合、下記パラメータをコピーして貼り付けます。
{lpurl}?ydad={creative}&ydap={isApp}&ydcp={campaignid}&ydmd={media}
・パラメータ使用中、または、トラッキングURLを設定中の場合、「&」でX-logパラメータを追記します。
{lpurl}&ydad={creative}&ydap={isApp}&ydcp={campaignid}&ydmd={media}
{lpurl}?utm_source=yahoo&ydad={creative}&ydap={isApp}&ydcp={campaignid}&ydmd={media}
５）「URLをテストする」をクリックします。
６）ボップアップ画面の「URL」にて設置したパラメータが入っているかを確認します。
※テスト結果が１件も存在しない場合、リンク先形式が「最終リンク先URL」の広告が１件もないこととなります。
７）「閉じる」をクリックします。
８）「保存」をクリックします。
※各層のトラッキングURL設定状況を確認してください。
※トラッキングURLは複数の階層にて設定ができますが、重複設定の場合、最下層が優先されます。
※下層のトラッキングURLが存在する場合、最下層のトラッキングURLにパラメータを設定してください。
【パラメータについて】
パラメータ設定によりX-log.aiにて下記データが取得できます。
・{creative}：出稿中の広告IDが取得できます。
・{isApp}：アプリに配信されたかが取得できます。
・{campaignid}：出稿中のキャンペーンIDが取得できます。
・{media}：出稿中の画像IDが取得できます。
※必要に応じてvaluetrackパラメータを追加することも可能です。
・{adgroupid}：出稿中の広告グループIDが取得できます。
連携でエラーになる時
まず、下記３つをご確認ください。
１．既にYahoo広告側にて「アクセス権限」が許可されているか
一度X-logアカウントと連携したことがある場合、
既にYahoo広告側にてアクセス権限が許可されている可能性があります。
Yahoo広告側よりアクセス権限を削除（広告アカウント連携解除方法の３）の手順から）してから、再度連携してください。
https://connect-business.yahoo.co.jp/cooperation
２．広告アクセスへのアクセス権限種類が条件を満たしていないか
代理店など広告運用代行などで、広告アクセスへアクセス権限を付与されたアカウントの場合、
広告アカウントへ招待された際、アクセス権限が「標準」または「登録更新権限」以上であるか、確認してください。
「登録更新権限」以上（「登録更新権限」または「管理権限」の場合のみ、連携可能です）
https://ads.yahoo.co.jp/manager/redirect?to=/authority/search/アカウントID（数字）/accountAccess
Yahoo広告は、管理者のみ「アクセス権限」が確認できます。
また、招待時のメールに「付与された権限」が記載されています。
３．別のX-logアカウントと連携しているか
X-logアカウントを複数お持ちの場合、
連携希望の広告アカウントIDが、別のX-logアカウントと連携中の可能性があります。
X-logアカウントと広告アカウントIDは１対１となりますため
別のX-logアカウントとの連携を解除してから、再度連携してください。
上記でエラーが解消されない場合、X-log管理画面の「お問い合わせ」メニューよりカスタマサポートまでお問い合わせください。
お問い合わせの際は、下記情報をご共有ください。
・エラーまでの操作内容（操作手順を詳しくご記入ください）
・エラー時の画面キャプチャー
・広告アカウントを複数お持ちの場合、連携希望の「広告アカウントID（数字）」と「広告アカウント名」をご記入ください。
※X-log管理画面の「お問い合わせ」画面以外からお問い合わせの場合、ご利用中のユーザーIDをご共有ください。