データコネクタの設定
Singular が Apple Search Ads (ASA) から広告コストデータを取得し、レポートに表示する方法をご説明します。
重要: ASA には広告主が利用できる2つのソリューションがあります: Advanced または Basic（違いはこちら）。ASA の Basic ソリューションで実施しているキャンペーンは、同社のレポート API でサポートされていないため、Singular はこれらのキャンペーンの広告コストをレポートできません。
2022年2月11日更新: Keyword Match Type ディメンションを追加しました。
概要情報
| データコネクタテクノロジー | API (Apple Search Ads API v. 5) |
| データの内訳（セグメンテーション） |
Apple Search Ads のデータは次のディメンションで分類されます:
さらに、次のうち 1つ の内訳を選択できます:
キーワードの内訳ではなく市区町村と地域の内訳をご希望の場合は、担当の Customer Success Manager または Singular サポートにお問い合わせください。 |
| データの取得期間 | 30日間 |
| タイムゾーン | デフォルトでは、Singular は Apple のダッシュボードで設定した元のタイムゾーンでデータを取得します。UTC でデータを取得したい場合はお問い合わせください。 |
| データはクリエイティブレベルで利用できますか？ | はい |
| Singularはクリエイティブアセットを表示しますか？ |
はい — Singular は Apple Ads のクリエイティブプレビューに対応しています。 Default と Custom Product Pages。 Singular は、製品ページに関連するすべてのアセットを組み合わせて GIF プレビューを生成します。 注: クリエイティブプレビューと Custom Product Page の名前および ID は、次でのみ利用できます: Creative IQ (CIQ)。 |
| Singular は Custom Product Page の ROI に対応していますか？ |
はい - 各 Apple Search Ads のクリエイティブは、1つの Custom Product Page |
データマッピング
ヒント:
- Singular の サブキャンペーン は Apple の Ad Group。
- パブリッシャー フィールドは、パブリッシャーが Apple Search Ads であるため、このデータコネクタでは値が入りません。
- Singular レポートの各フィールドの説明については、次を参照してください: Singular の指標とディメンションの用語集
| Field in Singular UI | Field in Singular API | Field in Apple |
|---|---|---|
| Dimensions | ||
| Account ID | adn_account_id | orgID |
| App | app | appName |
| App Site ID | app_site_id | adamId |
|
City |
city |
locality |
| Country | country_field | countryOrRegion OR countryCode |
|
Creative Format |
creative_format |
creativeType
|
| Creative ID | creative_id | adId |
| Creative Name | creative_name | adName |
| Date | date_field | date |
| Keyword | keyword | searchTermText OR keyword |
| Keyword ID | keyword_id | keywordId |
| Keyword Match Type | keyword_match_type | matchType |
| Network Campaign ID | adn_campaign_id | (campaign) id |
| Network Campaign Name | adn_campaign_name | (campaign) name |
| Network Creative ID | adn_creative_id | adId, |
| Network Creative Name | adn_creative_name | adName |
| Network Sub Campaign ID | adn_sub_campaign_id | (adGroup) id |
| Network Sub Campaign Name | adn_sub_campaign_name | (adGroup) name |
| OS | os | Always "iOS" (hardcoded) |
|
Platform |
platform |
deviceClass |
| Public Id | site_public_id | adamId |
|
Region |
region |
adminArea |
|
Sub Ad Network |
adn_subadnetwork |
adChannelType |
| Timezone | adn_timezone | timeZone |
| Ad Type | ad_type | SupplySources |
| Product Page ID | product_page_id | productPageId |
| Product Page Name | product_page_name | productPageName |
| Metrics | ||
| Network Clicks | adn_clicks | taps |
| Network Impressions | adn_impressions | impressions |
| Network Installs | adn_installs | installs |
| Original Cost | adn_original_cost | amount |
| Original Currency | adn_original_currency | currency |
Singular はこのパートナーのキャンペーンプロパティの取得にも対応しています。詳細は こちらをご覧ください。
追加のイベント/指標
Apple Search Ads は、自己申告によるビュースルーアトリビューションのレポートも提供しています。現時点ではこのデータはデータコネクタ連携経由でのみ提供され、MMP のビュースルーアトリビューションは Apple Search Ads ではまだサポートされていません。ビュースルーのレポートを設定するには、コンバージョンイベントとしてアカウントに追加できます。
Singular で コンバージョンイベント を設定するには、次の手順に従ってください:
- Singular で、次に移動します: Settings > Events。 Custom Events と Conversion Events の両方のタブがある場合は、 Conversion Events。
- New Event。
-
Apple SearchAds のドロップダウンに、AppleSearchAds で利用可能な指標の一覧（"view installs count" を含む）が表示されます。
翌日、Singular がアカウントの日次データを取得する際に、これらのアクティビティの統計も併せて取得します。
クリエイティブプレビュー
Singular は Apple Ads のクリエイティブプレビューに対応しています。 Default Product Pages と Custom Product Pages。
Singular は、製品ページに関連するすべてのアセットを組み合わせて1つのアニメーション GIF にし、クリエイティブがユーザーにどのように表示されるかを視覚的に示します。
注: クリエイティブプレビューと Custom Product Page の名前および ID は、次でのみ利用できます: Creative IQ (CIQ)。
FAQ
A: 「Search Results」キャンペーンを実施していて、広告グループに特定の Custom Product Page（CPP）や Creative Set を割り当てていない場合、Apple はアプリのデフォルトのメタデータ（アイコン、タイトル、スクリーンショット）を使用して広告を自動生成します。この「広告」はお客様が個別のオブジェクトとして明示的に作成したものではないため、API は次の ID を割り当てます: -1