どのようにお手伝いできますか?

Audiences | ユーザー属性データを活用したオーディエンス作成 プレミアム機能

  • 更新

概要:ユーザーの特徴に関する自社データをAudiencesに追加すると、目的に合ったグループにユーザーをより細かく分類できます。

UserAttributionNavigationXL3_us-en.png

ユーザー属性について

ユーザー属性は、イベントに基づくデータとは異なり、ユーザーがお客様に提供する一般的な特徴を表します。性別、年齢、誕生日、国などの変わりにくい情報と、ゲームのスコアなど、変化する情報があります。

ユーザー属性データには、以下の特徴があります。

  • CSVファイルのインポート、またはAPI経由のJSONで更新します。 
  • ハッシュ化した形式で保存します。
  • どのオーディエンスのルールセットでも使用できます。

ユーザー属性データは、広告パートナーには共有されません。

この記事で説明するとおり、ユーザー属性はアプリ単位またはアカウント単位で管理します。アプリ単位の属性を管理・使用するには、アカウントのユーザーにアプリへのアクセス権限が必要です。 

以下のシナリオで、ユーザー属性の使い方を詳しく説明します。

シナリオ | アプリマーケターの要件

アプリマーケターとして、以下の業務を担当しているとします。

  • 2つのゲームアプリ、game_aとgame_bの運営。
  • game_cのリリース。
  • 次の属性を持つ既存アプリのユーザーへのアプローチ。
    • 好きなスポーツ:クリケット
    • 現在のゲームスコア:既存ゲームのいずれかで15以上

この表には、CRMに保存されているユーザー属性データが記載されています。オーディエンスのルールセットで、このデータを参照する必要があります。 
UserAttributuesExample_us-en.png

ルールセットでのCRMデータの使用

Audiencesでユーザー属性(好きなスポーツとゲームスコア)を作成します。これにより、ルールセットからCRMのデータを参照できます。 

シナリオで使用するユーザー属性

名前 形式 管理単位
ゲームスコア 数値:「ScoreGameBが29より大きい」などのルールを設定できます。

アプリ単位:プレイしたゲームごとにユーザーのスコアを記録します。

具体例:ScoreGameA、ScoreGameB。

好きなスポーツ

文字列:「好きなスポーツがテニスである」などのルールを設定できます。

注意値は大文字と小文字を区別します。

アカウント単位:ユーザーの好きなスポーツは、アプリにかかわらず同じです。

注意:アカウント単位の属性では、ユーザーに紐付けられる値は1つだけです。

ルールセットでのユーザー属性の使用

ユーザー属性は、Audiencesのルールセットでフィルターとして機能します。この例では、マーケターが設定した条件(好きなスポーツとゲームスコア)を使用します。 

UserAttributedExample.jpg

ユーザー属性の設定と運用

ユーザー属性の設定、追加、管理、削除の方法を説明します。

設定

前提条件:

アプリ単位の属性を管理するには、アカウントのユーザーにアプリへのアクセス権限が必要です。 

ユーザー属性を設定するには、以下の手順に従います。 

  1. ユーザー属性を追加します。
  2. 次のいずれかを行います。
  3. ルールセットにユーザー属性を設定します。

追加

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

  1. AppsFlyerのサイドメニューで[Engage]>[Audiences]を選択します。
  2. [ユーザー属性]タブをクリックします。
  3. [ユーザー属性を追加]をクリックします。
     

    UserAttributeAdd.png

  4. 各項目を入力します。各項目の要件は、以下の表を参照してください。 
    • 属性名
    • 形式
    • 管理単位
  5. [保存]をクリックします。
項目 要件
属性名
  • 英字のみ
  • 句読点や特殊文字は使用不可
  • アプリ単位とアカウント単位の両方で同じ名前を使用することはできません。
  • アプリ単位では同じ名前を使用できます。たとえば、上記のシナリオではScoreGameAとScoreGameBを使用しています。
形式
  • テキスト:属性値が、指定したルールの値と等しいか、等しくないかを判定します。例:クリケットである、またはクリケットではない。
  • 数値:属性値が、指定したルールの値より大きい、小さい、または等しいかを判定します。例:スコアが15より大きい。
管理単位
  • アカウント単位:アプリに依存しない属性です。
    例:性別、好きなスポーツ。
  • アプリ単位:アプリに関連する属性です。属性に紐付けるアプリを選択します。 
ユーザー属性の設定項目

管理

ユーザー属性を管理するには、[Audiences]>[ユーザー属性]タブに移動します。

AudiencesUserAttributes_us-en.png

機能 説明
検索と絞り込み 属性名、アプリ名、属性の管理単位で検索・絞り込みができます。
並べ替え  列の見出しをクリックして、表の行を並べ替えます。
データのインポート
APIインポートキーの変更 

APIインポートキーを変更するには:

  1. [データをインポート]をクリックします。
  2. [API]を選択します。
  3. [インポートキーを更新]をクリックします。 

注意スクリプトにキーを埋め込んでいる場合は、新しいキーに更新してください。 

ユーザー属性の管理

削除

AppsFlyerAdmin_us-en.png 属性を削除できるのは管理者のみです。

ルールセットで使用している属性を削除するには:

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

データのインポート

インポートする項目の仕様

項目 内容 形式 CSVでの
データの追加
CSVでのデータの削除
device_id 

以下のユーザーIDのいずれかを含めます。

  • IDFA
  • GAID
 テキスト 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ファイルの例は、この記事で機能を説明するために使用したシナリオに対応しています。

User-attribute-example.csv

FileForAttributes.png

CSVファイルの要件

  • ヘッダー行なし
  • 上記の表に記載されたすべての列を含めます。 

注意

このCSV形式は、ユーザー属性データのインポート用です。オーディエンスセグメントをインポートする場合は、社内システムからのオーディエンスセグメントのインポートを参照してください。ヘッダー行が必要な、別のCSV形式を使用します。

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

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

注意:ユーザー属性をインポートすると、カスタマーユーザーIDに紐付く既知のデバイスすべてにも、その属性が割り当てられます。たとえば、customer_idを使って10台のデバイスに「ゲームスコア」属性をインポートし、そのうち1つのcustomer_idに2台のデバイス(同じCUIDを持つ2つのGAID)が紐付いている場合、インポートされるユーザー属性のレコードは11件になります。

 

APIでのデータのインポート

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

  1. 管理画面で、あらかじめ用意されたAPIリクエストとJSONテンプレートを取得します。
  2. 項目の仕様に従い、JSONテンプレートにデータを入力します。 

APIリクエストURLとJSONテンプレートを生成するには:

  1. [データをインポート]をクリックします。
  2. [API]を選択します。
  3. 操作を選択します。
     
    • ユーザー属性を更新:上書きまたは追加します。
    • ユーザー属性を削除します。
    • ユーザーデータを削除:特定ユーザーに関連するすべてのデータを削除します。ユーザーはAppsFlyer IDで識別します。
    • アプリデータを削除:アプリ単位のすべてのデータを削除します。 
  4. 生成されたAPIリクエストURLをコピーします。
  5. 生成されたAPIリクエスト本文をコピーします。
  6. 指定の形式で、ユーザー属性データを含むJSONを作成します。アカウント単位の属性では、"app_ids": ["*"]を設定します。
  7. URLとリクエスト本文を使用してAPI呼び出しを作成します。
  8. プログラムからリクエストを送信します。

リクエストと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万行まで指定できます。