このページでは、アドレポにTiktokのアカウントを登録し、データ取得を可能にする方法について説明しています。
アカウント登録時の注意点
Tiktok広告のデータをアドレポで取得するにあたってはTikTok上でAPIを有効化する必要があります。
事前準備をすべて完了させた上で、認証を行っていただきますようお願いします。
※事前準備完了まで数日間の時間がかかりますのでご注意ください。
データ取得時の注意点
前日データは11時間程度、値の反映タイミングのズレが発生する可能性があります。
(例)前日の午後13時～24時の11時間分のデータ集計が媒体側で終わらず、媒体仕様によりレポート数値が乖離する場合がございます。
手順の概要
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にログインし、画面内の「Become a Developer」を選択ください。
※すでにデベロッパーに登録されている場合は、「Become a Developer」の表示が現れません。2､事前準備（App IDの作成）の手順にお進みください。
（2）画面の表示にしたがって、必要事項を入力してください。
※「In English, please describe how you plan to use TikTok data and/or APIs. Please be descriptive」では、以下英文を入力してください。
「To load ads delivery results for analysis and reporting.」
（3）画面内のSubmitをクリックすると、TikTokデベロッパーの登録が完了します。
2､事前準備（App IDの作成）
（1）TikTok API for Businessにログインし、画面右上部の「My AppMy Apps」をクリックしてください。
（2）「Create an App」をクリックしてください。
※アプリをすでに登録済みの場合は、以下「Create App」をクリックしてください。
（3）必要な情報を入力してください。
1：App name
→任意の名称（「●●社_アドレポレポーティング用App」など）
2：App description
→「？」に記載の下記4項目についてご記入ください。
1.会社の主な事業内容
2.必要な権限およびその使用場面
3.アカウントの権限付与範囲（自社のみで使用するか、または第三者として他社に権限を付与する必要もあるか）
4.パートナー（もしいれば、広告主アカウントIDとアカウント名を記載）
3：Advertiser redirect URL
→以下を設定ください。
https://adrepo-etl.client.harbest.jp/oauth/callback/
4：Scope of permission
→アドレポでのレポーティングに最低限必要な権限は以下の通りです。
以下の権限を付与いただくようお願いいたします。
①Ad Account Management＞Ad Account Information＞Read Ad Account Information
②利用規約＞利用規約
③Ads Management
＞Campaign＞Read Campaigns
＞ Ad Group＞Read Ad Groups
＞Ad＞Read Ads
④Reporting
＞Consolidated Report
＞Ad Insight Report
＞Creative Fatigue Insight
＞GMV Max Report
＞Upgraded Smart+ Report
（4）登録完了後、数日で当該のAPPのVerification Statusが「Approved」となり、ご登録可能な状態となります。
※「Approved」にならない場合は、Tiktokにお問い合わせください。
3、事前準備（ホワイトリスト機能の申請）
（1）アプリの承認ステータスが「Approved」になった後に、作成したApp Nameをクリックしてください。
（2）画面内の「Allowlist Management」をクリックし、「Apply」をクリックしてください。
（3）以下の項目を入力して、「Submit」をクリックしてください。
1：アプリの特徴選択
→「Asynchronous Report」を選択
２：潜在的な収益への影響
→未入力
（4）数日中にAuthorization statusが「Authorized」になれば事前準備は完了です。
4、ログインアカウント情報の登録
（1）アドレポの「広告主情報変更」よりTiktok 広告主情報の「アカウント設定ボタン」をクリックします。
（2）アカウント登録画面にて以下を登録します。
1：表示名称
→任意の名称
2：APP ID
→Tiktok広告で作成いただいたアプリのAppID
3：SECRET
→Tiktok広告で作成いただいたアプリのSecret
※Secretのコピー方法について下記補足に記載しています。ご確認の上、アドレポ上にSecretを入力ください。
※補足※
App IDとSecretはTikTok API for Businessの「My Apps」のページにて確認いただけます。
上記参考に保存し、アドレポへ登録ください。
（3）アドレポ画面の赤枠箇所に反映されたら、登録は完了です。
5、レポート設定画面での選択方法
レポート作成の際は、下記手順を参考に設定をお進みください。
※過去13か月データ取得に時間がかかる場合もございます。
（1）アドレポ画面左側にある黒いメニューバー内の「広告主選択」プルダウンで、アカウント登録したい広告主名を選択し、「レポート設定」をクリックします。
（2）「新規作成」もしくは、設定を編集したい対象のレポート設定をクリックします。
（3）「出力データ（新規作成）」をクリックします。
すでにある出力データをご利用いただくことも、出力データを追加し作成いただくことも可能です。
（4）広告プラットフォームで「TikTok」を選択し、出力したいレポートに合わせ「レポートタイプ」を選択ください。
