> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/sv/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.md).

# Översikt över Epsilon Retail Media Partner API:er

Välkommen till Epsilon Retail Media Partner API. Den här guiden hjälper dig att integrera med vår annonsplattform för att hantera dina kampanjer, plånböcker, team och användare programmeringsmässigt. Du kan också spåra resultat och växa din verksamhet effektivt.

## Vad är ett API?

Ett API står för Application Programming Interface (tillämpningsprogrammeringsgränssnitt). Ett API fungerar som en mellanhand som gör det möjligt för två mjukvarukomponenter att kommunicera med hjälp av en uppsättning funktioner och procedurer. API:er används vanligtvis för att hämta eller skicka data, samt för att få åtkomst till funktioner och tjänster från andra applikationer.

## Vad är Partner API?

Vårt Partner API ger dig programmeringsmässig åtkomst till nästan allt du kan göra i Epsilon användargränssnittet för plattformarna för På webbplatsen Campaign Management. Det innebär att istället för att manuellt klicka dig igenom appen kan dina system eller utvecklare ansluta direkt till vår plattform och automatisera, anpassa eller integrera dess funktioner i dina egna verktyg eller arbetsflöden.

Partner API används av många återförsäljare och partner, inklusive aggregatörer som Pacvue, Skai och Commerce IQ.

## API-översikt

Den Epsilon Retail Media Partner API möjliggör programmeringsmässig hantering av retail media [Kampanjer](/retail-media-interface/partner/sv/campaign-management-api/productcampaign-1/createproductcampaign.md), [Team](/retail-media-interface/partner/sv/team-user-api/team.md) & [Användare](/retail-media-interface/partner/sv/team-user-api/user-1/createuserteaminvite.md), och [Plånböcker](/retail-media-interface/partner/sv/billing-api/wallet.md). Använd det för att skapa och uppdatera kampanjer i flera annonsformat, inklusive Sponsored Product Ads (SPA:er), statiska banners och responsiva Banner X annonser.

Vårt Partner API är ett REST-baserat API som använder vanliga GET-, POST-, PATCH- och DELETE-protokoll via JSON-dataenheter.

## Viktiga fördelar

* Automatisera kampanj-, team-, användar- och plånboksoperationer via REST API-slutpunkter.
* Hantera flera kampanjer och resurser effektivt med stöd för massoperationer.
* Gör det möjligt för dig att orkestrera API-anrop så att de passar ditt befintliga arbetsflöde och din systemarkitektur.
* Skapa och hantera kampanjer över Sponsored Product Ads, Banner och Banner X -format.
* Användarnyckelbaserad autentisering med tidsbegränsade token för säkra API-interaktioner.

## Förutsättningar

<figure><img src="/files/PuFN24zE98ciLOGnPQg6" alt="" width="100%"><figcaption></figcaption></figure>

Innan du använder Partner API måste du se till att följande krav uppfylls:

### Åtkomst till namnområde

Du måste ha åtkomst till ditt anvisade namnområde, som fungerar som en behållare för dina data och konfigurationer. Kontakta Epsilon supportteamet för att få konfigurationsdetaljer för namnområdet som är specifika för dina återförsäljare.

### Teammedlemskap

Du måste vara en del av antingen ett leverantörsteam eller ett primärt återförsäljarteam med lämpliga behörigheter inom ditt namnområde.

### Begäran om API-intag

Annonsaggregatörer, och varumärkespartner måste göra en begäran om API-intag innan de använder Partner API:erna. Använd det officiella intagsformuläret som det refereras till i [KB0040933 ](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040933)för att initiera en ny API-anslutning.

### Åtkomst till Reporting API

Du måste ha åtkomst till Reporting API (BigQuery-datalager) för att kunna fråga relevanta tabeller som dim\_product, dim\_catalog och dim\_placement. Detta hjälper till att validera integrationsberedskapen och utforska metadata.

### Nödvändiga metadata

Se till att din produktkatalog, placering och teaminformation är skapade och tillgängliga under ditt namnområde. Du kan verifiera detta genom att ställa frågor mot lämpliga BigQuery-tabeller.

Om du inte har åtkomst till BigQuery, begär det via det officiella formuläret för begäran om API-åtkomst. Beroende på dina behov, se lämplig kunskapsbasartikel:

* **Ändra/ta bort Reporting BigQuery API-slutpunkt**: Behöver ändra en befintlig API-slutpunkt - [KB0040934](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040934).
* NYTT Partner API (rapporterings-API)\*\* - [KB0040947](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040947).

