Vorlagenanzeigen

Vorlagenanzeigen bieten eine flexible Möglichkeit, neue Anzeigenformate zusätzlich zu den in die AdWords API integrierten Anzeigentypen zu erstellen.

Eine Vorlagenanzeige besteht aus einer Vorlage (durch die Vorlagen-ID festgelegt) und den Daten, mit denen die Felder der Vorlage gefüllt werden. Mit Vorlagenanzeigen können Sie eine Anzeige erstellen, die nicht als feststehender Anzeigentyp verfügbar ist, wie etwa Gmail-Anzeigen oder gesponserte YouTube-Videoanzeigen. Auf der Referenzseite für Anzeigenvorlagen finden Sie eine vollständige Liste der unterstützten Anzeigenvorlagen.

Sobald Sie eine Anzeigenvorlage erstellt haben, können Sie Kopien der Anzeige erstellen, indem Sie auf originadid verweisen, anstatt dieselben Medien erneut hochzuladen.

In diesem Leitfaden wird beispielhaft die Erstellung einiger Arten von Anzeigenvorlagen beschrieben.

App-Anzeigen

Mit der AdWords API können App-Anzeigen erstellt werden. Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer App-Anzeige:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <operations>
        <operator>ADD</operator>
        <operand>
          <adGroupId>XXXXX</adGroupId>
          <ad xsi:type="TemplateAd">
            <url>http://play.google.com/store/apps/details?id=INSERT_ANDROID_APP_PACKAGE_HERE</url>
            <displayUrl>play.google.com/store</displayUrl>
            <templateId>353</templateId>
            <templateElements>
              <uniqueName>adData</uniqueName>
              <fields>
                <name>appId</name>
                <type>TEXT</type>
                <fieldText>XXXXX</fieldText>
              </fields>
              <fields>
                <name>appStore</name>
                <type>ENUM</type>
                <fieldText>XXXXX</fieldText>
              </fields>
              <fields>
                <name>headline</name>
                <type>TEXT</type>
                <fieldText>My awesome app</fieldText>
              </fields>
              <fields>
                <name>description1</name>
                <type>TEXT</type>
                <fieldText>Must download</fieldText>
              </fields>
              <fields>
                <name>description2</name>
                <type>TEXT</type>
                <fieldText>Best app ever</fieldText>
              </fields>
            </templateElements>
            <name>My App Promotion Ad</name>
          </ad>
          <status>ENABLED</status>
        </operand>
      </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Sie können Anzeigen für erneute App-Interaktion für Kampagnen mit App-Interaktions-Anzeigen für das Suchnetzwerk erstellen. Diese Anzeigen sind auf Nutzer ausgerichtet, die Ihre App bereits installiert haben.

Eine Anzeige für erneute App-Interaktion enthält einen Deep-Link zu einer bestimmten Aktion in Ihrer App, um Nutzer zu ermutigen, die Aktion auszuführen.

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer Anzeige für erneute App-Interaktion:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header>
    <ns1:RequestHeader xmlns:ns1="https://adwords.google.com/api/adwords/cm/v201802"
        soapenv:mustUnderstand="0">
      <ns1:clientCustomerId>...</ns1:clientCustomerId>
      <ns1:developerToken>...</ns1:developerToken>
      <ns1:userAgent>...</ns1:userAgent>
      <ns1:validateOnly>false</ns1:validateOnly>
      <ns1:partialFailure>false</ns1:partialFailure>
    </ns1:RequestHeader>
  </soapenv:Header>
  <soapenv:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <operations>
        <operator>ADD</operator>
        <operand>
          <adGroupId>XXXXX</adGroupId>
          <ad xmlns:ns2="https://adwords.google.com/api/adwords/cm/v201802" xsi:type="ns2:TemplateAd">
            <!-- Deep link -->
            <url>android-app://com.example.android/exampleapp/productid_1234</url>
            <displayUrl>example.com</displayUrl>
            <templateId>453</templateId>
            <templateElements>
              <uniqueName>adData</uniqueName>
              <fields>
                <name>appStore</name>
                <type>ENUM</type>
                <fieldText>2</fieldText>
              </fields>
              <fields>
                <name>appId</name>
                <type>TEXT</type>
                <fieldText>com.example.app</fieldText>
              </fields>
              <fields>
                <name>headline</name>
                <type>TEXT</type>
                <fieldText>Intergalactic cruise</fieldText>
              </fields>
              <fields>
                <name>description1</name>
                <type>TEXT</type>
                <fieldText>Free pretzels</fieldText>
              </fields>
              <fields>
                <name>description2</name>
                <type>TEXT</type>
                <fieldText>In-flight movies available</fieldText>
              </fields>
            </templateElements>
            <name>My App Reengagement Ad</name>
          </ad>
          <status>ENABLED</status>
        </operand>
      </operations>
    </mutate>
  </soapenv:Body>
