概要情報

データコネクタテクノロジー	API (Snapchat API v. 1 - ドキュメントを参照)
データの内訳（セグメンテーション）	データは次のディメンションで分類されます: キャンペーン、サブキャンペーン（"Ad Squad"）、プラットフォーム、およびクリエイティブ。さらに、Snapchat では次のうちいずれか1つの内訳を選択できます: 国（デフォルト） DMA（米国のみ）地域年齢と性別注 - 国の内訳はオフラインイベントと併せて取得できません。これはネットワーク側の制限です。
タイムゾーン	Snapchat で広告アカウントに設定されているタイムゾーンです。
データはクリエイティブレベルで利用できますか？	はい
Singularはクリエイティブアセットを表示しますか？	はい、次の Snapchat の広告タイプ: APP_INSTALL COMPOSITE and DEEP_LINK FILTER WEB_VIEW LENS_DEEP_LINK LENS_APP_INSTALL その他の広告タイプではクリエイティブアセットは利用できません。

データマッピング

Singular の サブキャンペーン は Snapchat の Ad Squad。
Singular の クリエイティブ は Snapchat の Ad。
Snapchat の video_views_15s は取得できますが、データの内訳と併用することはできません。

すべてのフィールドの説明については、次を参照してください: Singular の指標とディメンションの用語集。

Field in Singular UI	Field in Singular API	Field in Network
Dimensions
Account ID	adn_account_id	Ad Account ID
Account Name	adn_account_name	Ad Account Name
App	app	App Name
App Site ID	app_site_id	Either 'iOS App ID" or "Google Play Store ID"
Bid Type	bid_type	optimization_goal
Campaign Objective	campaign_objective	Campaign Objective
Campaign Status	campaign_status	campaign status
Country	country_field	"Country Code" from the Targeting Spec for the Ad Squad
Creative ID	creative_id	Ad ID
Creative Name	creative_name	Ad Name
Date	date_field	Date
DMA ID	dma_id_field	dma
DMA Name	dma_name_field
Network Campaign ID	adn_campaign_id	Campaign ID
Network Campaign Name	adn_campaign_name	Campaign Name
Network Creative ID	adn_creative_id	Ad ID
Network Creative Name	adn_creative_name	Ad Name
Network Sub Campaign ID	adn_sub_campaign_id	Ad Squad ID
Network Sub Campaign Name	adn_sub_campaign_name	Ad Squad Name
Original Bid Amount	original_bid_amount	bid_micro
Placement	placement	Placement_v2.snapchat_positions (if placement_v2.config == “AUTOMATIC” we hard coding - ["INTERSTITIAL_USER", "INTERSTITIAL_CONTENT","INSTREAM", "FEED", "GAMES"]
Platform	platform	OS Type
Public Id	site_public_id	iOS App ID Google Play Store ID
Region	region_field	region (in Region breakdown) regions (in DMA breakdown - it's possible to have multiple regions in the same DMA)
Sub Campaign ID	sub_campaign_id	Ad Squad ID
Sub Campaign Name	sub_campaign_name	Ad Squad Name
Metrics
Cost	adn_cost	Spend
Network Clicks	adn_clicks	Swipes
Network Impressions	adn_impressions	Impressions
Network Installs	adn_installs	Total Installs (Installs reported using Snap's Ad Manager attribution logic.)
Original Cost	adn_original_cost	Spend
Original Currency	adn_original_currency	Pulled from the Ad Account's Currency
Video Views	video_views	video_views
Video Views 25%	video_views_25pct	quartile_1 (Video Views to 25%)
Video Views 50%	video_views_50pct	quartile_2 (Video Views to 50%)
Video Views 75%	video_views_75pct	quartile_3 (Video Views to 75%)
Completed Video Views	completed_video_views	view_completion

Singular はこのパートナーのキャンペーンプロパティの取得にも対応しています。詳細はこちらをご覧ください。

特別な設定手順

Singular が Snapchat からデフォルトで取得する指標に加えて、Singular でコンバージョンイベントを作成することで、任意の Snapchat 指標と Advanced Conversions（一覧を参照）を取得できます。

コンバージョンイベントを作成するには:

Singular で、次に移動します: Settings > Events。 Custom Events と Conversion Events の両方のタブがある場合は、 Conversion Events。
New Event。
Snapchat のドロップダウンから、目的の指標を選択します。

翌日、Singular がアカウントの日次データを取得する際に、完了数も併せて取得します。
新しいイベントにデータが入力されたら、 Reports ページでレポートを実行し、次のドロップダウンから作成したコンバージョンイベントを選択します: Events ドロップダウンから選択します。

Singular がお客様に代わって Snap のデータを取得するには、API ユーザーキーは Snap のロールが Org Admin、Account Admin、または Campaign Manager のユーザーから発行される必要があります。こちらに記載された手順（link）に従ってアクセストークンを生成してください。このアクセストークンは、Snap の Marketing API を通じてこのデータを取得する GET リクエストの Bearer トークンとして使用されます。

FAQ とトラブルシューティング

Singular は Snapchat からどの指標を取得しますか？

Snapchat が提供するさまざまな指標のうち、Singular の連携ではモバイルマーケティングに関連する指標を収集します:

Impressions
Clicks
Installs
Cost

さらに、Singular は ユーザーアクション（Snap では Advanced Conversions）に関する統計を取得できます。これは Singular では コンバージョンイベントと呼ばれます。Snapchat からそのデータを取得するための設定については、以下のカスタムイベントの設定を参照してください。

Snap の Advanced Conversions はどこで確認できますか？

Snapchat API がレポートするネットワークコンバージョン指標は、Singular の Events ページ（Snapchat ソース配下）でマッピングでき、Singular のレポート UI と ETL で集計レポートに利用できます。

Singular はデフォルトで、Snapchat のレポート API のデータをクリック時点基準でレポートしますか、それともインプレッション時点基準でしょうか？

デフォルトでは、Singular はクリック時点を基準にデータをレポートします。Singular のダッシュボードでインプレッション時点を基準にデータをレポートしたい場合は、サポートチームまでメールでご依頼ください。

Snapchat のデータコネクタはどのように設定しますか？

Snapchat から Singular へのデータ取得を開始するには:

Singular プラットフォームで、次に移動します: Settings > Data Connectors。
Add New Connector ボタンにカーソルを合わせ、「Snapchat」と入力し始めます。表示されるリストから Snapchat を選択します。
Connect with Snapchat をクリックし、必要な広告アカウントにアクセスできる Snapchat ユーザーでログインします。

注: ボタンをクリックする前に、無関係なアカウント（個人アカウントなど）で Snapchat にログインしていないことを確認してください。

Snapchat データコネクタ

概要情報

データマッピング

特別な設定手順

FAQ とトラブルシューティング