Hopp til innhold
Remote Sunrise

Remote Sunrises veiledninger

Koble SearchAds Manager til Codex

Aktiver den lokale MCP-serveren i SearchAds Manager, koble den til Codex, og verifiser den med en enkel funksjonstest med midlertidige data i Apple Search Ads.

Tilbake MCP-oversikt

Bruk denne siden når du vil at Codex skal jobbe mot Apple Search Ads gjennom den lokale SearchAds Manager-appen i stedet for et tilpasset API-skript.

1. Sett opp macOS-appen

  1. Codex

    Sender en forespørsel til den lokale MCP-serveren.

  2. SearchAds Manager

    Kjører serveren på din Mac og behandler forespørselen.

  3. Apple Ads

    Returnerer kontodata eller utfører en godkjent kampanjehandling.

La SearchAds Manager kjøre på din Mac. Appen kobler seg til Apple Ads med API-tilgangen du har konfigurert i appen.
  1. Start SearchAds Manager på macOS.
  2. Åpne Innstillinger.
  3. Konfigurer de vanlige påloggingsopplysningene for Apple Search Ads hvis de ikke allerede er angitt.
  4. Åpne Automatisering, og finn deretter delen Codex MCP-server.
  5. Aktiver serveren.
  6. Se over eller endre porten og tokenet ved behov.
  7. Klikk på Bruk serverinnstillinger.
Innstillinger i SearchAds Manager med Automatisering valgt og Aktiver lokal MCP-server merket av
På Mac åpner du Innstillinger → Automatisering og aktiverer den lokale MCP-serveren. Ta i bruk serverinnstillingene, og kopier deretter Codex-kommandoen fra appen.

Hvis påloggingsopplysningene ikke er konfigurert ennå, følger du OAuth-veiledningen fra Apple: Implementering av OAuth for Apple Search Ads-API-et.

2. Legg til serveren i Codex

Innstillingskortet viser den nøyaktige kommandoen du skal kjøre. Kommandoformatet er:

codex mcp add searchads --url "http://127.0.0.1:7717/mcp?token=YOUR_TOKEN"

Når du har lagt den til:

  1. La macOS-appen fortsette å kjøre.
  2. Start en ny Codex-økt i kodelageret der du vil jobbe, eller koble til MCP-serverne på nytt hvis klienten din støtter det.
  3. Bruk searchads-serveren til rapportering og skriveoperasjoner i stedet for manuelle API-skript.
  1. Kall list_apps først når du trenger en adam_id.
  2. Kall list_supported_countries før du oppretter en kampanje når du trenger gyldige landkoder.
  3. Bruk get_campaign_report, get_adgroup_report og get_keyword_report for å undersøke resultatene før du gjør endringer.
  4. Bruk list_campaigns, list_adgroups og list_keywords for å undersøke gjeldende tilstand før du gjør endringer.
  5. Bruk create_campaigns, add_adgroups og add_keywords til oppretting.
  6. Bruk update_campaigns, update_adgroups og update_keywords til kontrollerte endringer.
  7. Bruk delete_campaigns, delete_adgroups og delete_keywords bare til uttrykkelig angitt opprydding som sletter data.
  8. Bruk helst små, klart definerte grupper med skriveoperasjoner, slik at feil blir enklere å gjennomgå.

4. Feilsøking

  1. Hvis Codex ikke kan koble til, kontrollerer du at macOS-appen er åpen og at serverstatusen viser Kjører.
  2. Hvis verktøykall mislykkes med konfigurasjonsfeil, sjekker du påloggingsopplysningene for Apple Search Ads i appinnstillingene på nytt.
  3. Hvis du genererer tokenet på nytt eller endrer porten, kjører du codex mcp add ... på nytt med den nye URL-en.

5. Instruksjoner for en enkel funksjonstest med midlertidige data

Vis de valgfrie ledetekstene for en enkel funksjonstest

Kjør instruksjonene nedenfor i samme Codex-økt, slik at Codex kan huske test-ID-ene den oppretter.

Bruk et navneprefiks for midlertidige tester, for eksempel mcp-smoke-..., og slett alt til slutt. Nye testobjekter har vanligvis måleverdier på null i rapportene; dette bekrefter likevel at rapporteringen via MCP fungerer.

Instruksjon for oppslag

Bruk bare MCP-serveren `searchads` til å forberede en grunnleggende MCP-funksjonstest.

