Ad events

Retail events

Models

Collect API

Connector Schema Management

Connector Management​

Connect API

Organisation

User

Permissions

Roles

Invitations

Media API

Catalogs

Products

Place

Override

Search API

Zitcha’s flexible discount types support both fixed cost and auction-based discounts. This ensures discounts are applied effectively without compromising the competitiveness of the ad placement, whilst ensuring transparency and adaptability within a network.

Discounts can be applied in various contexts; across all media in a plan, specific media types, particular placements, media schedules, or even specific ad sets.

Discounts are defined, applied and executed by the network. Discounts are visible to the advertiser that the discount applies to.

 Advertisers can purchase media at a discounted rate, with clear differentiation between the delivery allocation and the media budget.

 Allows for sophisticated auction-based discounts, ensuring advertisers can maximise their media buys while enjoying discounted rates.

The components of discounts allow for them to be flexibly applied and transparently shared between organisations:

 The attributes of an ad set that determine whether it is eligible for discount.

 A fixed numeric value or a percentage value.

 The cost of the media after the discount has been applied.

The Zitcha platform will represent an applied discount at the ad set level. You will be able to see the rate of the media being purchased, the discount and the cost of media after the discount has been applied.

To locate your ad set, filter the ad sets table.

Discounts are applied to media based on a set of criteria. A plan may have more than one discount and criteria can be layered within a single discount to granularly define eligible media. If media has an overlap in criteria between two discounts, the highest discount the media is eligible for will be applied.

Learn more about Plan & Ad Set Components

Discounts are managed by the network only.

: You must decide on whether you would like to apply a fixed numeric discount or a percentage discount.

In the Zitcha platform, view the plan details page by

click the pen next to the plan you want to discount.

 section, toggle between a percentage or fixed value discount.

Criteria can be layered to granularly define the media a discount should be applied to.

To apply a discount to specific criteria within a plan:

 section, choose at least one criteria. Scroll and select from the available criteria.
For example: A single discount with the criteria 

 to have the discount applied.
If there are three individual discounts, one with 

 to have the discount applied. If the ad set meets a combination of criteria, the discount with the highest value will be applied.

Toggle between a percentage or fixed value discount & enter your discount amount.

Ad sets are the most granular place to apply a discount. If the ad set already meets the criteria of an existing discount, a discount on the ad set level will only be applied if it is of greater value.

Click the pen icon to expand the ad set details. Enter the discount value into the 

This page describes Zitcha’s Discounts and how you can use them to transparently fuel your network-advertiser negotiations

Discounts

A role contains a set of permissions that allows you to perform specific actions on an organisations resources. To make permissions available to users, you assign roles to the users within the scope of a team.

Inclusive of a Basic, Power User and Admin roles that exist on instantiation of your organisation.

Provide granular access according to a user-specified list of permission sets.

To determine which permission sets are included in a system or custom role, you can use the following method:

Click the view icon to view the role information

A human-readable name for the role. The role title is used to identify the role in the 

A human-readable description of the role.

: The permissions included in the role. Permissions allow users to perform specific actions on an organisations resources. When you grant a role to a user, the user gets all of the permissions in the role.

 permissions allows a user to view the plans they have within their team scope, and 

 allows a user to manage all wallets within their team scope.

Zitcha’s IAM provides additional predefined roles that give granular access to specific organisational resources. These roles are created and maintained by Zitcha. Zitcha automatically updates their permissions as necessary, such as when Zitcha adds new features or services.

Each predefined role contains the permissions that are needed to perform a task, or a group of related tasks.

You can grant multiple roles to the same user, at any level of the resource hierarchy. For example, the same user can have the Admin and Power User roles for any given team.

The following table summarises the permissions that the basic roles give users across all Zitcha services:

The following table lists all IAM predefined permission sets:

Roles are managed within the Zitcha platform. A user with the 

 permission will be able to view, create, update and delete users, roles and teams across the organisation, regardless of the scope of their team.

Enter a name and, optionally, a description for the role.

 list, click the pills to select each set of permissions that you want users with this role to have.


Click the pen next to the custom role that you want to edit.

To edit the name or description of the role, click into the field and make the changes.