</soapenv:Envelope>

Gmail-Anzeigen

In den folgenden Abschnitten wird beschrieben, wie Sie mehrere unterschiedliche Typen von Gmail-Anzeigen erstellen.

Gmail-Bildanzeige

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer Gmail-Bildanzeige:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201802">
        <operations>
            <operator>ADD</operator>
            <operand>
                <adGroupId>XXXXX</adGroupId>
                <ad xmlns:ns2="https://adwords.google.com/api/adwords/cm/v201802" xsi:type="ns2:TemplateAd">
                    <displayUrl>www.example.com</displayUrl>
                    <finalUrls>http://www.example.com</finalUrls>
                    <templateId>459</templateId>
                    <templateElements>
                        <uniqueName>adData</uniqueName>
                        <fields>
                            <name>layout</name>
                            <type>ENUM</type>
                            <fieldText>gmail_image_ad_v1</fieldText>
                        </fields>
                        <fields>
                            <name>image</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>description</name>
                            <type>TEXT</type>
                            <fieldText>Round trip to Mars</fieldText>
                        </fields>
                        <fields>
                            <name>subject</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic cruise</fieldText>
                        </fields>
                        <fields>
                            <name>advertiser</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic Cruises, Inc.</fieldText>
                        </fields>
                        <fields>
                            <name>logo</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                    </templateElements>
                    <name>Gmail image ad</name>
                </ad>
                <status>PAUSED</status>
            </operand>
        </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Gmail-Anzeige für eine einzelne Werbeaktion

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer Gmail-Anzeige für eine einzelne Werbeaktion:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201802">
        <operations>
            <operator>ADD</operator>
            <operand>
                <adGroupId>XXXXX</adGroupId>
                <ad xmlns:ns2="https://adwords.google.com/api/adwords/cm/v201802" xsi:type="ns2:TemplateAd">
                    <displayUrl>www.example.com</displayUrl>
                    <finalUrls>http://www.example.com</finalUrls>
                    <templateId>464</templateId>
                    <templateElements>
                        <uniqueName>adData</uniqueName>
                        <fields>
                            <name>layout</name>
                            <type>ENUM</type>
                            <fieldText>gmail_single_promotion_ad_v1</fieldText>
                        </fields>
                        <fields>
                            <name>callToActionUrl1</name>
                            <type>URL</type>
                            <fieldText>http://www.example.com/booktrip</fieldText>
                        </fields>
                        <fields>
                            <name>callToActionButton1ButtonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>callToActionButton1TextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>callToActionButton1</name>
                            <type>TEXT</type>
                            <fieldText>Book trip</fieldText>
                        </fields>
                        <fields>
                            <name>content</name>
                            <type>TEXT</type>
                            <fieldText>Great deals on Venus</fieldText>
                        </fields>
                        <fields>
                            <name>headlineTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f9</fieldText>
                        </fields>
                        <fields>
                            <name>headline</name>
                            <type>TEXT</type>
                            <fieldText>Book now</fieldText>
                        </fields>
                        <fields>
                            <name>image</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>description</name>
                            <type>TEXT</type>
                            <fieldText>Space flights</fieldText>
                        </fields>
                        <fields>
                            <name>subject</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic cruises</fieldText>
                        </fields>
                        <fields>
                            <name>advertiser</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic Cruises, Inc.</fieldText>
                        </fields>
                        <fields>
                            <name>logo</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                    </templateElements>
                    <name>Gmail single promotion ad</name>
                </ad>
                <status>PAUSED</status>
            </operand>
        </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Gmail-Anzeige für mehrere Produkte

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer Gmail-Anzeige für mehrere Produkte:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201802">
        <operations>
            <operator>ADD</operator>
            <operand>
                <adGroupId>XXXXX</adGroupId>
                <ad xmlns:ns2="https://adwords.google.com/api/adwords/cm/v201802" xsi:type="ns2:TemplateAd">
                    <displayUrl>www.example.com</displayUrl>
                    <finalUrls>http://www.example.com</finalUrls>
                    <templateId>466</templateId>
                    <templateElements>
                        <uniqueName>adData</uniqueName>
                        <fields>
                            <name>layout</name>
                            <type>ENUM</type>
                            <fieldText>gmail_multi_product_ad_v1</fieldText>
                        </fields>
                        <fields>
                            <name>content</name>
                            <type>TEXT</type>
                            <fieldText>Choose your destination</fieldText>
                        </fields>
                        <fields>
                            <name>headlineTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f9</fieldText>
                        </fields>
                        <fields>
                            <name>headline</name>
                            <type>TEXT</type>
                            <fieldText>Multiple destinations available</fieldText>
                        </fields>
                        <fields>
                            <name>header</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>product_5_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_5_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_5_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_4_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_4_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_4_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_3_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_3_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_3_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_2_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_2_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_2_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_buttonColor</name>
                            <type>ENUM</type>
                            <fieldText>#4486f8</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_buttonTextColor</name>
                            <type>ENUM</type>
                            <fieldText>#ffffff</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_titleColor</name>
                            <type>ENUM</type>
                            <fieldText>#000000</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_buttonText</name>
                            <type>TEXT</type>
                            <fieldText>Cruise to Venus</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_buttonUrl</name>
                            <type>URL</type>
                            <fieldText>http://www.example.com/venus</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_title</name>
                            <type>TEXT</type>
                            <fieldText>Book Venus trip</fieldText>
                        </fields>
                        <fields>
                            <name>product_1_image</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>product_0_buttonText</name>
                            <type>TEXT</type>
                            <fieldText>Cruise to Mars</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_buttonUrl</name>
                            <type>URL</type>
                            <fieldText>http://www.example.com/mars</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_title</name>
                            <type>TEXT</type>
                            <fieldText>Book Mars trip</fieldText>
                        </fields>
                        <fields>
                            <name>product_0_image</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                        <fields>
                            <name>description</name>
                            <type>TEXT</type>
                            <fieldText>Travel to your favorite planet</fieldText>
                        </fields>
                        <fields>
                            <name>subject</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic cruises</fieldText>
                        </fields>
                        <fields>
                            <name>advertiser</name>
                            <type>TEXT</type>
                            <fieldText>Intergalactic Cruises, Inc.</fieldText>
                        </fields>
                        <fields>
                            <name>logo</name>
                            <type>IMAGE</type>
                            <fieldMedia xsi:type="ns2:Image">
                                <data>INSERT_BASE_64_ENCODED_BYTES_FROM_IMAGE_FILE_HERE</data>
                            </fieldMedia>
                        </fields>
                    </templateElements>
                    <name>Gmail multi-product ad</name>
                </ad>
                <status>PAUSED</status>
            </operand>
        </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

