TikTokピクセルとEvents APIをcPixelに接続する
TikTokをcPixelに接続するにはどうすればよいですか?
ストアのAds Managerアカウントから TikTok Events Managerを開き、Datasets overviewからピクセルIDをコピーします。次にデータセットのSettings → Data connectionを開き、TikTok Pixelの2つのオプションを通り過ぎてEvents APIまでスクロールし、アクセストークンを生成します。両方をcPixelに貼り付けてください。トークンがないと、cPixelはTikTokに何も送信しません。
cPixelに貼り付ける
- cPixelで送信先を開き、プラットフォームを接続の下にあるTikTokのアイコンをクリックします。TikTokを設定が開き、IDを貼り付けの画面が表示されます。
- ピクセルIDをピクセルコードに、トークンをEvents APIアクセストークンに貼り付けます。TikTokのピクセルはShopifyのウェブピクセルのサンドボックスでは動作しないため、トークンは必須です。必要に応じてこのアカウントに名前を付ける(任意)でアカウント名を入力し、次へをクリックします。
- オプションを選択では、サーバーからイベントを送信するをオンのままにします。ブラウザからイベントを送信するはTikTokのストアフロントタグを追加するもので、cPixelのアプリ埋め込みが必要です。Shopifyの TikTokアプリがこのピクセルに送信していない限り、いいえ — cPixelがTikTokを担当します(推奨)のままにしてください。名前とは裏腹に、はい — そのまま使い、cPixelはTikTokのサーバー送信を停止しますを選ぶと、cPixelからそのピクセルへのブラウザ送信とサーバー送信の両方が停止します。
- 保存して次へをクリックします。テストを行うとTikTokを接続しましたと表示されます。
注: テストイベントコード(任意)は接続をテストでのみ使われます。これは実際のテストイベントを1件、ピクセルのTest Eventsタブに送信するもので(
TESTで始まるコードはそこからコピーします)、7日間動きのないアカウントに対するcPixelの夜間チェックにも使われます。フィールドのヘルプ文言にかかわらず、実際のイベントにこのコードが付くことはありません。
TikTok ピクセルIDはどこで見つかりますか?
TikTok Events Managerでは、各データセット名の下に20文字の英数字として表示されます。TikTokのメニューを使って移動してください。Events Managerのアドレスを直接入力すると、「Page not found」になることがよくあります。
TikTok Ads Managerにサインインします。Select an accountで、このストア用のAds Managerアカウントを選びます。それを所有するBusiness Centerではありません。
左上のグリッドアイコンを開き、Events Managerを選びます。
Events Managerのホーム画面で、Datasets overviewに各データセット名の下にピクセルIDが表示されます。
左メニューのData sourcesには、すべてのデータセットがピクセルIDと作成日時とともに一覧表示されます。
Events APIアクセストークンはどうやって取得しますか?
データセットの設定内、TikTok Pixelオプションの下にあるEvents APIブロックで生成します。TikTok公式ガイド:Get started with Events API。
- データセットをクリックし、Settings → Data connectionを開きます。
- Partner integrationと、TikTok Pixelの2つのオプション(Option 1: With Event BuilderとOption 2: With custom code)を通り過ぎて、Events APIまでスクロールします。
- Generate access tokenをクリックし、長いトークンをコピーしてcPixelに貼り付けます。
Events APIのセクションが見つからないのはなぜですか?
たいていの場合、見た目より下にあります。スクロールを続けてください。本当に存在しない場合は、そのピクセルを管理する権限がありません。
TikTok Pixelの2つのオプションが画面いっぱいに表示されるため、ページがそこで終わっているように見えます。一番下にブロックがない場合、その広告アカウントに対してTikTokが必要とする管理者またはオペレーター権限がありません。ピクセルをBusiness Centerが所有している場合は、その管理者に管理権限付きで共有してもらってください。
cPixelはTikTokに何を送信しますか?
cPixelのサーバーはすべてをEvents API経由で送信します:Pageview、ViewContent、Search、AddToCart、InitiateCheckout、AddPaymentInfo、そしてShopifyの注文データから組み立てたCompletePayment(購入)です。アプリ埋め込みがオンの場合、TikTokのストアフロントタグもブラウザから各Pageviewを送信し、サーバー側のコピーと同じイベントIDを使います。
CompletePaymentはTikTokにおけるPurchaseの旧称です。TikTokは今も受け付けており、Purchaseとして報告します(TikTok)。
サーバーイベントには、判明していればハッシュ化されたメールアドレスと電話番号、ハッシュ化されたShopifyの顧客IDとデバイスID、TikTokの_ttpクッキーとttclidクリックID、IPアドレスとユーザーエージェントが含まれます。両方の経路にマーケティングの同意が必要です。ブラウザからのcPixel自身のリクエストを止める広告ブロッカーは、閲覧イベントを止めます。購入はShopifyの注文データから作られます。
TikTokは同じピクセル・イベント・イベントIDの最初のイベントを保持し、48時間は重複を破棄します。また、5分以内に届いたものはマージを試みます(TikTok)。
重要: ShopifyのTikTokアプリも同じピクセルに送信しており、データ共有レベルがEnhancedとMaximumの場合はEvents APIも追加されます(TikTok)。そのイベントIDはcPixelのものとは異なるため、1つのピクセルにつき送信元は1つにしてください。
正しく動作しているかはどうやって確認しますか?
cPixelのライブで各送信とTikTokからの応答を確認し、その後TikTok Events Managerでも確認します。
- cPixelでライブを開き、セッションを開始をクリックして、別のタブでストアを閲覧します。サーバーの行を開き、受理と表示されれば、TikTokが成功コードであるコード0を返したことを意味します(TikTok)。
- 購入を確認するには実際に注文します。テスト注文は既定でスキップされます。
- Events ManagerでピクセルのOverviewを開きます。cPixelのイベントは接続方法がServerと表示され、ストアフロントタグがオンの場合ページビューはServer & Browserと表示されます(TikTok)。件数の更新には最大10分、処理には最大2時間かかることがあります(TikTok)。
最初のサーバー送信が成功すると、送信先でそのアカウントが検証済みになります。Test Eventsには接続をテストのイベントのみが表示され、実際のトラフィックは表示されません。
うまくいかない場合は?
TikTokがcPixelのイベントを受信していない場合は、まずホームを確認し、次にTikTokのコードとメッセージが表示されるライブのTikTokの行を確認します。
| 表示される内容 | 意味 | 対応方法 |
|---|---|---|
| トークンまたは権限エラーで拒否。ホームには対応が必要ですと表示される | TikTokがトークンを拒否しました:取り消されたか、別の広告アカウントのものです(コード40001は権限なしを意味します)。cPixelはそのアカウントへのサーバー送信を一時停止し、ストアの連絡先アドレスにメールを送ります | このピクセルのSettingsで新しいトークンを生成します。ホームのTikTokを修正、または送信先でそのアカウントの横の管理をクリックして貼り付け、次へと保存して次へをクリックします |
| コード40002(invalid payload)で拒否 | TikTokが1件のイベントを拒否しました。以降のイベントは送信されます | 繰り返す場合はホーム → ヘルプを表示 → サポートに連絡 |
| 理由付きでスキップ | cPixelが送信しないと判断しました(同意がない、テスト注文など) | 実際に支払うか、設定 → テスト注文のチェックを外す |
| ブラウザのページビューがない | アプリ埋め込みがオフで、ホームにストアフロントで拡張トラッキングがオフになっていますと表示される | オンにするをクリックする。サーバー送信は継続する |
| ライブでは受理なのに、2時間後もTikTokに反映されない | イベントが別のデータセットに送られている | ピクセルコードをDatasets overviewのピクセルIDと照合する |
TikTokを管理内の削除を押すと、そのアカウントへの送信が停止し、トークンが削除されます。





