Gå til indhold
Remote Sunrise

Remote Sunrises vejledninger

Forbind SearchAds Manager med Codex

Aktivér den lokale MCP-server i SearchAds Manager, tilslut den til Codex, og kontrollér den med en Apple Search Ads-funktionstest med midlertidige testdata.

Tilbage MCP-oversigt

Brug denne side, når du vil have Codex til at arbejde med Apple Search Ads via den lokale SearchAds Manager-app i stedet for et brugerdefineret API-script.

1. Konfigurer macOS-appen

  1. Codex

    Sender en anmodning til den lokale MCP-server.

  2. SearchAds Manager

    Kører serveren på din Mac og håndterer anmodningen.

  3. Apple Ads

    Returnerer kontodata eller udfører en godkendt kampagnehandling.

Lad SearchAds Manager køre på din Mac. Den opretter forbindelse til Apple Ads med den API-adgang, du har konfigureret i appen.
  1. Start SearchAds Manager på macOS.
  2. Åbn Indstillinger.
  3. Angiv de sædvanlige adgangsoplysninger til Apple Search Ads, hvis de ikke allerede er angivet.
  4. Åbn Automatisering, og find derefter afsnittet Codex MCP-server.
  5. Aktivér serveren.
  6. Gennemgå eller ændr port og token efter behov.
  7. Klik på Anvend serverindstillinger.
Indstillinger i SearchAds Manager med Automatisering valgt og Aktivér lokal MCP-server markeret
På Mac skal du åbne Indstillinger → Automatisering og aktivere den lokale MCP-server. Anvend serverindstillingerne, og kopier derefter Codex-kommandoen fra appen.

Hvis adgangsoplysningerne endnu ikke er konfigureret, skal du følge Apples OAuth-vejledning: Implementering af OAuth til Apple Search Ads-API'en.

2. Føj serveren til Codex

Indstillingskortet viser præcis den kommando, du skal køre. Kommandoformatet er:

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

Når serveren er tilføjet:

  1. Lad macOS-appen køre.
  2. Start en ny Codex-session i det kodelager, du vil arbejde i, eller genopret forbindelsen til MCP-serverne, hvis din klient understøtter det.
  3. Brug serveren searchads til rapportering og skriveoperationer i stedet for manuelt at skrive API-scripts.
  1. Kald list_apps først, når du har brug for et adam_id.
  2. Kald list_supported_countries før oprettelse af kampagner, når du har brug for gyldige landekoder.
  3. Brug get_campaign_report, get_adgroup_report og get_keyword_report til at undersøge resultaterne, før du foretager ændringer.
  4. Brug list_campaigns, list_adgroups og list_keywords til at undersøge den aktuelle tilstand, før du foretager ændringer.
  5. Brug create_campaigns, add_adgroups og add_keywords til oprettelsesforløb.
  6. Brug update_campaigns, update_adgroups og update_keywords til kontrollerede ændringer.
  7. Brug delete_campaigns, delete_adgroups og delete_keywords kun til udtrykkeligt angivet destruktiv oprydning.
  8. Foretag helst skriveoperationer i små, klart afgrænsede grupper, så fejl er lettere at gennemgå.

4. Fejlfinding

  1. Hvis Codex ikke kan oprette forbindelse, skal du kontrollere, at macOS-appen er åben, og at serverstatussen viser Kører.
  2. Hvis værktøjskald mislykkes med konfigurationsfejl, skal du kontrollere Apple Search Ads-adgangsoplysningerne i appens indstillinger igen.
  3. Hvis du genererer et nyt token eller ændrer porten, skal du køre codex mcp add ... igen med den nye URL.

5. Prompter til funktionstest med midlertidige testdata

Vis de valgfrie prompter til en grundlæggende funktionstest

Kør prompterne nedenfor i den samme Codex-session, så den kan huske de test-id'er, den opretter.

Brug et navnepræfiks til midlertidige testdata såsom mcp-smoke-..., og slet det hele til sidst. Nyoprettede testobjekter har som regel nulværdier for målingerne i rapporter; det bekræfter stadig, at rapporteringen via MCP fungerer.

Prompt til søgning

Brug kun MCP-serveren `searchads` til at forberede en grundlæggende MCP-funktionstest.

