selecteq

Keep rows with a value that matches the value you enter.

This guide explains how to configure the selecteq instruction. To learn about another instruction, go back to the Available custom script instructions overview.

Introduction

Use the selecteq instruction to find and keep rows in a data extract. Only the rows of the data extract that exactly match the search criteria are kept, and all other rows are removed. The search is case-sensitive. This is the opposite of the selectne enrichment.

Creating a custom script enrichment using the selecteq instruction

To create and configure a custom script using the selecteq instruction, follow these steps:

  1. Create a custom script enrichment.

  2. In the Instructions step, select the selecteq instruction.

  3. To configure the custom script instruction, fill in the following fields. Required fields are marked with an asterisk (*).

Field*

Enter the name of the column that contains the value used to identify which row to keep.

Select a column in one of the following ways:

  • Select String and enter the name of the column.

  • Select Integer and enter the position of the column in the data extract as an index value. Counting starts at 0. To select the first column, enter 0. To select the second column, enter 1. To select the last column in the data extract, enter -1.

Value*

Enter the value used to identify which row to keep. This instruction is case-sensitive.

Complement

Select this field to reverse the enrichment. Any rows that match the search criteria are removed and the rows that do not match the criteria are kept.

Subtable

Enter the name for a subtable that you want to use within this custom script.

A subtable is a temporary table that only exists for this custom script. You can apply additional instructions within the same custom script to the subtable. However, the subtable cannot be used in any other custom scripts.

If a subtable does not exist for the current custom script, the enrichment is applied to the data extract, and the enriched data is output into the subtable. If the subtable already exists for the custom script, the subtable is used as the input for the enrichment and optionally as the output.

Example

Enrichment configuration

Field*

Ad Group

Value

Ecommerce

Data table before enrichment

Campaign

Ad Group

Clicks

Brand

media

7

Branding

ecommerce

3

Dashboard

brand awareness

18

Brand

Ecommerce

4

Dashboard

media|social

5

Branding

media

11

Data table after enrichment

Campaign

Ad Group

Clicks

Branding

ecommerce

3

Brand

Ecommerce

4