To edit the permission sets associated with the role, click 

 and click the pills to select each set of permissions that you want users with this role to have.

: To delete a custom role, you can't be assigned to the role or remove yourself. Contact another super administrator to remove you from the role. Then, follow the steps below to delete the role.

Click the pen next to the custom role that you want to delete.

If you don’t want to give a user full access to the Zitcha platform, you can let them perform only a subset of administrative tasks. Do this by assigning a custom role. You can assign more than one role to a user against any given team.

You can set any role to apply across all of your organisational teams.

Step 1: Review any custom roles already used


You must have the Role Manager permission set for this task.

Click the view next to the custom role and see the assigned permission as pills under the 

Assign a prebuilt system role or custom role for performing common tasks. Review the 

Create and assign a custom role that has different access levels. If so, you need to create the role first. Go to 

A role must sit within the scope of a team for it to be assigned to a user. You can assign a role to a user at the same time as you assign a team by following either procedure for assigning users to a team or assigning roles and teams to a user.

Click the pen icon next to the user you’d like to assign to open their account configuration.

Under Role, scroll and select from the custom and system roles in your organisation, click to add the role to the user.

Under Team, scroll and select the team you would like your role to be scoped by.

Repeat for each role you would like to assign to the user.

Click the pen icon next to the team you’d like to assign users and roles to.

Under User, scroll the user you would like to place in the team, click to add the user to the team.

Under Role, scroll and select from the custom and system roles in your organisation.

Repeat for each user you’d like to add to the team.

This page describes Identity and Access Management (IAM) roles, which are collections of IAM permissions.

Roles & Permissions

IAM lets you grant granular access to specific Zitcha resources and helps prevent access to other resources. IAM lets you adopt the security principle of least privilege, which states that nobody should have more permissions than they actually need.

With IAM, you manage access control by defining 

 (team). For example, plans, ad sets, orders and ads are all resources. The metrics and wallets associated with plans and orders are also resources.

In IAM, permission to access a resource isn't granted 

 to the end user. Instead, permissions are grouped into 

, and roles are granted to authenticated 

Zitcha’s IAM policy defines and enforces what roles are granted to which user within the scope of a team. Each policy is attached to a resource. When an authenticated user attempts to access a resource, IAM checks the resource's policy to determine whether the action is permitted.

A user may belong to one or multiple organisations. A user’s role and team configuration is unique per organisation.

This model for access management has three main parts:

 is a registered account for an individual. Each user has its own identifier, email address.

 is a collection of permission sets. Permissions determine what operations are allowed on a resource. When you grant a role to a user, you grant all the permissions that the role contains.

 is a scope of resources. Teams contain scopes which determine which resources a user is allowed access to. A user must occupy a role within each team.

The below documents are a guide to grant, change, and revoke access to users, roles, and teams:

The below documents provide further information on Zitcha's authentication methods and integrations:

This page describes how Zitcha’s Identity and Access Management (IAM) system works and how you can use it to manage access in the Zitcha platform.

Identity & Access Management (IAM)

When it comes to retail media, a common question from advertisers and retailers is: "What happens when someone bids $1 versus $2?" The answer is nuanced, as Zitcha's search API integration returns sponsored product and banner ads based on a complex algorithm. This algorithm takes into account several factors, including ad pacing, ad relevance to the customer, and the bid amount. Let's delve into how these elements interact and impact ad visibility.

Zitcha's ad placement is not solely determined by bid amounts. Instead, it involves a multifaceted approach to ensure that the most relevant ads are shown to users. Here's a breakdown of the key factors:

 This ensures that ads are shown at optimal times to achieve the best results without oversaturating the audience.

 Ads are matched to users based on their search queries, browsing history, and other contextual factors. This ensures that users see ads that are pertinent to their current journey.

 While higher bids can increase the likelihood of an ad being shown, they do not guarantee top placement if the ad is not relevant to the user's search or context.

To illustrate how these factors work together, consider the following scenarios:

A user searches for something closely related to product type X.

Even though Bidder B has a higher bid, Bidder A's ad is more relevant to the user's search. Therefore, Bidder A's ad is more likely to be displayed.

 bids higher on a general product category.

 bids lower but has products in a specific filter (e.g., blue colour).