{% hint style="info" %}
Åtkomstnotering: Vissa länkar i detta dokument pekar på interna eller begränsade resurser. Se till att du är inloggad med lämpliga behörigheter för att få åtkomst till innehållet.
{% endhint %}

## Komma igång med Partner API:er

<figure><img src="/files/IQOcRxodcv8gfmGwxwop" alt="" width="100%"><figcaption></figcaption></figure>

### Autentiseringskrav

Partner API använder en auktoriseringsprocess som kräver en User Key. Åtkomsttoken hämtas genom att anropa User Key Authentication API:

* Din hämtade User Key skickas i headern för denna begäran.
* Det hämtade Access Token används därefter i alla metodanrop till Partner API.
* Token upphör att gälla drygt 24 timmar efter att de genererats.

{% hint style="info" %}
Ett nytt token bör begäras när det föregående upphör att gälla. En klient bör inte generera ett nytt token vid varje begäran till vårt API.
{% endhint %}

### Hämta dina API-inloggningsuppgifter

För att börja använda Epsilon Retail Media Partner API:er behöver du följande information. Om du är osäker på några av uppgifterna, kontakta din Support eller skapa ett ärende för att få hjälp.

* Din användarnyckel för autentisering.
* Bas-URL:en för att göra API-anrop.

### Hämta din User key

1. Logga in på ditt Epsilon Retail Media teamkonto.
2. Välj ett team.
3. I profilmenyn väljer du **User settings**.
4. Navigera till fliken **User key**.
5. Klicka på **Show** för att visa din API-nyckel.

Använd denna nyckel för att autentisera dina API-begäranden. Epsilon Retail Media använder användarnyckelbaserad autentisering. Byt ut din användarnyckel mot ett tidsbegränsat åtkomsttoken för att auktorisera API-begäranden. För mer information, se [Autentiseringsbegäranden](/retail-media-interface/partner/sv/partner-api-authentication/authenticating-requests.md).

### Hämta din bas-URL

Kontakta din Support för att få rätt bas-URL för din miljö. Exempelslutpunkt:

```
https://campaign.<env>.citrusad.com/v3/campaigns
```

När du har din användarnyckel kan du autentisera och börja göra API-anrop till:

* Visa och hantera dina annonskampanjer.
* Hantera dina annonsbudgetar och utgifter.
* Hantera dina team- och användaruppgifter.

## Konfigurera miljön

Epsilon Retail Media tillhandahåller två separata miljöer för varje återförsäljare: Production och Sandbox. Båda miljöerna skapas som standard när en återförsäljare onboardas.

### Sandbox-miljö

{% hint style="info" %}
Sandbox-åtkomst tillhandahålls vanligtvis endast till återförsäljare och aggregatörer. Om du är osäker på din behörighet, kontakta Support.
{% endhint %}

Använd denna säkra miljö för att testa din integration innan du går live. Återförsäljare måste använda denna miljö för att validera API-anrop, testa kataloguppladdningar, simulera kampanjskapande och säkerställa funktion från slut till slut innan de går live. Använd sandbox för all utveckling, testning och QA-aktiviteter. Varje återförsäljare har en unik sandbox-URL, vanligtvis i formatet:

```
https://<retailer>-sandbox.citrusad.com
```

Sandbox-miljön innehåller:

<figure><img src="/files/1n5KxYag0GBRDvqcqn8I" alt="" width="100%"><figcaption></figcaption></figure>

### Produktionsmiljö

Växla till produktion först efter framgångsrik validering i sandbox. Produktionsmiljön används för levande kampanjer och annonsleverans i realtid. Den stöder fullskalig verksamhet inklusive kataloguppdateringar, ordersynkronisering och spårning av annonsresultat. Produktions-URL:en följer detta format:

```
https://<namespace>.citrusad.com
```

Säkerställ att all data (kataloger, produkter, ordrar) är korrekt och fullständig innan du använder denna miljö.

{% hint style="info" %}
Bekräfta alltid rätt miljö innan du gör API-anrop, särskilt när du använder inloggningsuppgifter och bas-URL:er. Bas-URL:en kanske inte alltid matchar namnrymden, beroende på återförsäljarens integrationsinställningar.
{% endhint %}

## Partner API-slutpunkter

Epsilon Retail Media API erbjuder en uppsättning kärnfunktioner grupperade i funktionella kategorier, som var och en stöds av dedikerade slutpunkter. Tabellen nedan sammanfattar de viktigaste partnerinriktade API:erna, deras syfte och de HTTP-metoder som används.

