Octibiz
Demo

Durchsucht Website und Dokumentation gemeinsam. Enter zeigt alle Treffer, Esc schließt.

Werbenetze verbinden

Ansicht Werbenetze verbinden in Octibiz

Überblick

Welche Anzeigentypen Meta, TikTok und LinkedIn nehmen und wie sie im Anzeigen-Studio entstehen, steht dort.

Neben Meta, LinkedIn und TikTok schaltet Octibiz Werbung bei Google Ads, Microsoft Advertising (Bing), Pinterest und ChatGPT. Für alle gilt dasselbe wie bei den übrigen Werbekampagnen:

  • Der Budget-Deckel ist Pflicht und gilt für jeden Weg — Mensch, Automatisierung, KI.
  • Jede Kampagne entsteht beim Netz pausiert. Scharf schaltet erst, wer marketing.ads.publish hat.
  • Die Zahlen kommen jeden Tag zurück (Ausspielungen, Klicks, Ausgaben, Abschlüsse, Umsatz) und

stehen in der Auswertung neben Meta & Co. Die Herkunfts-Merkmale (utm_source = Netz) hängt das System selbst an.

Alle vier Netze sind ab Werk aus. Sie werden unter Einstellungen → Marketing → Werbe-Netzwerke eingeschaltet — dort steht je Netz auch, ob ein Werbekonto verbunden ist und was noch fehlt.

NetzWie verbunden wirdKampagnentypen
Google AdsAnmelde-Knopf „Mit Google Ads verbinden“, danach Werbekonto wählenSuche (responsive Suchanzeige), Performance Max, Display, YouTube / Demand Gen, Shopping
Microsoft AdvertisingAnmelde-Knopf „Mit Microsoft Advertising verbinden“, danach Werbekonto wählenSuche, Zielgruppen, Shopping
PinterestPinterest-Verbindung unter Social Media mit Werbekonto verbindenStandard-, Video-, Karussell- und Shopping-Pins
ChatGPTAdvertiser-Schlüssel aus dem Ads Manager von OpenAI an der IntegrationAnzeige im Gespräch, Produkt-Feed

Kernaufgaben

Netz einschalten. Unter Einstellungen → Marketing → Werbe-Netzwerke den Schalter des Netzes umlegen (Recht platform.settings.manage). Ausgeschaltet entsteht keine Kampagne dieses Netzes.

Google Ads verbinden. Zuerst die App-Zugangsdaten hinterlegen: Einstellungen → Integrationen → Integration anlegen → Vorlage „Google Ads“ mit client_id, client_secret (OAuth-Client eines Google-Cloud-Projekts, Typ Webanwendung), developer_token und — wenn Sie über ein Verwaltungskonto arbeiten — login_customer_id (MCC, Ziffern ohne Bindestriche). Als Rückweg-Adresse tragen Sie im OAuth-Client https://<Ihre-Adresse>/api/v1/marketing/public/ads/oauth/callback ein. Danach in den Werbe-Netzwerken Mit Google Ads verbinden klicken, bei Google zustimmen (Recht adwords) und zurück in Octibiz das Werbekonto wählen. Angeboten werden nur Werbekonten, keine Verwaltungskonten.

Microsoft Advertising verbinden. Vorlage „Microsoft Advertising“ mit client_id und client_secret einer App-Registrierung in Microsoft Entra (Recht msads.manage, Rückweg-Adresse wie oben), developer_token aus dem Microsoft-Advertising-Developer-Portal und optional tenant (Vorgabe common). Danach Mit Microsoft Advertising verbinden und das Werbekonto wählen.

Pinterest-Werbung verbinden. Pinterest-Werbung nutzt denselben Pinterest-Zugang wie die Pins. Unter Einstellungen → Integrationen → Social Media bei Pinterest Werbekonto verbinden klicken — das holt die Werbe-Zustimmung (ads:read, ads:write, catalogs:read) nach — und das Werbekonto wählen. Werbe-Pins brauchen eine gewählte Pinnwand.

ChatGPT verbinden. Im Ads Manager von OpenAI unter Einstellungen einen Advertiser-API-Schlüssel erzeugen und in der Vorlage „ChatGPT Ads (OpenAI)“ als api_key hinterlegen. Ein Schlüssel gehört zu genau einem Werbekonto — eine Konto-Wahl gibt es nicht. Optional target_countries (z. B. DE, AT) für die Länder der Kampagnen.

Kampagnentyp wählen. Im Brief-Assistenten (Anzeige planen) erscheint nach der Wahl des Netzes Welche Art von Kampagne? mit den Typen dieses Netzes. Ohne Wahl gilt der erste Typ. Der Typ steht fest, sobald die Kampagne beim Netz angelegt ist.

