Send query results to Eagle Eye Audiences

Eagle Eye is a loyalty and promotions platform. Its AIR platform manages loyalty wallets that track each customer’s earning and spending activity in a loyalty program.

Note

This destination uses the Eagle Eye AIR Audiences API, which is part of the Eagle Eye Resource API , and looks up wallets with the Eagle Eye AIR Wallet API .

Beta

The Eagle Eye Audiences connector is in beta, and Eagle Eye labels the AIR Audiences API as beta. Contact your Amperity representative to learn more.

The steps that are required to send audiences to Eagle Eye from Amperity.

Step 1.

Build a query
Step 2.

Add orchestration
Step 3.

Run orchestration

Caution

This destination is available for sending query results to Eagle Eye after it is configured by a Datagrid Operator or your Amperity representative.

If this destination cannot be selected for orchestrations ask your Datagrid Operator or Amperity representative to configure a destination for sending query results to Eagle Eye.

Build query

Build a query that returns an identity_value column, named in lower case. Each value is a loyalty identity that is attached to the person’s wallet in Eagle Eye, such as a loyalty card number, an email address, or whatever identity type your company unit is configured for. Amperity sends only this column, and uses it to find each person’s wallet. Return values exactly as Eagle Eye stores them, without hashing them, and return one identity value for each person.

The following example returns loyalty IDs from the Customer 360 table. It casts the ID to a string, which the column must be, and works when your Eagle Eye wallets hold the same loyalty IDs:

SELECT
  CAST(loyalty_id AS VARCHAR) AS identity_value
FROM Customer_360
WHERE loyalty_id IS NOT NULL

Each run adds the people who recently joined the results to the audience in Eagle Eye, and removes the people who left. A change is sent again on later runs for a few days, which has no effect in Eagle Eye. Every person must already have an Eagle Eye wallet that holds their identity value. A person without a wallet is reported as a failed row.

Caution

Each send to this destination also has an Audience action setting. delete permanently deletes the audience in Eagle Eye AIR, even while an active AIR campaign uses it. Leave it set to upsert unless you mean to delete the audience, and see Audience actions for the other settings, such as Audience name, that you choose for each send.

Add orchestration

An orchestration defines the relationship between query results and a destination, including the destination and the frequency at which an orchestration runs.

  1. Open the Activations page, select the Orchestrations tab, and then click the Add orchestration button. This opens the Add orchestration dialog box.

  2. From the Object type dropdown, select Query.

  3. From the Object dropdown, select the query for which results is sent to Eagle Eye.

  4. From the Destination dropdown, select a destination that is configured for sending data to Eagle Eye.

  5. Verify all settings.

  6. Set the workflow to Manual. You can change this to automatic later, after verifying the end-to-end workflow.

  7. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

  1. Open the Activations page, select the Orchestrations tab, and then open the menu for the Eagle Eye orchestration. Select Run.

  2. The Status column for the orchestration updates to say “Waiting to start”, after which the notifications pane updates to include a notification that shows the current status.

  3. When the orchestration has run successfully, the status is updated to “Completed”.