受众共享——其他相关标识符

推荐用于
营销人员 开发商
最近更新：

概要：向广告投放渠道发送自定义人群包时，您可以额外配置其他的用户标识符。

其他相关标识符简介

AppsFlyer的受众共享产品支持以下设备标识符，用于向合作渠道发送自定义人群包：

  • iOS：IDFA
  • 安卓（Google Play）：GAID
  • 安卓（第三方应用商店）：OAID和IMEI

部分渠道还支持根据额外配置的用户标识符进行自定义的人群匹配。AppsFlyer的受众共享针对此类标识符提供多种使用方式，但您需要事先通过AppsFlyer SDK或S2S-mobile API对所需的特定标识符进行配置。

这些额外的标识符还可包括电话号码和邮箱地址，但必须经过SHA256算法加密后才能使用。  使用此类额外标识符时，您还需要遵守额外标识符的使用条款。

配置流程

  1. 从可用标识符表格中选择您要使用的额外标识符（若有）。请注意：并非所有渠道都支持全部标识符。
  2. 开发人员——使用以下说明配置选定的标识符：
  3. 在受众共享面板中完成以下操作：

可用标识符

您可以配置一个或多个标识符。具体的可用标识符请见下表。

额外标识符—参数和格式

标识符 参数名称 格式 示例值（加密前）
邮箱地址 email_sha256
  • 小写
  • 无空格
  • 须经过SHA256加密
 name@domain.com
电话号码
(见表格下方注释）		 phone_number_sha256
  • 无符号、字母，不能以零开头
  • 需包含国家代码
  • 须经过SHA256加密
 442070313000

电话号码E164

(见表格下方注释）

 phone_number_e164_sha256
  • E164电话号码
  • 须经过SHA256加密
 +442070313000

 注释 

各个渠道支持的电话号码格式有所不同。如果您选择电话号码作为额外的标识符，请同时配置电话号码和电话号码E164。

SDK参考说明和代码示例

通过SDK发送标识符用于受众共享时，请注意以下事项：

  • 如需发送除了加密邮箱地址以外的标识符，请使用setAdditionalData
  • 如需发送加密邮箱地址，请使用setUserEmails

iOS的SDK配置

如需将加密后的电话号码设置为额外的用户标识符：

Objective-C Swift 
NSDictionary *customData = @{
  @"audiences": @{
    @"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
    @"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
  }
};
[[AppsFlyerLib shared] setAdditionalData:customData];

如需将加密后的邮箱地址设置为额外的用户标识符：

方法签名

 
- (void)setUserEmails:(NSArray<NSString *> *_Nullable)userEmails 
withCryptType:(EmailCryptType)type;

用法示例
Objective-C Swift 
NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType:EmailCryptTypeSHA256];

安卓的SDK配置

如需将加密后的电话号码设置为额外的用户标识符：

Java Kotlin 
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);

如需将加密后的邮箱地址设置为额外的用户标识符：

方法签名

 
public abstract void setUserEmails(
  AppsFlyerProperties.EmailsCryptType cryptMethod,
  String... emails
);

用法示例
JavaKotlin 
AppsFlyerLib.getInstance().setUserEmails(
  AppsFlyerProperties.EmailsCryptType.SHA256,
  "name@domain.com",
  "another_name@another_domain.com"
);

S2S参考说明和代码示例

通过S2S发送用户标识符用于受众共享时，请使用custom_data参数。该参数适用于所有标识符（包括加密的邮箱地址）。您可以发送一个或多个标识符。

通过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\"
     }
}