<figure><img src="/files/coN5Q3s9ZBPH6kQmU7fl" alt="" width="100%"><figcaption></figcaption></figure>

### Kampanjhantering

**Vad är en sponsrad produktannons?** Sponsrade produktannonser (SPA) är annonser som placeras i produktnät på återförsäljarens webbplats, vanligtvis på sök- och kategorisidor samt PDP och startsida, varvade med organiska objekt.

**Vad är en Banner X Ad?** Banner X annonser är helt responsiva annonsenheter som växer och ändras med användarens visningsfönster. De består av flera kreativa element från huvud- och bakgrundsbilder till rubriktext och uppmaningsknappar.

**Vad är en bannerannons?** En standardbanner är en statisk bild med en klickbar URL bakom sig.

#### Produktkampanj

| Slutpunkt                                                                                                                                                             | Beskrivning                                                               | Metod |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ----- |
| [Create a product campaign](/retail-media-interface/partner/sv/campaign-management-api/productcampaign-1/createproductcampaign.md)                                    | Skapar en ny produktkampanj med hjälp av informationen i begäransbrödet.  | POST  |
| [Retrieve list of all product campaigns](/retail-media-interface/partner/sv/campaign-management-api/productcampaign-1/listproductcampaigns.md)                        | Hämtar en lista över alla produktkampanjer baserat på angivna parametrar. | GET   |
| [Update a product campaign](/retail-media-interface/partner/sv/campaign-management-api/productcampaign-1/updateproductcampaign.md)                                    | Uppdaterar en befintlig produktkampanj med hjälp av kampanj-ID            | PATCH |
| [Get product campaign by ID](/retail-media-interface/partner/sv/campaign-management-api/productcampaign-1/getproductcampaign-1.md)                                    | Hämtar produktkampanjinformation för angivet kampanj-ID.                  | GET   |
| [Change approval state of a product campaign](/retail-media-interface/partner/sv/campaign-management-api/productcampaign-1/approveproductcampaign-1.md)               | Uppdaterar godkännandestatusen för en angiven produktkampanj.             | POST  |
| [Check booking feasibility for fixed tenancy campaigns](/retail-media-interface/partner/sv/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md) | Kontrollerar om bokning är möjlig för kampanjer med Fast placering.       | POST  |

#### Banner X Kampanj

| Slutpunkt                                                                                                                                           | Beskrivning                                                                                                                                                  | Metod |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
| [Create a Banner X campaign](/retail-media-interface/partner/sv/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md)               | Skapar en ny banner X-kampanj med hjälp av informationen i begäransbrödet.                                                                                   | POST  |
| [Get Banner X campaign details](/retail-media-interface/partner/sv/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md)               | Hämtar banner X-kampanjinformation för angivet kampanj-ID.                                                                                                   | GET   |
| [Update Banner X campaign](/retail-media-interface/partner/sv/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md)                   | Uppdaterar en befintlig Banner X kampanj genom att ange kampanj-ID och uppdaterad kampanjdata i begäransbrödet.                                              | PATCH |
| [Update Banner X campaign approval state](/retail-media-interface/partner/sv/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md) | Uppdaterar godkännandestatusen för en angiven banner X-kampanj.                                                                                              | POST  |
| [Retrieve list of all Banner X campaigns](/retail-media-interface/partner/sv/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md)     | Hämtar en lista över banner X-kampanjer baserat på angivna filter och parametrar, inklusive kampanjnamn, placerings-ID, team-ID, godkännandestatus med mera. | GET   |

#### Bannerkampanj

| Slutpunkt                                                                                                                                   | Beskrivning                                                             | Metod |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ----- |
| [Create a banner campaign](/retail-media-interface/partner/sv/campaign-management-api/bannercampaign/createbannercampaign-1.md)             | Skapar en ny bannerkampanj med hjälp av informationen i begäransbrödet. | POST  |
| [Get banner campaign details](/retail-media-interface/partner/sv/campaign-management-api/bannercampaign/getbannercampaign-1.md)             | Hämtar bannerkampanjinformation för angivet kampanj-ID.                 | GET   |
| [Update banner campaign](/retail-media-interface/partner/sv/campaign-management-api/bannercampaign/updatebannercampaign.md)                 | Uppdaterar en befintlig bannerkampanj med hjälp av kampanj-ID.          | PATCH |
| [Update banner campaign approval state](/retail-media-interface/partner/sv/campaign-management-api/bannercampaign/approvebannercampaign.md) | Uppdaterar godkännandestatusen för en angiven bannerkampanj             | POST  |

