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

アプリマーケティング担当者であるあなたは、次のタスクで忙しい状態です：

• 2つのゲームアプリ（game_a と game_b）の管理。
• game_cのリリース
• 以下のユーザー属性で現行のアプリユーザーをターゲティングします：
  • 好きなスポーツ：クリケット
  • 現在のゲームスコア：いずれかの現行ゲームで15以上

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

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

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

シナリオユーザー属性

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

ユーザー属性は、オーディエンスルールセット内のフィルターとして機能します。この例では、マーケティング担当者が設定した基準（好きなスポーツとゲームスコア）を使用します。 

altUserAttributedExample.jpgalt

前提条件：

アプリレベルの属性を管理するには、それぞれのアプリ権限を持っている必要があります。 

ユーザー属性を設定するには、次の手順に従います：

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

2. 次のいずれかを実行します

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

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

3. ユーザー属性をルールセットに実装します。

ユーザー属性を追加するには：

1. AppsFlyerのサイドメニューから、エンゲージメント > オーディエンス を選択します。
2. ユーザー属性タブをクリックします。
3. ユーザー属性を追加をクリックします。
   

   

4. フィールドに入力します。フィールドの特性は次の表に記載されています。 
   
   • 属性名
   • フォーマット
   • レベル
5. 保存をクリックします。

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

属性を削除できるのは管理者ユーザーのみです。

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

1. ルールセットから属性を削除します。
2. 属性を削除します。

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

ユーザー属性の例.csv

CSVファイルの要件

• ヘッダー行なし
• 前の表にリストされているすべての列が含まれています。 

CSVファイルをインポートするには：

1. オーディエンス > ユーザー属性タブに移動します。
2. データのインポートをクリックします。
3. CSVを選択します。
4. 次のどちらかを選択します：
   • データを追加
   • データを削除
5. インポートするCSVファイルを選択してください。 
6. [アップロード]をクリックすると、アップロードのステータスメッセージが表示されます。

注：ユーザー属性をインポートする際、カスタマーIDに関連付けられているすべての既知のデバイスにも属性が割り当てられます。たとえば、ユーザーがカスタマーIDごとに10台のデバイスを「ゲームスコア」にインポートし、そのうち1つのカスタマーIDが2台のデバイス（同じCUIDを持つ2つのGAID）に関連付けられている場合、このインポートには合計で11のユーザー属性レコードが含まれます。

このインポート方法には、リクエスト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インポートデータでは整数（完全数）のみがサポートされます。浮動小数点型（小数）の数値はサポートされていません。例：「スコア」属性値は90に設定することができますが、90.5にすることはできません。
• ユーザー属性データは印刷もダウンロードもできません。 

• 属性値の制限：

  • 属性値にはカンマやドット、その他の特殊文字を使用できません。
  • 文字列属性値には40文字の長さ制限があります。
  • 属性値は0で開始することはできません。

APIインポートの制限事項

• 1分あたり最大350件のAPIリクエスト、フラットペイロードでは1つの属性で10,000台のデバイス、2つの属性で5,000台のデバイスなどが対象です。
• device_idキーとcustomer_idキーは、すべてのインポート呼び出しに必須です。これらの識別子のいずれか1つだけで属性をインポートする場合、呼び出しには空の文字列を含む他の識別子の「ヘッダー」を含める必要があります。たとえば、device_idごとに属性をインポートし、customer_idなしでインポートする場合、呼び出しは次のようになります：

"attributes_values": [
{
"device_id": "39e123.......",
"customer_id": "",

CSVインポートの制限

• ユーザー属性値を追加する場合、 CSVファイルごとに最大1,000万行が可能です。