1. Find en app, som jeg ejer, og som jeg sikkert kan bruge til en midlertidig testkampagne. Foretræk en app, der matcher "Monitor and Manage Search Ads". Ellers skal du vise de første 5 apps, jeg ejer, og vælge en af dem.
2. Kald `list_supported_countries`, og vælg `US`, hvis landet understøttes. Vælg ellers et understøttet land, og fortæl mig, hvilken landekode du valgte.
3. Kald `list_campaigns` for kampagner, hvis navne starter med `mcp-smoke-`.
4. Fortæl mig det valgte `adam_id`, landekoden og et unikt testpræfiks i formatet `mcp-smoke-YYYYMMDD-HHMMSS`.
5. Opret ikke noget endnu.

Prompt til oprettelse af kampagner

Brug kun MCP-serveren `searchads` til at oprette en midlertidig testkampagne på pause med navnet `<PREFIX>-campaign` for den app og det land, der blev valgt tidligere.

Brug:
- det valgte `adam_id`
- en landekode
- `daily_budget_amount` med værdien 5
- `currency` med værdien `USD`

Kald `list_campaigns` med testpræfikset efter oprettelsen, og returner det nye `campaign_id`.

Prompt til rapportering og opdatering af kampagner

Brug kun MCP-serveren `searchads`:

1. Kald `get_campaign_report` for `<CAMPAIGN_ID>` med `days: 0`.
2. Opdater kampagnen med `update_campaigns`, så dagsbudgettet bliver 6 USD, og status bliver `ENABLED`.
3. Kald `list_campaigns` igen med testpræfikset.
4. Opsummer kampagnens tilstand før og efter opdateringen.

Prompt til tilføjelse af annoncegrupper

Brug kun MCP-serveren `searchads` til at føje to annoncegrupper på pause til `<CAMPAIGN_ID>`:

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

Brug:
- `default_bid_amount` med værdien 1
- `currency` med værdien `USD`
- `automated_keywords_opt_in` med værdien false

Kald `list_adgroups` for kampagnen efter oprettelsen, og returner begge `ad_group_id`-værdier.

Prompt til rapportering og opdatering af annoncegrupper

Brug kun MCP-serveren `searchads`:

1. Kald `get_adgroup_report` for `<CAMPAIGN_ID>` med `days: 0`.
2. Opdater `<PREFIX>-ag-1` med `update_adgroups`, så status bliver `ENABLED`, `default_bid_amount` bliver 1.2 USD, og `cpa_goal_amount` bliver 4 USD.
3. Kald `list_adgroups` igen for `<CAMPAIGN_ID>`.
4. Opsummer den opdaterede annoncegruppe, og returner dens `ad_group_id`.

Prompt til tilføjelse af søgeord

Brug kun MCP-serveren `searchads` til at føje søgeord til `<AD_GROUP_ID>` i `<CAMPAIGN_ID>` med ét `keyword_set`.

Brug:
- `default_bid_amount` med værdien 0.8
- `default_currency` med værdien `USD`

Tilføj disse søgeord:
1. `<PREFIX> exact` med `match_type` `EXACT` og `status` `ACTIVE`
2. `<PREFIX> broad` med `match_type` `BROAD` og `status` `ACTIVE`

Kald `list_keywords` for `<CAMPAIGN_ID>` og `<AD_GROUP_ID>` efter oprettelsen, og returner de oprettede `keyword_id`-værdier.

Prompt til rapportering og opdatering af søgeord

Brug kun MCP-serveren `searchads`:

1. Kald `get_keyword_report` for `<CAMPAIGN_ID>` og `ad_group_ids: [<AD_GROUP_ID>]` med `days: 0`.
2. Opdater EXACT-søgeordet med `update_keywords`, så buddet bliver 0.9 USD, og status bliver `PAUSED`.
3. Kald `list_keywords` igen for `<CAMPAIGN_ID>` og `<AD_GROUP_ID>`.
4. Opsummer det opdaterede søgeord, og returner begge aktuelle søgeordsrækker.

Prompt til oprydning

Brug kun MCP-serveren `searchads` til at rydde op efter MCP-funktionstesten.

1. Slet alle testsøgeord i `<AD_GROUP_ID>` med `delete_keywords`.
2. Kald `list_keywords` for `<CAMPAIGN_ID>` og `<AD_GROUP_ID>` for at bekræfte, at søgeordene er slettet.
3. Slet begge testannoncegrupper med `delete_adgroups`.
4. Kald `list_adgroups` for `<CAMPAIGN_ID>` for at bekræfte, at annoncegrupperne er slettet.
5. Slet testkampagnen med `delete_campaigns`.
6. Kald `list_campaigns` med testpræfikset for at bekræfte, at kampagnen er slettet.
7. Opsummer resultaterne af oprydningen.