概要:カスタムオーディエンスを広告パートナーに送信するための追加のユーザー識別子を設定します。
追加の識別子について
AppsFlyer Audiencesは、カスタムオーディエンスを広告パートナーに送信するための以下のデバイス識別子を自動的にサポートします。
- iOS:IDFA
- Android (Google Play):GAID
- Android(サードパーティのアプリストア):OAIDとIMEI
一部の広告パートナーは、追加のユーザー識別子に基づくカスタムオーディエンスのマッチングもサポートしています。オーディエンスでは、AppsFlyer SDKまたはS2SモバイルAPIを利用してこれらの識別子を特別に設定した場合に、これらを使用する選択肢を提供します。
これらの追加識別子には電話番号やメールが含まれますが、SHA256ハッシュで暗号化されている場合に限り利用できます。 このような追加識別子の使用は、追加識別子利用規約に従う必要があります。
次のステップ
- 使用したい追加識別子を利用可能な識別子の表から選択します。すべての広告パートナーがすべての識別子をサポートするわけではありませんので、ご注意ください。
- デベロッパー—以下の方法で選択した識別子を設定します。
- 利用可能な識別子の表に記載されているパラメーターおよびフォーマット要件
- SDKおよびS2Sのリファレンスおよびコードサンプル
- オーディエンス管理画面で:
- アカウントレベルのユーザー識別子ポリシーを設定します
- 各パートナー接続でアップロードする識別子を選択します
利用可能な識別子
以下の表に示されているように、1つ以上の識別子を設定できます。
追加の識別子—パラメーターとフォーマット
識別子 | パラメーター名 | 形式 | ハッシュ化前の例となる値 |
---|---|---|---|
メールアドレス | email_sha256 |
|
name@domain.com |
電話番号 (下記注意参照) |
電話番号_sha256 |
|
442070313000 |
電話番号 E164 (下記注意参照) |
電話番号_e164_sha256 |
|
+442070313000 |
注意異なる広告パートナーは異なる電話番号形式をサポートしています。したがって、電話番号を利用する場合は、両方の識別子を設定してください。電話番号と電話番号 E164。 |
SDKリファレンスとコードサンプル
SDKを介してオーディエンスの識別子を送信する場合:
- ハッシュ化されていないメールアドレス以外の識別子にはを使用してください。
- ハッシュ化されたメールアドレスにはを使用してください。
iOS SDKの設定
ハッシュ化された電話番号を追加のユーザー識別子として設定するには:
NSDictionary *customData = @{
@"audiences": @{
@"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
@"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
}
};
[[AppsFlyerLib shared] setAdditionalData:customData];
let customData: Dictionary = [
“audiences” : [
"phone_number_sha256":"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
"phone_number_e164_sha256":"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
]
]
AppsFlyerLib.shared().customData = customData
ハッシュ化されたメールアドレスを追加のユーザー識別子として設定するには:
メソッドシグネチャ |
|
使用例 |
|
Android SDKの設定
ハッシュ化された電話番号を追加のユーザー識別子として設定するには:
HashMap<String, Object> audiences = new HashMap<>();
audiences.put("phone_number_sha256", "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37");
audiences.put("phone_number_e164_sha256", "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E");
HashMap<String, Object> customDataMap = new HashMap<>();
customDataMap.put("audiences", audiences);
AppsFlyerLib.getInstance().setAdditionalData(customDataMap);
val audiences = hashMapOf<String, Any>(
"phone_number_sha256" to "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
"phone_number_e164_sha256" to "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
)
val customDataMap = hashMapOf<String, Any>("audiences" to audiences)
AppsFlyerLib.getInstance().setAdditionalData(customDataMap)
ハッシュ化されたメールアドレスを追加のユーザー識別子として設定するには:
メソッドシグネチャ |
|
使用例 |
|
S2Sリファレンスとコードサンプル
S2Sを経由してオーディエンスの識別子を送信する場合、すべての識別子(ハッシュ化されたメールアドレスも含む)にはパラメータを使用してください。1つ以上の識別子を送信できます。
S2S経由で識別子を送信する
形式:
- ネストされたJSON
- キーの値は
audiences
でなければなりません - すべての値は、以下のコード例に示すように文字列化する必要があります。
- パラメータ名は、上記の表に記載されている利用可能な識別子と一致する必要があります。
一般的な形式:
"custom_data" : {
\"audiences\" : {
\"parameter_name_a\" : \"hashed_identifer_a\",
\"parameter_name_a\" : \"hashed_identifer_b\",
\"parameter_name_c\" : \"hashed_identifer_c\"
}
}
ハッシュ化された電話番号とハッシュ化されたメールアドレスの例:
"custom_data" : {
\"audiences\" : {
\"phone_number_sha256\" : \"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37\",
\"phone_number_e164_sha256\" : \"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E\",
\"email_sha256\" : \"34D31BE18022626DE6B311D6A76E791176D2691B6EEF406F524D8F56364C187A\"
}
}