#### Kampanjfiler

| Slutpunkt                                                                                                                     | Beskrivning                                                             | Metod |
| ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ----- |
| [Upload a campaign file](/retail-media-interface/partner/sv/campaign-management-api/creativeassets/uploadfile.md)             | Laddar upp olika typer av kampanjfiler                                  | POST  |
| [Retrieve campaign file URL](/retail-media-interface/partner/sv/campaign-management-api/creativeassets/getcampaignfileurl.md) | Hämtar URL:en för en kampanjfil med hjälp av angivet fil-ID och filtyp. | POST  |

#### Innehållsstandard

| Slutpunkt                                                                                                                                                                 | Beskrivning                                                                                                                                 | Metod |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| [Get Banner X content standard details](/retail-media-interface/partner/sv/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md)                 | Hämtar Banner X information om innehållsstandard för angivet innehållsstandard-ID.                                                          | GET   |
| [Retrieve list content standards for Banner X campaigns](/retail-media-interface/partner/sv/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md) | Hämtar listan över innehållsstandarder för Banner X kampanjer baserat på angivna parametrar, såsom namnrymd, namn och innehållsstandard-ID. | GET   |
| [Get banner content standard details](/retail-media-interface/partner/sv/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md)                      | Hämtar information om Banner-innehållsstandard för angivet innehållsstandard-ID.                                                            | GET   |
| [Retrieve list content standards for banner campaigns](/retail-media-interface/partner/sv/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md)    | Hämtar listan över innehållsstandarder för bannerkampanjer baserat på angivna parametrar, såsom namnrymd, namn och innehållsstandard-ID.    | GET   |

#### Kampanj

| Slutpunkt                                                                                                                                  | Beskrivning                                                                                                                                                              | Metod |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
| [Retrieve list of all campaigns](/retail-media-interface/partner/sv/campaign-management-api/campaign/listcampaigns-1.md)                   | Hämtar en lista över kampanjer baserat på angivna filter och parametrar, inklusive kampanjnamn, kampanjtyp, placerings-ID, team-ID, godkännandestatus med mera.          | POST  |
| [Retrieve campaign history](/retail-media-interface/partner/sv/campaign-management-api/campaign/getcampaignhistory.md)                     | Hämtar en kampanjs historik med hjälp av dess kampanj-ID.                                                                                                                | GET   |
| [Retrieve minimum bid details for keywords](/retail-media-interface/partner/sv/campaign-management-api/campaign/retrievekeywordsminbid.md) | Hämtar individuella lägstabudsdetaljer och det totala lägstabudet för kampanjen för en matris av angivna sökord i kampanjer med placeringstypen Sök samt Kategori & Sök. | POST  |
| [Retrieve minimum bid details for category](/retail-media-interface/partner/sv/campaign-management-api/campaign/retrievecategoryminbid.md) | Hämtar individuella lägstabudsdetaljer och det totala lägstabudet för kampanjen för kampanjer med placeringstypen kategori.                                              | POST  |

## Hantering av Annonskreativ tillgångar

### Vad är en tillgång för Annonskreativ?

Tillgångar för Annonskreativ är bilder som används i Banner- och Banner X kampanjer. Dessa tillgångar måste uppfylla specifika tekniska krav för att säkerställa korrekt visning och prestanda.

### Riktlinjer för uppladdning:

* Filstorlek < 4 MB
* Filtyper: PNG, JPEG, JPG, GIF, SVG och PDF
* En fil i taget
* Team ID, Slot ID och Content Standard ID är obligatoriska
* Ange en komplett absolut sökväg till filen

{% hint style="info" %}
Uppladdningar av annonskreativtillgångar hanteras via slutpunkterna för Kampanjfil som listas i avsnittet Kampanjhantering ovan.
{% endhint %}

## Hantering av innehållsstandarder

### Vad är en innehållsstandard?

Innehållsstandarder är riktlinjer och tekniska parametrar som bestämmer hur en banner eller Banner X annons ska visas inom ett angivet utrymme på en webbplats eller digital plattform. Standarder inkluderar parametrar som dimensioner och storlek, filformat och storlekar, upplösning och kvalitet, placering och justering, innehållsbegränsningar och interaktivitet.

### Team- och användarhantering

#### Vad är ett team?

