What Is Amobee?

Amobee is a global marketing technology company that provides data-driven solutions for advertisers and agencies. It offers an integrated platform for media planning, buying, and real-time analytics across various channels, including digital, TV, and social media. Amobee's technology leverages data to deliver personalized and effective advertising campaigns, aiming to enhance audience engagement and return on investment. By utilizing advanced machine learning and data analytics, Amobee helps brands understand consumer behavior and optimize their marketing strategies.

What are the benefits of integrating MetaRouter with Amobee?

  • Enhanced Data Accuracy and Privacy: By using a server-side connection, MetaRouter ensures that all events and parameters are accurately and securely delivered to Amobee, reducing data loss and enhancing user privacy compared to client-side tagging.
  • Improved Website Performance: Eliminating the need for an Amobee tag on the site reduces the client-side load, leading to faster page load times and a better user experience.
  • Streamlined Identity Management: MetaRouter's ability to send the Amobee uid for identity ensures seamless and consistent user identification across different platforms and touchpoints, improving the effectiveness of targeted advertising campaigns.

Getting Started - From Your Amobee Account

Gather Client ID

  1. Log in to the Amobee Platform:
  2. Access Account Settings:
    • Once logged in, locate and click on your profile or account icon, usually found in the top-right corner of the interface.
  3. Navigate to Integration or API Settings:
    • In the account settings menu, look for sections labeled "Integration," "API," or similar. This is where integration details, including the Client ID, are typically found.
  4. Locate the Client ID:
    • Within the Integration or API settings, search for the Client ID. It may be listed alongside other API credentials or integration details.
  5. Contact Support if Needed:
    • If you cannot find the Client ID, contact Amobee support or consult the Amobee Help Center for specific instructions tailored to your account setup.

Gather Beacon IDs - Please reach out to your Amobee support team to gather IDs from your Amobee beacons.


Getting Started - From Your MetaRouter Account

Adding an Amobee integration.

From the integration library, add an Amobee integration. Then, fill out the Connection Parameters:

Connection ParameterDescription
PAGE_BEACON_IDIdentifies page views.
PRODUCTS_SEARCHED_BEACON_IDTracks searches for products.
PRODUCT_LIST_VIEWED_BEACON_IDLogs views of product lists.
PRODUCT_VIEWED_BEACON_IDCaptures individual product views.
PRODUCT_ADDED_BEACON_IDRecords when products are added to the cart.
CART_VIEWED_BEACON_IDMonitors views of the shopping cart.
ORDER_COMPLETED_BEACON_IDTracks completed orders.
CATCH_ALL_BEACON_IDActs as a fallback for any other events not specifically covered by the above beacons.

Adding an Amobee Sync

To gather the Amobee uid value, you must add an Amobee sync.

  1. From the Pipelines page, find the pipeline associated with the web property you’d like to add a sync to. Hover over the three dot dropdown and select “Build AJS File.”
  2. In the Identity Syncs section, select the Amobee sync.
  3. Fill out the following fields:
    1. Consent Type
    2. Client ID - Your Amobee account’s unique client ID.
    3. API Timeout (in milliseconds) - Sets a time limit for how long the Sync Injector will wait for an API response from the vendor. The maximum timeout value is 300ms.
      1. 300 default
    4. Cookie Lifetime (in days) - 365 default
    5. Fire on Re-Sync - ON default
  4. Scroll down and click the Save and Build File button.
  5. Deploy your AJS file to propagate changes to your web property.

Event Mappings

MetaRouter provides all of the event mappings that Amobee integrations typically require. You may add custom events, parameters or mappings in accordance with Amobee’s API documentation. Please note, all parameters in the default playbook are required.

Global

Global mappings will be applied to all events. If your parameter names do not match the Expected Inputs provided, you will need to overwrite the Inputs provided with your own.

Output KeyDescriptionExpected Input
cidString: Input your Amobee client ID.Enrichment - staticString: ''
uidString: User ID provided by Amobee for identifying the user across all events.context.providers.amobee.uid

Event Specific

Page

Output KeyDescriptionExpected Input
b2String: Beacon ID for page views.Enrichment - staticString: $$PAGE_BEACON_ID$$

Products Searched

Output KeyDescriptionExpected Input
b2String: Beacon ID for products searched.Enrichment - staticString: $$PRODUCTS_SEARCHED_BEACON_ID$$

Product List Viewed

Output KeyDescriptionExpected Input
b2String: Beacon ID for product list viewed.Enrichment - staticString: $$PRODUCT_LIST_VIEWED_BEACON_ID$$

Product Viewed

Output KeyDescriptionExpected Input
b2String: Beacon ID for product viewed.Enrichment - staticString: $$PRODUCT_VIEWED_BEACON_ID$$

Product Added

Output KeyDescriptionExpected Input
b2String: Beacon ID for product added to cart.Enrichment - staticString: $$PRODUCT_ADDED_BEACON_ID$$

Cart Viewed

Output KeyDescriptionExpected Input
b2String: Beacon ID for cart viewed.Enrichment - staticString: $$CART_VIEWED_BEACON_ID$$

Order Completed

Output KeyDescriptionExpected Input
b2String: Beacon ID for order completed.Enrichment - staticString: $$ORDER_COMPLETED_BEACON_ID$$

Default Output Key

Output KeyDescriptionExpected Input
b2String: Catch-all beacon ID for events not specifically categorized.Enrichment - staticString: $$CATCH_ALL_BEACON_ID$$

Required Identifiers

These identifiers must be mapped to Amobee in order for successful user matching to occur. Without these IDs, any events sent to Amobee will be rejected. For your convenience, required IDs are mapped as Global parameters to ensure they are added to every event.

AttributeExampleSync Injector Required?
uid"uid":"8575821199332081695"Yes