Produkt-Feed übergeben. Shopping-Kampagnen zeigen Ihre Artikel. Unter Einstellungen → Marketing → Produkt-Feed die Produkt-Adresse im Shop als Vorlage eintragen (z. B. https://shop.example.de/p/{sku}) und das Verkaufsland. Die Feed-Adresse kopieren und beim Netz hinterlegen:

  • Google Merchant Center: Produkte → Feeds → neuer Feed → Geplanter Abruf mit der Adresse;

Merchant Center mit Google Ads verknüpfen und die Händler-Kennung als merchant_id an der Google-Ads-Integration hinterlegen.

  • Microsoft Merchant Center: Store anlegen → Feeds → Geplanter Download mit der Adresse; die

Laden-Kennung als store_id an der Microsoft-Integration hinterlegen.

  • Pinterest: Pinterest Business → Kataloge → Datenquelle hinzufügen → die Adresse (Format XML).
  • ChatGPT: die CSV herunterladen, im Ads Manager einen Produkt-Feed anlegen, über den

SFTP-Zugang hochladen und die Feed-Kennung als product_feed_id an der Integration hinterlegen.

Im Feed stehen nur verkaufbare Waren mit Preis, Produkt-Adresse und Bild. Was fehlt, zählt die Seite mit („ohne Preis“, „ohne Produkt-Adresse“, „ohne Bild“). Ohne das Artikel-Modul gibt es keinen Feed.

Übergabe an den Ads Manager (ChatGPT). In der Überwachung einer ChatGPT-Kampagne zeigt Übergabe-Paket anzeigen Überschriften, Texte, Ziel-Adressen (mit Herkunfts-Merkmalen), Budget und Deckel samt Anleitung — als Liste und als CSV zum Kopieren. Ohne Advertiser-Schlüssel legen Sie die Kampagne damit im Ads Manager an: Budget und Pausieren stehen dann im Ads Manager von OpenAI, nicht in Octibiz.

Was je Netz einzurichten ist

NetzBeim NetzIn Octibiz
Google AdsGoogle-Cloud-Projekt mit OAuth-Client; Entwickler-Schlüssel im Verwaltungskonto (MCC) beantragen — Basic-Zugang reicht für eigene Konten, Standard-Zugang für viele; Merchant Center für ShoppingIntegration „Google Ads“, Schalter an, verbinden, Werbekonto wählen
Microsoft AdvertisingApp-Registrierung in Microsoft Entra; Entwickler-Schlüssel im Developer-Portal; Microsoft Merchant Center für ShoppingIntegration „Microsoft Advertising“, Schalter an, verbinden, Werbekonto wählen
PinterestPinterest-App mit Standard access für die Ads-Schnittstelle; Werbekonto im Pinterest Business HubPinterest-Verbindung, Werbekonto verbinden, Schalter an
ChatGPTWerbekonto im Ads Manager von OpenAI (ads.openai.com), Advertiser-API-SchlüsselIntegration „ChatGPT Ads (OpenAI)“, Schalter an

Felder im Detail

Werbekampagne

FeldPflichtWerte / FormatWas es bewirkt
Netzwerk platformjagoogle, microsoft, pinterest, chatgpt (neben meta, linkedin, tiktok)Wo geworben wird — nur eingeschaltete Netze.
Kampagnentyp campaignTypeneinGoogle search, performance_max, display, demand_gen, shopping · Microsoft search, audience, shopping · Pinterest standard, video, carousel, shopping · ChatGPT chat, shoppingWas beim Netz entsteht. Leer = erster Typ des Netzes. Ein Typ eines anderen Netzes wird abgelehnt.

Werbekonto wählen

FeldPflichtWerte / FormatWas es bewirkt
Werbenetz providerjagoogle_ads, microsoft_ads, openai_adsFür welches Netz gewählt oder getrennt wird.
Werbekonto accountIdja (Wählen)eine der angebotenen KennungenWelches Werbekonto Geld ausgibt. Nur Konten aus dem Angebot nach der Anmeldung — eine frei getippte Kennung wird abgelehnt.
Marke brandIdneineine Ihrer MarkenFür welche Marke das Werbekonto gilt; leer = markenübergreifend.

Integrationen der Werbenetze

FeldNetzWas es bewirkt
client_id / client_secretGoogle, MicrosoftDie App, mit der sich die Installation beim Netz anmeldet. Das Geheimnis wird verschlüsselt abgelegt.
developer_tokenGoogle, MicrosoftEntwickler-Schlüssel des Netzes — ohne ihn lassen sich keine Werbekonten lesen. Verschlüsselt.
login_customer_idGoogleVerwaltungskonto (MCC), über das die Werbekonten erreicht werden.
merchant_idGoogleHändler-Kennung im Merchant Center — Pflicht für Shopping.
tenantMicrosoftMandant der App-Registrierung, Vorgabe common.
store_id / sales_countryMicrosoftLaden im Microsoft Merchant Center und Verkaufsland — Pflicht für Shopping.
api_keyChatGPTAdvertiser-API-Schlüssel des Werbekontos. Verschlüsselt.
target_countriesChatGPTLänder der Kampagnen als ISO-Codes, durch Komma getrennt.
product_feed_idChatGPTKennung des Produkt-Feeds im Ads Manager — Pflicht für Shopping.
page_id, ig_user_idMetaFacebook-Seite und Instagram-Konto, in deren Namen die Anzeigen erscheinen (Konto-Wahl der Social-Verbindung).
dsa_beneficiary, dsa_payorMetaBegünstigter und Zahler nach dem Digital Services Act — Pflicht für Anzeigen in der EU.
catalog_id, product_set_id, pixel_idMetaProduktkatalog im Commerce Manager (Katalog-Anzeigen), optional eigene Produktgruppe; Pixel für Optimierung auf Käufe.
identity_id, identity_type, display_nameTikTokAbsender der Anzeigen (eigenes TikTok-Konto, Spark Ads) bzw. Anzeigename einer eigenen Identität.
author_urn, sender_urnLinkedInUnternehmensseite der Anzeigen; Mitglied als Absender von Nachrichten- und Gesprächs-Anzeigen.
ad_library_tokenMetaOptionales eigenes Zeichen für die Werbebibliothek (Konkurrenz-Anzeigen). Verschlüsselt.
research_client_key, research_client_secretTikTokApp der Commercial Content API für die Werbebibliothek. Das Geheimnis wird verschlüsselt.

Einstellungen & Rechte

  • Schalter marketing.ads.google.enabled, marketing.ads.microsoft.enabled,

marketing.ads.pinterest.enabled, marketing.ads.chatgpt.enabled — ab Werk aus, Recht platform.settings.manage.

  • Produkt-Feed marketing.ads.feedLinkTemplate (Produkt-Adresse mit {sku}, {ulid} oder {id}),

marketing.ads.feedCountry (Vorgabe DE), marketing.ads.feedReturnPolicyUrl (Rückgabe-Seite für ChatGPT).

  • marketing.ads.connect — Werbekonten verbinden, wählen, trennen; Feed-Adressen sehen.
  • marketing.ads.view — Stand der Netze und Übergabe-Paket sehen.
  • API: GET /api/v1/marketing/ad-platforms, GET /api/v1/marketing/ad-connections,

POST /api/v1/marketing/ad-connections/select-account, POST /api/v1/marketing/ad-connections/disconnect, GET /api/v1/marketing/ad-product-feed, GET /api/v1/marketing/ad-campaigns/{ulid}/handover.

FAQ & Fehlerbilder

„App-Zugangsdaten fehlen“ beim Verbinden. An der Integration des Netzes fehlen client_id oder client_secret. Unter Einstellungen → Integrationen nachtragen.

Nach der Anmeldung steht „Kein Werbekonto gefunden“. Meist fehlt der Entwickler-Schlüssel oder das angemeldete Konto hat keinen Zugriff auf ein Werbekonto. Bei Google werden Verwaltungskonten bewusst nicht angeboten — sie geben kein Geld aus.

Scharfschalten meldet „Zugang fehlt“. Für das Netz ist in dieser Marke kein Werbekonto gewählt (Google, Microsoft, Pinterest) bzw. kein Advertiser-Schlüssel hinterlegt (ChatGPT).

Shopping-Kampagne scheitert mit „Merchant Center“ bzw. „product_feed_id“. Shopping braucht den Produkt-Feed beim Netz und die Kennung an der Integration (merchant_id, store_id bzw. product_feed_id).

ChatGPT-Anzeigen laufen in einem Land nicht. OpenAI gibt Anzeigen nur in bestimmten Ländern frei, je Werbekonto verschieden. Welche das sind, zeigt der Ads Manager. Octibiz zeigt das als Hinweis beim Netz.

Wo pausiere ich eine ChatGPT-Kampagne? Mit Advertiser-Schlüssel hier, wie bei jedem Netz. Ohne Schlüssel im Ads Manager von OpenAI.

Eine Suchkampagne bei Google hat keine Anzeige. Die responsive Suchanzeige braucht mindestens drei Überschriften, zwei Beschreibungen und eine Ziel-Adresse in der ersten Anzeigengruppe. Fehlt etwas, entsteht nur die Kampagne mit Gruppe — ergänzen Sie die Fassungen oder die Anzeige im Werbekonto. Performance Max, Display und Demand Gen brauchen Bild-Assets, die Sie im Werbekonto zur Kampagne hinzufügen.

marketing.ad-networks · Gilt ab Version 0.6.484