Ett team är en samling användare och klassificeras som antingen ett leverantörs- (annonsörs) eller ett återförsäljarteam. Leverantörsteam skapar vanligtvis kampanjer, medan återförsäljare granskar kampanjer och utför administrativa uppgifter. En användare i systemet kan tillhöra flera team eller bara ett. Vanligtvis har ett team användare, kampanjer och plånböcker kopplade till sig.

#### Team

| Slutpunkt                                                                                       | Beskrivning                                                                                                    | Metod |
| ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ----- |
| [Create team](/retail-media-interface/partner/sv/team-user-api/team/createteam-1.md)            | Skapar ett nytt team.                                                                                          | POST  |
| Uppdatera ett team                                                                              | Uppdaterar informationen för ett team som specificeras med team\_id.                                           | PATCH |
| Lista alla team                                                                                 | Hämtar en lista över team genom att ange parametrar som name, namespace\_id och seller\_id.                    | GET   |
| [Get team for specified ID](/retail-media-interface/partner/sv/team-user-api/team/getteam-1.md) | Hämtar detaljerad information om ett specifikt team, inklusive dess medlemmar.                                 | GET   |
| Gå med i ett team med inbjudningstoken                                                          | Gör det möjligt för användare att gå med i ett team med hjälp av en giltig och icke-utgången inbjudningstoken. | POST  |

#### Användare

| Slutpunkt                                                                                                    | Beskrivning                                                                                             | Metod  |
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | ------ |
| [Invite a user to the team](/retail-media-interface/partner/sv/team-user-api/user-1/createuserteaminvite.md) | Skickar en inbjudan till en användare att gå med i ett angivet team.                                    | POST   |
| Hämta användarinformation med användar-ID                                                                    | Hämtar information om den användare som för närvarande är inloggad på Epsilon Retail Media plattformen. | GET    |
| [Retrieve user details](/retail-media-interface/partner/sv/team-user-api/user-1/getusersforteam.md)          | Hämtar användarinformation baserat på det angivna team-ID:t.                                            | GET    |
| [Update current user detail](/retail-media-interface/partner/sv/team-user-api/user-1/updateuserprofile.md)   | Ändrar informationen för den för närvarande inloggade användaren på Epsilon Retail Media plattformen.   | PATCH  |
| [Modify user permission](/retail-media-interface/partner/sv/team-user-api/user-1/modifyuserpermission.md)    | Uppdaterar en användares behörigheter genom att ange både användar-ID och team-ID.                      | PATCH  |
| [Upload a file](/retail-media-interface/partner/sv/team-user-api/user-1/uploadfile-1.md)                     | Laddar upp logotyper för användarprofiler och team.                                                     | POST   |
| [Retrieve file URL](/retail-media-interface/partner/sv/team-user-api/user-1/getfileurl.md)                   | Hämtar URL:en för en team- eller användarlogotyp med hjälp av det angivna fil-ID:t.                     | POST   |
| Ta bort en användare                                                                                         | Tar bort en användare från teamet.                                                                      | DELETE |

### Fakturering och plånbokshantering

#### Vad är en plånbok?

En plånbok lagrar en annonsörs medel i syfte att göra betalningar (t.ex. betala för förverkligade annonser).

#### Plånbok

| Slutpunkt                                                                                                         | Beskrivning                                                                                                                                  | Metod |
| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| [Create a wallet](/retail-media-interface/partner/sv/billing-api/wallet/createwallet.md)                          | Skapar en plånbok inom ett angivet namnområde och kopplar den till ett team med hjälp av team-ID:t.                                          | POST  |
| [Update a wallet](/retail-media-interface/partner/sv/billing-api/wallet/updatewallet-1.md)                        | Uppdaterar en plånbok inom ett angivet namnområde och teamId.                                                                                | PATCH |
| [Retrieve wallet by ID](/retail-media-interface/partner/sv/billing-api/wallet/getwallet-1.md)                     | Hämtar informationen för en specifik plånbok med hjälp av dess unika identifierare, {id}.                                                    | GET   |
| [List all wallets](/retail-media-interface/partner/sv/billing-api/wallet/listwallets.md)                          | Hämtar en lista över plånböcker baserat på angivna filter och parametrar, inklusive team-ID, plånboksnamn, plånboks-ID, externt ID med mera. | GET   |
| [Get the balance of a specific wallet](/retail-media-interface/partner/sv/billing-api/wallet/getwalletbalance.md) | Hämtar det aktuella saldot för en angiven plånbok.                                                                                           | GET   |
| [Manage funds to a specific wallet](/retail-media-interface/partner/sv/billing-api/wallet/managefunds.md)         | Hanterar transaktioner av medel för en specifik plånbok.                                                                                     | POST  |