HTML5-Anzeigen

Mit der API können Sie HTML5-Anzeigen erstellen.

Im Beispiel sehen Sie eine SOAP-Anforderung zum Erstellen einer HTML5-Anzeige mit einer ZIP-Datei als Quelle:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <mutate xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <operations>
        <operator>ADD</operator>
        <operand>
          <adGroupId>XXXXX</adGroupId>
            <ad xsi:type="TemplateAd">
            <displayUrl>www.example.com/html5</displayUrl>
            <finalUrls>http://example.com/html5</finalUrls>
            <templateId>419</templateId>
            <templateElements>
              <uniqueName>adData</uniqueName>
              <fields>
                <name>Custom_layout</name>
                <type>MEDIA_BUNDLE</type>
                <fieldMedia xsi:type="MediaBundle">
                  <type>MEDIA_BUNDLE</type>
                  <data>INSERT_BASE_64_ENCODED_BYTES_FROM_ZIP_FILE_HERE</data>
                  <entryPoint>carousel/index.html</entryPoint>
                </fieldMedia>
              </fields>
              <fields>
                <name>layout</name>
                <type>ENUM</type>
                <fieldText>Custom</fieldText>
              </fields>
            </templateElements>
            <dimensions>
              <width>300</width>
              <height>250</height>
            </dimensions>
            <name>Ad for HTML5</name>
          </ad>
          <status>ENABLED</status>
        </operand>
      </operations>
    </mutate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

HTML5-MediaBundles

Sie können HTML5-MediaBundles (z. B. ZIP-Dateien mit HTML5-Inhalten) mithilfe von MediaService hochladen.

Im Beispiel sehen Sie eine Anforderung zum Hochladen von HTML5-Inhalten mit dem MediaService:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <RequestHeader xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <clientCustomerId>...</clientCustomerId>
      <developerToken>...</developerToken>
      <userAgent>...</userAgent>
    </RequestHeader>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <upload xmlns="https://adwords.google.com/api/adwords/cm/v201802">
      <media xsi:type="MediaBundle">
        <type>MEDIA_BUNDLE</type>
        <data>INSERT_BASE_64_ENCODED_BYTES_FROM_ZIP_FILE_HERE</data>
      </media>
    </upload>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Feedback geben zu...