When a user searches for the general product, Brand A’s ad appears first due to the higher bid. However, if the user applies a filter to see only blue products, and Brand B has the relevant items, Brand B’s ad will then surface at the top of the results.

Zitcha's primary goal is to ensure that the ads shown are relevant to the user's journey. This means:

 Users see ads that are pertinent to their current needs and interests, improving their shopping experience.

 Advertisers get better engagement rates because their ads are shown to users who are more likely to be interested in their products.

While relevance is crucial, bid amounts do play a significant role:

 Generally result in better placements, especially in competitive categories where multiple advertisers vie for the same audience.

 Zitcha's algorithm balances bid amounts with relevance to ensure that higher bids lead to optimal ad placements without compromising user experience.

In summary, Zitcha's ad placement strategy ensures that the most relevant ads are shown to users, while higher bids can enhance ad visibility but do not guarantee top placement. This balanced approach benefits both retailers and advertisers by delivering pertinent ads to users and optimising ad performance.

By understanding this dynamic, retailers and advertisers can make more informed decisions about their ad strategies on the Zitcha platform. For further questions or deeper insights into our ad placement algorithms, feel free to reach out!

Zitcha's ad placement algorithm balances bid amounts, ad relevance, and pacing to ensure optimal ad visibility and performance, enhancing user experience and advertiser value.

 Understanding Ad Placement: How Bids and Relevance Impact Ad Visibility

 A collection of ad sets belonging to a Brand within a Retail Media Network.

 A set of ads that share multiple commonalities. Ad sets reside within an order and can contain one or more ads.

Common properties include goal, placement, audience, schedule, and budget.

 The individual piece of creative/content delivered to a user.

 A store of committed value that can fund a media plan. A Brand may have multiple wallets.

Example: Joint Business Plan (JBP), Terms of Trade, Over and Above.

 The start and end date of an ad set. Schedules can be configured by the Retail Media Network.

This article highlights key terms you'll encounter on the Zitcha Retail Media Platform.

Platform Terminology

Upon logging into the Zitcha platform, you'll encounter your Performance Overview, providing summarized metrics for current and past orders, filterable by various variables:

 Total unique accounts that have seen your ads.

 Revenue from campaigns on a digital storefront.

 Revenue from campaigns in a physical storefront.

 Recently initiated transactions not yet fulfilled.

 Orders confirmed after necessary approvals.

 Ratio of total revenue to advertising spend.

 User interactions with Website Banner Ad or Sponsored Product.

 Percentage of clicks relative to impressions.

 Total worth of directly attributed conversions.

 Total worth of conversions influenced by the ad.

 Effectiveness of ad spend in generating revenue.

Metrics for Brand Stores are Coming Soon.

 Number of unique accounts that saw the ads.

 Total return from purchases attributed to ads.

 Total monetary value of purchases attributed to ads.

 Percentage of impressions that lead to clicks.

This article describes Zitcha's ad metrics to help you analyse the performance of your Orders.  

Glossary of Zitcha Performance Metrics


After creating pages and content in your brand store, it's essential to save your progress. Once you've done that, you'll notice a "Request Approval" button in the top right-hand corner. Here's what you need to do next:

: Clicking the "Request Approval" button will first ensure that all necessary fields have been completed. Any missing content will be highlighted for your attention.

: At this stage, you have the option to provide comments to the supplier in a free-form text box. You can include up to 1000 characters of feedback or additional information. Note that providing comments is optional.

: If no additional comments are required, simply click "Request Approval." This action will send a notification to the supplier, prompting them to review your brand store.

: The supplier will receive the notification and review the brand store you've created. As the retailer, you'll need to await their response. They may either approve the store as is or provide feedback for revisions.

By following these steps, you can ensure that your brand store is thoroughly reviewed and ready for launch, providing a seamless experience for both you and your supplier.

Follow these steps to request supplier approval for your brand store, ensuring it's reviewed and ready for launch.

How do I request for a Brand Store to be published?

The multiple image content block in your brand store on Zitcha allows you to display two images side by side. Here's how you can utilize this feature:

: Click on "Upload Media" to add your images to the content block.