1. Finn en app jeg eier, som jeg trygt kan bruke til en midlertidig testkampanje. Foretrekk en app som samsvarer med "Monitor and Manage Search Ads". Hvis ingen gjør det, skal du liste opp de første 5 appene jeg eier, og velge én.
2. Kall `list_supported_countries`, og velg `US` hvis landet støttes. Velg ellers et land som støttes, og fortell meg hvilken landskode du valgte.
3. Kall `list_campaigns` for kampanjer med navn som begynner med `mcp-smoke-`.
4. Oppgi valgt `adam_id`, landskoden og et unikt testprefiks i formatet `mcp-smoke-YYYYMMDD-HHMMSS`.
5. Ikke opprett noe ennå.

Instruksjon for å opprette en kampanje

Bruk bare MCP-serveren `searchads` til å opprette én midlertidig testkampanje satt på pause, med navnet `<PREFIX>-campaign`, for appen og landet som ble valgt tidligere.

Bruk:
- valgt `adam_id`
- én landskode
- `daily_budget_amount` med verdien 5
- `currency` med verdien `USD`

Kall `list_campaigns` med testprefikset etter opprettelsen, og returner den nye `campaign_id`-verdien.

Instruksjon for kampanjerapport og oppdatering

Bruk bare MCP-serveren `searchads`:

1. Kall `get_campaign_report` for `<CAMPAIGN_ID>` med `days: 0`.
2. Oppdater kampanjen med `update_campaigns` slik at dagsbudsjettet blir 6 USD og statusen blir `ENABLED`.
3. Kall `list_campaigns` på nytt med testprefikset.
4. Oppsummer kampanjens tilstand før og etter oppdateringen.

Instruksjon for å legge til annonsegrupper

Bruk bare MCP-serveren `searchads` til å legge til to annonsegrupper satt på pause i `<CAMPAIGN_ID>`:

1. `<PREFIX>-ag-1`
2. `<PREFIX>-ag-2`

Bruk:
- `default_bid_amount` med verdien 1
- `currency` med verdien `USD`
- `automated_keywords_opt_in` med verdien false

Kall `list_adgroups` for kampanjen etter opprettelsen, og returner begge `ad_group_id`-verdiene.

Instruksjon for annonsegrupperapport og oppdatering

Bruk bare MCP-serveren `searchads`:

1. Kall `get_adgroup_report` for `<CAMPAIGN_ID>` med `days: 0`.
2. Oppdater `<PREFIX>-ag-1` med `update_adgroups` slik at statusen blir `ENABLED`, `default_bid_amount` blir 1.2 USD og `cpa_goal_amount` blir 4 USD.
3. Kall `list_adgroups` på nytt for `<CAMPAIGN_ID>`.
4. Oppsummer den oppdaterte annonsegruppen, og returner dens `ad_group_id`.

Instruksjon for å legge til søkeord

Bruk bare MCP-serveren `searchads` til å legge til søkeord i `<AD_GROUP_ID>` i `<CAMPAIGN_ID>` med ett `keyword_set`.

Bruk:
- `default_bid_amount` med verdien 0.8
- `default_currency` med verdien `USD`

Legg til disse søkeordene:
1. `<PREFIX> exact` med `match_type` `EXACT` og `status` `ACTIVE`
2. `<PREFIX> broad` med `match_type` `BROAD` og `status` `ACTIVE`

Kall `list_keywords` for `<CAMPAIGN_ID>` og `<AD_GROUP_ID>` etter opprettelsen, og returner de opprettede `keyword_id`-verdiene.

Instruksjon for søkeordrapport og oppdatering

Bruk bare MCP-serveren `searchads`:

1. Kall `get_keyword_report` for `<CAMPAIGN_ID>` og `ad_group_ids: [<AD_GROUP_ID>]` med `days: 0`.
2. Oppdater EXACT-søkeordet med `update_keywords` slik at budet blir 0.9 USD og statusen blir `PAUSED`.
3. Kall `list_keywords` på nytt for `<CAMPAIGN_ID>` og `<AD_GROUP_ID>`.
4. Oppsummer det oppdaterte søkeordet, og returner begge gjeldende søkeordrader.

Instruksjon for opprydding

Bruk bare MCP-serveren `searchads` til å rydde opp etter MCP-funksjonstesten.

1. Slett alle testsøkeord i `<AD_GROUP_ID>` med `delete_keywords`.
2. Kall `list_keywords` for `<CAMPAIGN_ID>` og `<AD_GROUP_ID>` for å bekrefte at søkeordene er slettet.
3. Slett begge testannonsegruppene med `delete_adgroups`.
4. Kall `list_adgroups` for `<CAMPAIGN_ID>` for å bekrefte at annonsegruppene er slettet.
5. Slett testkampanjen med `delete_campaigns`.
6. Kall `list_campaigns` med testprefikset for å bekrefte at kampanjen er slettet.
7. Oppsummer resultatene av oppryddingen.