#### Spend

| Slutpunkt                                                                                                   | Beskrivning                                                                                                       | Metod |
| ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----- |
| [Retrieve campaign spend details](/retail-media-interface/partner/sv/billing-api/spend/getcampaignspend.md) | Beräknar den återstående budgeten för specifika kampanjer baserat på deras tillgängliga saldo och utgiftsgränser. | POST  |

### Massåtgärd

#### Kampanj

| Slutpunkt                                                                                                                              | Beskrivning                                                                              | Metod |
| -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ----- |
| [Create campaigns in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md)         | Skapar flera kampanjer samtidigt (upp till 1 000) baserat på kampanjtyp.                 | POST  |
| [Update campaigns in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md)       | Uppdaterar kampanjer inom ett angivet namnområde.                                        | PATCH |
| [Update campaign approval state](/retail-media-interface/partner/sv/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | Godkänner eller avvisar kampanjer inom ett angivet namnområde.                           | POST  |
| Hämta status för massåtgärd                                                                                                            | Hämtar status och information för en masskampanjåtgärd med hjälp av ID för massåtgärden. | GET   |

#### Plånbok

| Slutpunkt                                                                                                                               | Beskrivning                                                              | Metod |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ----- |
| [Create wallets in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md)                | Skapa flera plånböcker samtidigt inom din organisation (upp till 1 000). | POST  |
| [Retrieve bulk wallet operation status](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | Hämtar statusen för en massplånboksåtgärd med hjälp av dess mass-ID.     | GET   |
| [Update wallets in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md)                | Uppdaterar flera plånböcker samtidigt.                                   | PATCH |

#### Team

| Slutpunkt                                                                                                                             | Beskrivning                                                      | Metod |
| ------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ----- |
| [Create teams in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md)                | Skapar massteam för en organisation.                             | POST  |
| [Update teams in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md)                | Uppdaterar flera team samtidigt.                                 | PATCH |
| [Retrieve bulk team operation status](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | Hämtar statusen för en massteamåtgärd med hjälp av dess mass-ID. | GET   |

### Föreslagen sökterm

#### Vad är föreslagna söktermer?

Föreslagna söktermer är en samling termer som tillhandahålls via en fil från återförsäljaren som kopplar produkter till specifika termer som visas för användaren när hen skapar en kampanj i steget söktermer. För mer information, se Föreslagna söktermer.

| Slutpunkt                                                                                                                                        | Beskrivning                                                                                                                            | Metod |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| [Lists all suggested search terms](/retail-media-interface/partner/sv/suggested-search-term-api/suggestedsearchterm/listsuggestedsearchterms.md) | Hämtar föreslagna söktermer för katalogriktade föreslagna söktermer baserat på angivna parametrar som katalog-ID, produktkod med mera. | GET   |

## Bästa praxis

Följ dessa bästa praxis för att säkerställa en smidig, effektiv och tillförlitlig integration med Epsilon Retail Media Partner-API:flag\_er:

* Testa alltid i sandbox före produktionsdistribution.
* Använd masslutpunkter för flera åtgärder.
* Kontrollera specifika dataproblem i felsvar.
* Använd komprimerade filer för snabbare datauppladdningar.
* Förnya åtkomsttokens endast när de har gått ut.
* Validera obligatoriska fält innan du skickar begäranden.

## Felhantering

Våra partner-API:er returnerar strukturerade JSON-felsvar för att stödja robust undantagshantering.

* **HTTP-statuskod**: Standardfelkoder (400, 401, 403, 500, etc.)
* **Felkod**: Specifik felidentifierare.
* **Meddelande**: Läsbar felbeskrivning för människor.
* **Fältöverträdelser**: Specifika fältvalideringsfel för datainmatningsproblem.

För detaljerad information om felhantering, se [Felhantering](/retail-media-interface/partner/sv/partner-api-overview/error-handling.md).

## Support och resurser

| Resurs                                                                                                              | Beskrivning                                                             |
| ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| [Frequently asked questions](/retail-media-interface/partner/sv/partner-api-overview/frequently-asked-questions.md) | Vanliga frågor och svar relaterade till API-användning och integration. |
| Releasenoter                                                                                                        | Sammanfattning av senaste uppdateringar eller ändringar i API:et.       |
| [Glossary](https://developers.citrusad.com/partner/docs/createupdate-campaign-fields-1)                             | Definitioner av nyckelbegrepp som används i hela API-dokumentationen.   |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/partner/sv/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.