Push audiences to Kafka, OSS, Data Bank, or internal modules-Quick Audience(Quick Audience)-阿里云帮助中心

Push to Kafka

Push audience user IDs to Kafka on an hourly, daily, weekly, or monthly schedule, or perform a one-time push of user IDs or labels.

All ID types are supported.

Note

Pushes to Alibaba Cloud Kafka and open source Kafka are supported. An administrator must first create a Kafka API operation.
A single push must contain fewer than 10 million IDs. Otherwise, the push fails.
A single push supports up to 30 labels.
You can also create push tasks using an API operation. Contact the API provider for instructions.

Procedure:

Go to Workspace > User Insights > Audience Insights > Audience Management > My Audiences, and click Push for the desired audience.
In the dialog box, select Open API and Kafka from the Push to drop-down list, and then select the Kafka API operation.
Set the push time.
- For a Scheduled Push, turn on Enable Push and set the Push Time (hourly, daily, weekly, or monthly), Start Time, and End Time.
  
  If a scheduled push is already configured, click Remove Configuration in the lower-right corner to delete it.
- For a One-time Push, the push runs immediately.
Select a Push Type and the fields to push.
- Audience Push: In the Push Fields list, select the ID type to push.
- Audience and Label Push: Select the ID type from Push ID Type, then select label fields from Push Fields.
  
  To use a label alias in Kafka, modify the field name mapping on the right. The modified name replaces the original field name in the push.
  
  Note
  You can select up to 30 labels. Available labels come from the user tag table of the audience source.
Click Save or Confirm Push. The data is pushed to Kafka.
Note
- If a concurrent Kafka push limit is configured in the Management Hub, audiences exceeding this limit are queued. Configure the concurrency in Space System Settings.
- The encryption method for the ID field is included in the push, but the data is not decrypted.
Click Push History to view the push results.

The pushed user count is the sum across all ID types and may differ from the total audience size.

Push to Data Bank

After you bind a Data Bank, push an audience to it. Audience Push to Data Bank.

Push to Damengpan

After you bind Damengpan, push an audience to it. Audience Push to Damengpan.

Push to internal modules

If you have purchased Social Interaction, Retail CRM, or Media Placement, push audience user IDs to the corresponding module to use its features.

Push to Social Interaction

Supported ID types and encryption methods for Social Interaction:

Audience Push: By default, the Social Interaction customer ID (plaintext) is pushed. This ID corresponds to the `maiscrm_id` field used by the Social Interaction module.
Audience and Label Push: You can push the Social Interaction customer ID (plaintext) and label fields at the same time.

Procedure:

Go to Workspace > User Insights > Audience Insights > Audience Management > My Audiences, and click Push for the audience.
In the dialog box, select Internal Module and Social Interaction from the Push to drop-down list.
Set the push time.
- For a Scheduled Push, turn on Enable Push and set the Push Time (daily, weekly, or monthly), Start Time, and End Time.
  
  If a scheduled push is already configured, click Remove Configuration in the lower-right corner to delete it.
- For a One-time Push, the push runs immediately.
Select a Push Type and the fields to push.
- Audience Push: The Social Interaction customer ID (plaintext) is always pushed. You do not need to select an ID type.
- Audience and Label Push: Select Social Interaction Customer ID for Push ID Type, then select label fields from Push Fields.
  
  To use a label alias in Social Interaction, modify the field name mapping on the right. The modified name replaces the original field name in the push.
  
  Note
  Labels that were synchronized from Social Interaction are excluded from the list of available labels.
Click Save or Confirm Push. The data is pushed to Social Interaction.
Click Push History to view the push results.

The pushed user count is the sum across all ID types and may differ from the total audience size.

If a push fails, click Repush. A successful push means the audience file reached OSS, but does not guarantee the target module has retrieved it. Verify the audience is active in the corresponding module.

Push to Retail CRM and Media Placement

Supported ID types and encryption methods for Retail CRM and Media Placement:

Retail CRM: You can push mobile numbers (plaintext).
Media Placement: You can push the identifier for advertisers (IDFA), International Mobile Equipment Identity (IMEI), and Open Anonymous Device Identifier (OAID). Plaintext and MD5 encryption are supported for these IDs.

Procedure:

Go to Workspace > User Insights > Audience Insights > Audience Management > My Audiences, and click Push for the audience.
In the dialog box, select Internal Module and Retail CRM/Media Placement from the Push to drop-down list.
Set the push time.
- For a Scheduled Push, turn on Enable Push and set the Push Time (daily, weekly, or monthly), Start Time, and End Time.
  
  If a scheduled push is already configured, click Remove Configuration in the lower-right corner to delete it.
- For a One-time Push, the push runs immediately.
Select the ID type to push:
- For pushes to Retail CRM: Select the unencrypted mobile number (plaintext) field, as shown in the preceding figure.
- For pushes to Media Placement: Select Unencrypted or MD5 for the push encryption method. Then, select the IDFA, IMEI, or OAID fields to push.
Click Save or Confirm Push. The audience file is pushed to OSS. The system then automatically notifies the corresponding module to retrieve the audience file from OSS.

Note
The maximum number of concurrent pushes from internal modules to all other modules is 3.
Click Push History to view the push results.

The pushed user count is the sum across all ID types and may differ from the total audience size.

If a push fails, click Repush. A successful push means the audience file reached OSS, but does not guarantee the target module has retrieved it. Verify the audience is active in the corresponding module.

Push to Salesforce

Push audiences, such as event audiences, from Quick Audience to Salesforce to view participant data associated with your campaigns.

Prerequisites: Add the Quick Audience connector in Salesforce and complete the initial configuration. [SF] Get Started with CXG.
Before pushing an audience, select the campaign information on the Quick Audience push page. Campaign data is T+1 data synchronized from Salesforce as an offline data table, which you associate during the audience push. [SF] Offline Data Synchronization.
During the push, Quick Audience calls the API operation provided by Salesforce to complete the push.

Procedure:

Go to Workspace > User Insights > Audience Insights > Audience Management > My Audiences, and click Push for the audience.
In the dialog box, select Associated Application and Salesforce from the Push to drop-down list.
Set the push time, push ID type, and associate a campaign.
- For a Scheduled Push, turn on Enable Push and set the Push Time (hourly, daily, weekly, or monthly), Start Time, and End Time.
  
  If a scheduled push is already configured, click Remove Configuration in the lower-right corner to delete it.
- Note
  - The available sub-campaigns for association are from T+1 Salesforce campaign data.
  - The push ID type must be an ID type that Salesforce can detect. When you push an audience to Salesforce and select a push ID, this ID must first be associated with the corresponding Salesforce table on the Configuration Management > ID Management page. Currently, only the Lead, Contact, and Account ID types are supported.
  - If you select Account as the push ID type, you must first enable the Accounts As Campaign Members setting in Salesforce. To do this, go to Set up and search for the keyword "Account" in the quick find box to find the setting.
- For a One-time Push, the push runs immediately.
Click Save or Confirm Push. The data is pushed to Salesforce.
Click Push History to view the push results.
After the audience is pushed to Salesforce, view the successfully pushed records and associated campaign information in Campaign Members. You can also view the associated campaign members under the campaign.