メインコンテンツへスキップ
POST
まずコンバージョン トラッキングを設定してください。 Performance Max は、コンバージョンを使用して広告を表示する場所と入札額を決定します。Ayrshare はコンバージョン トラッキングのないキャンペーンをブロックしませんが、Google Ads アカウントでコンバージョン トラッキングが設定されるまで、Google がキャンペーンの費用を制限する場合があります。Ayrshare が代わりに設定することはありません。アカウントにコンバージョン トラッキングがない場合、作成レスポンスにはその旨を示す warnings エントリが含まれます。
1回のリクエストで Google Ads の Performance Max キャンペーンを作成します。テキストと画像の URL を送信すると、Google がそれらを組み合わせて、検索、YouTube、ディスプレイ、Discover、Gmail、マップ全体に広告を表示します。Ayrshare は予算、キャンペーン、1つのアセットグループ、およびそのすべてのアセットをまとめて作成します。Google がいずれかの部分を拒否した場合は、何も作成されません。 リクエストは共通の広告キャンペーンの形式を使用します。キャンペーンの取得と変更、インサイト、エラーは Google 検索キャンペーンと同じように機能します。このページでは異なる点を説明します。
  • Google 広告はアカウントごとに有効化されます。有効化するには、お問い合わせください。
  • status: "active" を送信しない限り、新しいキャンペーンは paused の状態で開始されます。
  • 予算は1日あたりの金額で、広告アカウントの通貨で指定します。他のキャンペーンと共有されることはありません。
  • 他の通貨での支出は、Open Exchange Rates のその日の為替レートで USD に換算されて請求されます。換算できない通貨のアカウントでは、何も作成される前に code: 101 が返されます。
  • 動画はサポートされていません。Google が画像から動画を作成する場合があります。

ヘッダーパラメータ

string
必須
新しいキャンペーンごとに、UUID などの新しい一意の値を指定します。同じキーでリクエストを繰り返すと、最初のレスポンスが返されます。Ayrshare がキャンペーンを Google に送信する前に作成が失敗した場合(たとえば、画像のサイズが正しくない場合)はキーが解放されるため、リクエストを修正して同じキーで再試行できます。

ボディパラメータ

string
必須
performanceMax。
object
必須
Performance Max で使用できるのは次の戦略のみです。それ以外を指定すると code: 101 が返されます。
  • maximizeConversions: 予算内でコンバージョン数を最大化します。
  • targetCpa(targetCpa を指定): 同様に、指定したコンバージョン単価を目標にします。
  • maximizeConversionValue: 予算内でコンバージョン値を最大化します。
  • targetRoas(targetRoas を指定): 同様に、指定した広告費用対効果を目標にします。たとえば 350% の場合は 3.5 です。
boolean
必須
Google はすべてのキャンペーンでこの申告を必須としています。
string[]
Google の地域 ID。たとえば、米国は 2840 です。省略するとすべての地域がターゲットになります。
object
必須

画像

Ayrshare は、Google に何かを送信する前に、各画像を URL からダウンロードして確認します:
  • GIF、JPG、または PNG で、それぞれ 5120 KB 以内。
  • 上記の最小サイズ以上で、フィールドに対応するアスペクト比(誤差 1% 以内)であること。
  • すべての画像の合計が 45 MB 以内。
  • URL は公開されている必要があります。プライベートアドレスは拒否されます。
確認に失敗した画像には、その画像を示す code: 101 が返されます。例: platformOptions.google.assets.logos[0]: the image is 100x100; use at least 128x128.