オーディエンス—ユーザー属性

アプリのマーケティング担当者は、次のようなタスクがあります。

• 2つのゲームアプリの管理：game_a と game_b
• game_cのローンチ
• 既存のアプリユーザーを次のようなユーザー属性でターゲティング：
  • 好きなスポーツ：クリケット
  • 現在のゲームスコア：いずれかのゲームで15以上

表には、CRMから取得したユーザー属性データが含まれています。オーディエンスルールセットは、このデータにアクセスする必要があります。

ルールセットでCRMデータを使用する

オーディエンスにて、ユーザー属性（好きなスポーツとゲームスコア）を作成します。これでルールセットがCRMデータにアクセスできるようになります。

シナリオのユーザー属性

ルールセットのユーザー属性

ユーザー属性はセカンダリルールのフィルタのような役割を持ちます。この例では、マーケティング担当者によって設定された条件（好きなスポーツ、ゲームスコア）が使用されます。

前提条件：

アプリレベルの属性を管理するには、アカウントユーザーがアプリの権限を持っている必要があります。

ユーザー属性をセットアップするには、次の手順に従ってください。

1. ユーザー属性を追加します。

2. 次のいずれかを実行してください。

   • ユーザー属性データをCSVでインポートする

   • ユーザー属性データをAPIでインポートする

3. ユーザー属性をルールセットに実装してください。

ユーザー属性を追加する方法：

1. オーディエンス > ユーザー属性タブを開きます。
2. ユーザー属性を追加をクリックしてください。
   

   

3. 項目に入力します。各項目の説明は、次の表を参照してください。
   
   • 属性名
   • 形式
   • レベル
4. [保存] をクリックします。

ユーザー属性を管理するには、オーディエンス > ユーザー属性タブを開きます。

属性を削除できるのはアドミンユーザーだけです。

ルールセットの一部である属性を削除する方法：

1. ルールセットから属性を削除してください。
2. 属性を削除します。

ユーザー属性データは、CSVファイル経由で追加または削除されます。次の図とサンプルCSVファイルは、この記事の機能を説明するシナリオと一致しています。

User-attribute-example.csv

CSVファイルの仕様

• ヘッダー行はありません
• 前の表に示したすべての列が含まれます。

CSVファイルをインポートする方法：

1. データをアップロードをクリックします。
2. CSVを選択します。
3. 次のいずれかを選択します：
   • データを追加
   • データを削除
4. インポートするCSVファイルを選択してください。
5. アップロードをクリックします。アップロードのステータスメッセージが表示されます。

このインポート方法には、リクエストURLとユーザー属性データのJSONが必要です。

1. 管理画面にて、用意されたAPIリクエストコールとJSONテンプレートを取得します。
2. 項目の仕様に基づいて、JSONテンプレートに独自のデータを入力します。

APIリクエストURLとJSONテンプレートを生成する方法：

1. データをアップロードをクリックします。
2. APIを選択します。
3. アクションを選択します：
   
   • ユーザー属性を更新：上書きまたは追加。
   • ユーザー属性を削除。
   • ユーザーデータを削除：特定のユーザーに関する全てのデータを削除します。ユーザーはAppsFlyer IDによって識別されます。
   • アプリデータを削除：アプリレベルで全てのデータを削除します。
4. 生成したAPIリクエストURLをコピーします。
5. 生成したAPIリクエストボディをコピーします。
6. 指定されたJSON形式を使用してJSON（ユーザー属性データを含む）を用意します。アカウントレベルの属性は、"app_ids": ["*"] を設定します。
7. URLとリクエストボディに基づいて、APIコールを用意します。
8. リクエストをプログラムで送信します。

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": ""
        }
      ]
    }
  ]
}

{
    "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
                }
            ]
        }]
}

{
    "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
                }
            ]
        }
    ]
}

• CSV/API インポートデータでは、integer (整数) のみがサポートされます。浮動小数点型 (10 進数) の数値はサポートされていません。例："score" の属性値は90には設定できますが、90.5はサポートされません。
• ユーザー属性データは、印刷またはダウンロードできません。
• APIに関する制限事項：1分あたり最大1000APIリクエスト、フラットペイロードで5,000個のデバイス（1つの属性を持つ5,000個のデバイス、2つの属性を持つ2,500個のデバイス等）
• CSVに関する制限事項：最大1,000万行