概要:ユーザーの特徴に関する自社データをAudiencesに追加すると、目的に合ったグループにユーザーをより細かく分類できます。
ユーザー属性について
ユーザー属性は、イベントに基づくデータとは異なり、ユーザーがお客様に提供する一般的な特徴を表します。性別、年齢、誕生日、国などの変わりにくい情報と、ゲームのスコアなど、変化する情報があります。
ユーザー属性データには、以下の特徴があります。
- CSVファイルのインポート、またはAPI経由のJSONで更新します。
- ハッシュ化した形式で保存します。
- どのオーディエンスのルールセットでも使用できます。
ユーザー属性データは、広告パートナーには共有されません。
この記事で説明するとおり、ユーザー属性はアプリ単位またはアカウント単位で管理します。アプリ単位の属性を管理・使用するには、アカウントのユーザーにアプリへのアクセス権限が必要です。
以下のシナリオで、ユーザー属性の使い方を詳しく説明します。
シナリオ | アプリマーケターの要件
アプリマーケターとして、以下の業務を担当しているとします。
- 2つのゲームアプリ、game_aとgame_bの運営。
- game_cのリリース。
- 次の属性を持つ既存アプリのユーザーへのアプローチ。
- 好きなスポーツ:クリケット
- 現在のゲームスコア:既存ゲームのいずれかで15以上
この表には、CRMに保存されているユーザー属性データが記載されています。オーディエンスのルールセットで、このデータを参照する必要があります。
ルールセットでのCRMデータの使用
Audiencesでユーザー属性(好きなスポーツとゲームスコア)を作成します。これにより、ルールセットからCRMのデータを参照できます。
シナリオで使用するユーザー属性
| 名前 | 形式 | 管理単位 |
|---|---|---|
| ゲームスコア | 数値:「ScoreGameBが29より大きい」などのルールを設定できます。 |
アプリ単位:プレイしたゲームごとにユーザーのスコアを記録します。 具体例:ScoreGameA、ScoreGameB。 |
| 好きなスポーツ |
文字列:「好きなスポーツがテニスである」などのルールを設定できます。 注意値は大文字と小文字を区別します。 |
アカウント単位:ユーザーの好きなスポーツは、アプリにかかわらず同じです。 注意:アカウント単位の属性では、ユーザーに紐付けられる値は1つだけです。 |
ルールセットでのユーザー属性の使用
ユーザー属性は、Audiencesのルールセットでフィルターとして機能します。この例では、マーケターが設定した条件(好きなスポーツとゲームスコア)を使用します。
ユーザー属性の設定と運用
ユーザー属性の設定、追加、管理、削除の方法を説明します。
設定
前提条件:
アプリ単位の属性を管理するには、アカウントのユーザーにアプリへのアクセス権限が必要です。
ユーザー属性を設定するには、以下の手順に従います。
追加
ユーザー属性を追加するには:
- AppsFlyerのサイドメニューで[Engage]>[Audiences]を選択します。
- [ユーザー属性]タブをクリックします。
-
[ユーザー属性を追加]をクリックします。
- 各項目を入力します。各項目の要件は、以下の表を参照してください。
- 属性名
- 形式
- 管理単位
- [保存]をクリックします。
| 項目 | 要件 |
|---|---|
| 属性名 |
|
| 形式 |
|
| 管理単位 |
|
管理
ユーザー属性を管理するには、[Audiences]>[ユーザー属性]タブに移動します。
| 機能 | 説明 |
|---|---|
| 検索と絞り込み | 属性名、アプリ名、属性の管理単位で検索・絞り込みができます。 |
| 並べ替え | 列の見出しをクリックして、表の行を並べ替えます。 |
| データのインポート | |
| APIインポートキーの変更 |
APIインポートキーを変更するには:
注意スクリプトにキーを埋め込んでいる場合は、新しいキーに更新してください。 |
削除
属性を削除できるのは管理者のみです。
ルールセットで使用している属性を削除するには:
- ルールセットから属性を削除します。
- 属性を削除します。
データのインポート
インポートする項目の仕様
| 項目 | 内容 | 形式 | CSVでの データの追加 |
CSVでのデータの削除 |
|---|---|---|---|---|
| device_id |
以下のユーザーIDのいずれかを含めます。
|
テキスト | device_idかcustomer_idのいずれかが必須 |
device_idかcustomer_idのいずれかが必須
既存データを削除する場合は送信しない |
| customer_id | カスタマーユーザーID | テキスト | device_idかcustomer_idのいずれかが必須 |
device_idかcustomer_idのいずれかが必須
既存データを削除する場合は送信しない |
| app_id |
アプリ単位の属性:管理画面に表示されるアプリID。 iOSアプリでは、接頭辞IDを含めます。 アカウント単位の属性:常に*を設定 |
テキスト | 必須 | 必須 |
| attribute_key | ユーザー属性タブに表示されるとおりのユーザー属性名。 | テキスト | 必須 | 必須 |
| attribute_value |
設定する値 |
テキストまたは数値 | 必須 | 送信しない |
CSVでのデータのインポート
CSVファイルで、ユーザー属性データを追加・削除します。以下の図とCSVファイルの例は、この記事で機能を説明するために使用したシナリオに対応しています。
CSVファイルの要件
- ヘッダー行なし
- 上記の表に記載されたすべての列を含めます。
注意
このCSV形式は、ユーザー属性データのインポート用です。オーディエンスセグメントをインポートする場合は、社内システムからのオーディエンスセグメントのインポートを参照してください。ヘッダー行が必要な、別のCSV形式を使用します。
CSVファイルをインポートするには:
- [Audiences]>[ユーザー属性]タブに移動します。
- [データをインポート]をクリックします。
- [CSV]を選択します。
- 次のいずれかを選択します。
- データを追加
- データを削除
- インポートするCSVファイルを選択します。
- [アップロード]をクリックすると、アップロードのステータスメッセージが表示されます。
注意:ユーザー属性をインポートすると、カスタマーユーザーIDに紐付く既知のデバイスすべてにも、その属性が割り当てられます。たとえば、customer_idを使って10台のデバイスに「ゲームスコア」属性をインポートし、そのうち1つのcustomer_idに2台のデバイス(同じCUIDを持つ2つのGAID)が紐付いている場合、インポートされるユーザー属性のレコードは11件になります。
APIでのデータのインポート
この方法でインポートするには、リクエストURLと、ユーザー属性データを含むJSONが必要です。
- 管理画面で、あらかじめ用意されたAPIリクエストとJSONテンプレートを取得します。
- 項目の仕様に従い、JSONテンプレートにデータを入力します。
APIリクエストURLとJSONテンプレートを生成するには:
- [データをインポート]をクリックします。
- [API]を選択します。
- 操作を選択します。
- ユーザー属性を更新:上書きまたは追加します。
- ユーザー属性を削除します。
- ユーザーデータを削除:特定ユーザーに関連するすべてのデータを削除します。ユーザーはAppsFlyer IDで識別します。
- アプリデータを削除:アプリ単位のすべてのデータを削除します。
- 生成されたAPIリクエストURLをコピーします。
- 生成されたAPIリクエスト本文をコピーします。
- 指定の形式で、ユーザー属性データを含むJSONを作成します。アカウント単位の属性では、"app_ids": ["*"]を設定します。
- URLとリクエスト本文を使用してAPI呼び出しを作成します。
- プログラムからリクエストを送信します。
リクエストとJSONの例
https://hq1.appsflyer.com/api/user-attributes-import-api/set-user-data
{
"import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
"attributes_values": [
{
"device_id": "",
"customer_id": "",
"app_ids": [],
"attributes": [
{
"attribute_key": "",
"attribute_value": ""
}
]
}
]
}
注意
APIトークンV2.0を指定したAuthorization Bearerヘッダーで、リクエストを認証する必要があります。
複数のデバイスID、属性キー、属性値を指定する例
{
"import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
"attributes_values": [
{
"device_id": "0bcfc579-f1f3-4452-9111f",
"customer_id": "2222222",
"app_ids": ["game.a.demo"],
"attributes": [
{
"attribute_key": "score",
"attribute_value": 5
}
,
{
"attribute_key": "favorite_sport",
"attribute_value": "cricket"
}
]
}
,
{
"device_id": "555555-d1d1-d1d1-555-fffffffff",
"customer_id": "111111",
"app_ids": ["game.a.demo"],
"attributes": [
{
"attribute_key": "order",
"attribute_value": 7
}
,
{
"attribute_key": "number",
"attribute_value": 8
}
]
}]
}
1つのデバイスIDと複数の属性キー・値を指定する例
{
"import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
"attributes_values": [
{
"device_id": "0bcfc579-f1f3-4452-9111f",
"customer_id": "12345678",
"app_ids": ["game.a.demo"],
"attributes": [
{
"attribute_key": "score",
"attribute_value": 90
}
,
{
"attribute_key": "favorite-sport",
"attribute_value": "cricket"
}
,
{
"attribute_key": "orderNumber",
"attribute_value": 93
}
,
{
"attribute_key": "netPromoterScore",
"attribute_value": 94
}
]
}
]
}
注意:ユーザー属性をインポートすると、カスタマーユーザーIDに紐付く既知のデバイスすべてにも、その属性が割り当てられます。たとえば、customer_idを使って10台のデバイスに「ゲームスコア」属性をインポートし、そのうち1つのcustomer_idに2台のデバイス(同じCUIDを持つ2つのGAID)が紐付いている場合、インポートされるユーザー属性のレコードは11件になります。 CSVインポートの制限
制限事項
全般的な制限
- CSV・APIでインポートする数値データは、整数のみ使用できます。浮動小数点数(小数)には対応していません。例:「score」属性の値は90にできますが、90.5にはできません。
- ユーザー属性データは印刷・ダウンロードできません。
-
属性値の制限:
- 属性値にカンマ、ピリオド、その他の特殊文字は使用できません。
- 文字列の属性値の長さは、最大40文字です。
- 属性値を0で始めることはできません。
APIインポートの制限
- APIリクエストは毎分最大350件です。フラットなペイロードで最大10,000デバイスまで指定できます(1属性なら10,000デバイス、2属性なら5,000デバイスなど)。
- すべてのインポート呼び出しで、
device_idとcustomer_idの両方のキーが必須です。一方の識別子のみで属性をインポートする場合も、もう一方の識別子のキーを含め、値を空文字列にする必要があります。たとえば、device_idのみを指定し、customer_idを指定しない場合は、以下の形式で呼び出します。
"attributes_values": [
{
"device_id": "39e123.......",
"customer_id": "",
CSVインポートの制限
- ユーザー属性の値を追加する場合、CSVファイル1つにつき最大1,000万行まで指定できます。
- User-attribute-example.csv332 バイト