: If you need a call-to-action button on your images, you should include it directly in the creative itself before uploading.

: You can choose to link each image to an existing page within the store (store link) or to an external URL.

: Once you've uploaded your images and configured any additional settings, click "Save" to apply your changes.

Height: Dynamic, with a recommended 1:1 ratio (1288px x 1288px)

 Both images should have matching dimensions to ensure they render consistently side by side on the page.

By following these guidelines, you can effectively use the multiple image content block to showcase visually engaging content in your brand store on Zitcha.

Learn how to add and configure a multiple image content block in your Zitcha brand store to display two side-by-side images with optional links and call-to-action buttons.

Multiple Image Content Block - Brand Stores Best Practice

To add content to a page in your brand store on Zitcha, follow these steps:

: Use the "current page selected" dropdown menu to choose the page where you want to add content.

: Click on "+ Add Block" to add a new content block to the selected page.

: Select the type of content block you want to add from the available options, which include:

: Ensure that the first content block on each page is a navigation block to maintain a consistent structure across all pages.

: Once you've added content blocks, you can reorder them, edit their settings, or remove them as needed.

For detailed instructions on how to set up and use each content block type, you can refer to the following resources:

Navigation Content Block - Brand Stores Best Practice

Single Image Content Block - Brand Stores Best Practice

Video Content Block - Brand Stores Best Practice

Product Grid Content Block - Brand Stores Best Practice

By following these guidelines and utilizing the available content block options, you can effectively customize and enhance the content of your brand store on Zitcha.

Customize your brand store on Zitcha by adding and managing various content blocks like images, videos, and product grids to enhance page layout and functionality.

How do I add Content to my Brand Store Pages?

Packages on Zitcha are a convenient way to bundle different types of ads together for various purposes, whether it's to simplify the order creation process, achieve specific marketing objectives, or offer discounted pricing to Suppliers.

For instance, you might want to incentivize Suppliers to launch a campaign by offering a package deal that includes a Banner Ad, a Sponsored Product Ad, and a YouTube Bumper Ad at a discounted rate of 10%.

You can learn more about creating Packages by following 

Discover how to create and manage ad packages on Zitcha to streamline orders, achieve marketing goals, and offer discounted rates.

What are packages?

After adding a Facebook Ad to your order, go to the Audience tab and click 

Within the audience builder, set your preferred criteria such as location, age, gender, interests, and behavior. You’ll see a summary of your selection through the Audience Summary.

To save your audience as a template for future use, click 

Type the preferred name for your new audience. This will help you quickly identify your template at a later date. Click 

When creating a new Facebook Ad, you can surface existing templated audiences by clicking 

After adding a Google Ad to your order, click 

Within the Google Audience builder, set your audience criteria such as location, interests, and affinity audiences. You’ll see a summary of your selection through the Audience Summary. Click 

Type the preferred name for your new audience. This will help you quickly identify your template at a later date.

When creating a new Google Ad, you can surface existing templated audiences by clicking 

Build and save Facebook and Google audience templates for future use, or load existing templates when creating new ads.

Best Practices Guides

Articles

Discounts

Roles & Permissions

Identity & Access Management (IAM)

Understanding Ad Placement: How Bids and Relevance Impact Ad Visibility

Platform Terminology

Glossary of Zitcha Performance Metrics

How do I request for a Brand Store to be published?

Multiple Image Content Block - Brand Stores Best Practice

How do I add Content to my Brand Store Pages?

What are packages?

Building Templated Audiences

Creative best practice guide

What's the difference between a Facebook Product Catalog and a Facebook Product Set?

bpg-supplier-topic - Articles Page

Best Practices Guides

Articles

Discounts

Roles & Permissions

Identity & Access Management (IAM)

Understanding Ad Placement: How Bids and Relevance Impact Ad Visibility

Platform Terminology

Glossary of Zitcha Performance Metrics

How do I request for a Brand Store to be published?

Multiple Image Content Block - Brand Stores Best Practice

How do I add Content to my Brand Store Pages?

What are packages?

Building Templated Audiences

Creative best practice guide

What's the difference between a Facebook Product Catalog and a Facebook Product Set?