1. ecforce AIdp faq
  2. コネクション
コネクション

Tiktok Ads

概要

 Tiktok 広告 Reporting APIを利用して、広告情報を取得します。

接続手順

以下の手順に従い、コネクションを使用するために必要な情報を取得し、ecforce AIdp管理画面にて設定を行ってください。
※コネクション作成画面を別タブで開き、情報の取得とコネクションの設定を同時に行うことを推奨します。

Step 1：TikTok for Businessアカウントを作成する
Step 2：Manage appsからアプリ登録を行う
Step 3：認証情報を取得する
Step 4：コネクションを作成する

Step 1：TikTok for Businessアカウントを作成する

  1. TikTok for Businessアカウントがない場合は、TikTok API for Businessから「Register for TikTok for Business」をクリックしアカウントを作成する
    content_23_01.jpg
  2. アカウント作成後、TikTok API for Businessへアクセスし「Become a Developer」から開発者登録をする
    content_23_02.jpg
  3. 「Bussiness Information」の必須項目を入力する 
    ※「What best describes you or your company?」は「Direct Advertiser」を選択する
    content_23_03.jpg
    content_23_04.jpg

  4. 「Additional Information」の必須項目を入力する

    項目 補足
    Company Website 「Communication Email」のメールアドレスと同一ドメインのURLを入力する
    Communication Email 「Company Website」のURLと同一ドメインのメールアドレスを入力する
    What are your primary use cases for integrating? 「Ad Measurement」「Reporting」を選択する
    In English, please describe how you plan to use TikTok data and/or APIs. Please be descriptive.

    以下を入力する

    Our tool uses API to obtain data from TikTok. 
The acquired data is stored in an internal database and graphed by other BI tools.

    content_23_14.jpg

  5. 承認を待つ
    ※開発者登録の承認には数営業日かかる

Step 2：Manage appsからアプリ登録を行う

  1. Additional Informationの画面で「Submit」をクリックすると以下の画面が表示されるので、「Create an app」を押下する
    content_23_06.jpg
  2. 再度「Create an app」をクリックする
    content_23_07.jpg

  3. Create New Appの画面が表示されるので、必要情報を入力する

    項目 補足
    App Name 「ecforce AIdp」と入力する
    App description

    以下を入力する

    Our company operates an e‑commerce business, selling products through our online store. We use TikTok APPs to promote our products, reach potential customers across Search, Display, drive qualified traffic to our site, and optimize campaigns to increase conversions and revenue.
    Advertiser redirect URL 貴社ホームページのURLを入力する
    Scope of permission 以下を選択する
    ・Ad Account Management
    ・Ads Management
    ・Reporting
    ・Measurement
    content_23_08.jpg
    content_23_09.jpg
  4. 「Submit」をクリックする
  5. 開発者として承認された場合、以下の画面の「Vertification Status」が「Pending」から「Approved」に変わる
    content_23_10.jpg
    content_23_11.jpg

Step 3：認証情報を取得する

  1. 認可コードを取得する
    ▼手順
    1.承認されたアプリケーションの「App Name」をクリックする
    2.「App ID」、「Secret」、「Advertiser authorization URL」をコピーする
    content_23_12.jpg
    3.コピーした「Advertiser authorization URL」をURLバーに貼り付け、「Enter」をクリックする
    4.以下の画面が表示されるため「Confirm」をクリックする
    content_23_13.jpg
    5.Step 2：Manage appsからアプリ登録を行う の手順4で入力した「Advertiser redirect URL」の画面に遷移する
    6.遷移先の画面のURLの末尾「auth_code=XXX」の「XXX」（認可コード）の箇所をコピーする

  2. アクセストークンを取得する
    ▼手順
    1.「1.認可コードを取得する」でコピーした「App ID」、「Secret」、「認可コード」の値を用いて、ターミナル（Windowsの場合はコマンドプロンプト）から以下のコマンドを実行する
    ※コピーをする際は、先頭や末尾の漏れ、不要なスペースが入っていないかを確認する

    curl -X POST "https://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/" \
-H "Content-Type: application/json" \
-d '{
 "app_id": "{AppID}",
 "secret": "{Secret}",
 "auth_code": "{取得した認可コード}"
}'

    2.以下のようなレスポンスが返却されるので、「advertiser_ids」と「access_token」の値をコピーする

    コピーした値は、コネクション作成画面の以下の項目に設定してください。
    ・「advertiser_ids」の値 →広告主ID ※カンマ区切りで複数指定できます
    ・「access_token」の値 →「アクセストークン」

    {
  "code": 0,
  "message": "OK",
  "request_id": "20260202102404510E7AB758B36A592720",
  "data": {
    "access_token": "xxxxx",
    "advertiser_ids": [
      "xxxxxx",
      "xxxxxx"
    ],
    "scope": [
      1,
      2,
      50,
      4,
      51,
      7224195155857866754
    ]
  }
}

Step 4：コネクションを作成する

  1. ecforce AIdp管理画面にて、「コネクション > コネクションを作成 > インポート用コネクションを作成する」をクリックする
  2. 「Tiktok Ads」を選択して「決定」をクリックする

  3. 以下の項目を入力して、「接続確認をして保存」をクリックする
    content_23_15.jpg

    項目 説明
    接続先サービス 選択した接続先サービス名が表示されます。
    接続先名 接続先の名前を設定できます。
    ※管理用の名前です。
    説明 接続先の説明が設定できます。
    content_23_16.jpg
    項目 説明
    アクセストークン Step 3：認証情報を取得するの手順2でコピーした「access_token」を設定してください。
    広告主ID (カンマ区切りで複数指定可) Step 3：アプリケーションを登録するの手順2でコピーした「クライアントシークレット」を設定してください。
    全件更新時のデータ取得方法 データを全件取得する際の取得方法を設定できます。
    ・直近N日：「取得するデータの日数（現在日から過去N日間）」に指定した日付から現時点までのデータを取得します
    ・日付範囲指定（固定）：「取得するデータの開始日付」に指定した日付から「取得するデータの終了日付」に指定した日付までのデータを取得します
    ※「取得するデータの開始日付」のみを指定した場合、「取得するデータの開始日付」に指定した日付から現時点までのデータを取得します
    差分更新時のデータ取得方法 データを差分取得する際の取得方法を設定できます。
    ・直近N日：「取得するデータの日数（現在日から過去N日間）」に指定した日付から現時点までのデータを取得します
    ・日付範囲指定（固定）：「取得するデータの開始日付」に指定した日付から「取得するデータの終了日付」に指定した日付までのデータを取得します
    ※「取得するデータの開始日付」のみを指定した場合、「取得するデータの開始日付」に指定した日付から現時点までのデータを取得します
    Table Name Prefix ecforce AIdpの管理画面発行時に各アカウントごとに付与される「brand_id」を用いて「{brand_id}_」の形式で設定してください。
    例えば、「brand_id」が「hoge」の場合は「hoge_」と設定してください。
    ※「brand_id」がご不明の場合はお問い合わせください。また、一つのbland idに複数のコネクタのデータを取り込みたい場合は、「{brand_id}_2_」 と設定してください。
    広告費フィー（数値）
    ※オプション    		 取り込んだ検索広告の広告費に掛かるフィーを設定してください。
    例えば「0.1」を指定した場合、10％のフィーが計上されます。

この記事の目次

このセクションの記事

コネクション

  • もっと見る