このページでは、アドレポにTiktokのアカウントを登録し、データ取得を可能にする方法について説明しています。
Tiktok広告のデータをアドレポで取得するにあたってはTikTok上でAPIを有効化する必要があります。
事前準備を完了させた上で、認証を行っていただきますようお願いします。
※事前準備完了まで数日間の時間がかかりますのでご注意ください。
手順の概要
1､事前準備（Tik Tokデベロッパー登録）
2､事前準備（App IDの作成）
3､事前準備（ホワイトリスト機能の申請）
※「1」〜「3」はTikTok側での対応となります。
※アカウント単位で事前準備が必要となります。すでに事前準備にて登録等行ったアカウントであれば「4､ログインアカウント情報の登録」にお進みください。
※「2､事前準備（App IDの作成）」及び「3､事前準備（ホワイトリスト機能の申請）」ともに【承認済み】の確認を前に、次の「4、ログインアカウント情報の登録」へ進んでしまうと【初回データ取得に失敗します】。必ず事前準備の完了を行ってください。
4､ログインアカウント情報の登録
※「4」はアドレポ側での対応となります。
1、事前準備（TikTokデベロッパー登録）
（1）TikTok API for Businessにログインし、画面内の「デベロッパーになる」を選択ください。
※すでにデベロッパーに登録されている場合は、「デベロッパーになる」の表示が現れません。2､事前準備（App IDの作成）の手順にお進みください。
（2）画面の表示にしたがって、必要事項を入力してください。
（3）「あなたやあなたの会社に最もあてはまるもの選択してください。」では、いづれかを選択ください。
「直接的な広告主」または「代理店」のどちらかを選択してください。
（4）「TikTokのデータやAPIをどのように使用するのか、英語で記入してください。 できるだけ詳細な説明をお願いします。」では、以下英文を入力してください。
上記質問には以下のように回答いただければと思います。
「To load ads delivery results for analysis and reporting.」
（5）画面内の送信をクリックすると、TikTokデベロッパーの登録が完了します。
2､事前準備（App IDの作成）
（1）TikTok API for Businessにログインし、画面上部の「App ID管理」をクリックしてください。
（2）「アプリの新規作成」をクリックしてください。
※アプリをすでに登録済みの場合は、以下「App IDを新規作成する」をクリックしてください。
（3）必要な情報を入力してください。
1：アプリケーション名
→任意の名称（「●●社_アドレポレポーティング用App」など）
2：アプリケーション説明
→「？」に記載の下記4項目についてご記入ください。
1.会社の主な事業内容
2.必要な権限およびその使用場面
3.アカウントの権限付与範囲（自社のみで使用するか、または第三者として他社に権限を付与する必要もあるか）
4.パートナー（もしいれば、広告主アカウントIDとアカウント名を記載）
3：広告主リダイレクトURL
→以下を設定ください。
https://adrepo-etl.client.harbest.jp/oauth/callback/
4：権限範囲
→アドレポでのレポーティングに最低限必要な権限は以下の通りです。
以下の権限を付与いただくようお願いいたします。
①広告アカウントの管理＞広告アカウント情報＞広告アカウント情報の読み取り
②利用規約＞利用規約
③広告の管理
＞キャンペーン＞キャンペーンの読み取り
＞ 広告グループ＞広告グループの読み取り
＞ 広告＞広告の読み取り
④レポートの作成
＞広告アカウントレベル
＞キャンペーンレベル
＞広告グループレベル
＞広告レベル
＞オールインワンレポート
＞Ad Insight Report
（4）登録完了後、数日で当該のAPPの承認ステータスが「承認済み」となり、ご登録可能な状態となります。
※「承認済み」にならない場合は、Tiktokにお問い合わせください。
3、事前準備（ホワイトリスト機能の申請）
（1）アプリの承認ステータスが「承認済み」になった後に、作成したアプリ名をクリックしてください。
（2）画面内の「①ホワイトリスト機能管理」をクリックし、「②応用」をクリックしてください。
（3）以下の項目を入力して、「応用」をクリックしてください。
1：アプリの特徴選択
→「非同期レポート」を選択
２：潜在的な収益への影響
→未入力
（4）数日中にホワイトリスト権限管理の承認ステータスが「承認済み」になれば事前準備は完了です。
4、ログインアカウント情報の登録
（1）アドレポの「広告主情報変更」よりTiktok 広告主情報の「アカウント設定ボタン」をクリックします。
（2）アカウント登録画面にて以下を登録します。
1：表示名称
→任意の名称
2：APP ID
→Tiktok広告で作成いただいたアプリのAppID
3：SECRET
→Tiktok広告で作成いただいたアプリのSecret
※Secretのコピー方法について下記補足に記載しています。ご確認の上、アドレポ上にSecretを入力ください。
※補足※
App IDとSecretはTikTok API for Businessの「AppID管理」のページにて確認いただけます。
Secretは下記参考に保存し、アドレポへ登録ください。
（3）アドレポ画面の赤枠箇所に反映されたら、登録は完了です。
5、レポート設定画面での選択方法
レポート作成の際は、下記手順を参考に設定をお進みください。
※過去13か月データ取得に時間がかかる場合もございます。
（1）アドレポ画面左側にある黒いメニューバー内の「広告主選択」プルダウンで、アカウント登録したい広告主名を選択し、「レポート設定」をクリックします。
（2）「新規作成」もしくは、設定を編集したい対象のレポート設定をクリックします。
（3）「出力データ（新規作成）」をクリックします。
すでにある出力データをご利用いただくことも、出力データを追加し作成いただくことも可能です。
（4）広告プラットフォームで「TikTok」を選択し、出力したいレポートに合わせ「レポートタイプ」を選択ください。
